Использование переменных среды с параметрами сайта

Переменные среды для параметров сайта позволяют создателям и администраторам гибко управлять значениями конфигурации в разных средах. Они позволяют удобнее управлять жизненным циклом приложений и проще выполнять развертывание. Подробнее: Переменные среды для Power Platform.

Решение для расширенной модели данных

Используйте переменные среды для определения значений параметров сайта в различных средах с расширенной моделью данных. В то время как стандартная модель данных основана на профилях развертывания, расширенная модель позволяет динамически настраивать параметры для конкретных сред с помощью переменных среды.

Ключевые определения

Чтобы понять, как переменные среды могут использоваться с параметрами сайта, ознакомьтесь со следующими ключевыми определениями:

• Переменная среды: переменная, содержащая значения конфигурации, специфичные для среды, на которые может ссылаться приложение или компоненты.

• Параметры сайта: настраиваемые свойства, влияющие на поведение сайта, такие как параметры сайта поставщика удостоверений, прогрессивные веб-приложения и дополнительные параметры в рабочей области безопасности.

• Ссылка на переменную среды: указатель на переменную среды в параметре сайта, который включает динамическое разрешение значений во время выполнения.

Преимущества

Переменные среды для параметров сайта имеют несколько преимуществ, в том числе:

• Оптимизируйте управление ALM, избегая жестко заданных значений в параметрах сайта.
• Упростите развертывание в нескольких средах с помощью конфигураций для конкретных сред.
• Включите динамическое обновление поведения сайта без повторного развертывания решений.

Порядок действий

В этой статье описывается, как переменные среды работают с параметрами сайта. Следующее описание является общим обзором:

1. Создатели определяют переменные среды в приложении Power Pages Management или в конструкторе решений.
2. Параметры сайта ссылаются на эти переменные среды, а не на статические значения.
3. При доступе к сайту система разрешает значение переменной среды, на которую указывает ссылка, и применяет его.

Настройка переменных среды для параметров сайта

Предварительные требования

Чтобы использовать переменные среды с параметрами сайта, необходимо выполнить следующие предварительные условия:

• Сайт должен находиться в среде, в которой включена расширенная модель данных.
• Для работы переменных среды в Power Pages необходимы следующие версии:
  • Сервер Dataverse версии 9.2.25013.x
  • Пакет Power Pages версии 1.0.2501.x
  • Среда выполнения Power Pages версии 9.7.1.x

Использование переменных среды в параметрах сайта

Использование переменных среды в параметрах сайта:

1. Откройте приложение Power Pages Management и перейдите к пункту Параметры сайта.

2. Выберите конкретный параметр сайта, который вы хотите настроить с помощью переменной среды.

3. Выберите в качестве источника Переменная среды.

   

4. Если определение переменной среды уже создано, выберите подстановку Переменная среды. Для выбора появится раскрывающееся меню.

   

5. Если определение переменной среды не существует, выберите Создать определение переменной среды и заполните обязательные поля, такие как Владелец, Имя схемы, Отображаемое имя и Тип. Обратите внимание на значение имени схемы, так как именно его необходимо использовать при связывании переменной среды с параметром сайта.

   

6. После создания определения переменной среды его можно выбрать в элементе управления подстановки Переменная среды. Найдите и выберите имя схемы, чтобы связать его с параметром сайта.

Обновление значений для конкретной среды

Чтобы убедиться, что параметры сайта правильно настроены для каждой среды, выполните следующие действия, чтобы обновить значения для конкретных сред в приложении Power Pages Management или в студии дизайна.

После установки переменной среды выполните следующие дополнительные действия:

1. Перейдите к решению и добавьте существующий сайт, убедившись, что соответствующие переменные среды также включены.
2. Экспортируйте решение, затем импортируйте его в требуемую целевую среду.

В процессе импорта в целевую среду присвойте значение переменной среды. Изменение значения приводит к обновлению соответствующих параметров сайта в целевой среде.

Управление переменными среды

Параметрами сайта можно управлять с помощью переменных среды независимо от того, развертываете ли вы решения вручную или через конвейеры.

Решения

Настройте переменные среды и сайты в разных средах, выполнив следующие действия.

1. Настройте переменные среды в исходной среде:

   1. Откройте портал Power Pages или портал Power Apps.

   2. Перейдите в разделе Решения в исходной среде.

   3. Добавьте в решение новую переменную среды, введя необходимые сведения и сохранив ее.

      

      

   4. Добавьте существующий сайт в решение.

2. Настройте параметры сайта:

   1. Откройте приложение Power Pages Management и перейдите к пункту Параметры сайта.
   2. Выберите параметр сайта, который требуется определить для среды.
   3. Используйте раскрывающееся меню, чтобы выбрать или создать переменную среды. В этом раскрывающемся списке пользователи могут просматривать и выбирать переменные среды, созданные в потоке решений.

• В процессе импорта в целевую среду вам будет предложено присвоить значение переменной среды.
• Любые изменения, внесенные в переменную среды, обновляют соответствующие параметры сайта новым значением в целевой среде.

Конвейеры

Если вы используете конвейеры для развертывания решений, вы указываете значение переменной среды для целевой среды. Если вы обновите его, также обновите соответствующие настройки сайта, чтобы отразить новое значение.

Поверхности, поддерживающие переменные среды для параметров сайта

Переменные среды можно использовать для параметров сайта на следующих поверхностях:

• Приложение Power Pages Management: создание переменных среды и управление ими.
• Студия дизайна: просмотр или редактирование параметров сайта с помощью переменных среды.
• Конструктор решений: включите переменные среды в процесс управления жизненным циклом.
• Развертывание конвейера: управление конфигурациями, относящимися к конкретной среде, и их проверка во время развертывания.

Очистка кэша после обновлений

При внесении изменений в значение переменной среды или значение по умолчанию вручную очистите кэш одним из следующих способов:

1. Выберите Синхронизировать в студии дизайна.

   

2. Очистите кэш с портала:

   1. Войдите на портал как администратор и перейдите на веб-сайт, добавив /_services/about в конец URL-адреса. Например: https://contoso.powerappsportals.com/_services/about.

      

   2. На странице сведений о портале выберите Очистить кэш.

3. Перезапустите портал из центра администрирования Power Platform.

Устранение неполадок

Ниже приведены некоторые причины, по которым вы можете столкнуться с ошибками при использовании переменных среды с параметрами сайта:

• Несоответствие значения переменной среды и ожидаемого типа

  Например, если параметр сайта, например Search/Enabled, ожидает логическое значение (истина/ложь), но переменная среды содержит недопустимое значение (например, abc) или отсутствует, это вызывает проблемы.

• Неподдерживаемый тип источника переменной среды

  Эта проблема возникает, когда переменная среды настроена неподдерживаемым способом, например задана тип источника "хранилище данных".

• Проблемы доступа Key Vault

  Проблема такого типа может возникнуть, если источником переменных среды является Key Vault, но в среде выполнения отсутствуют разрешения или отсутствует секрет.

Рекомендации

При работе с переменными среды для параметров сайта важно следовать рекомендациям, чтобы обеспечить эффективное и действенное управление. Вот некоторые ключевые рекомендации:

• Использование

  Используйте эту функцию только для параметров или секретов, связанных с ALM. Избегайте использования ее для всех параметров сайта, так как это может привести к снижению производительности.

• Задавайте имена переменных согласованным образом

  Используйте согласованные имена для переменных среды, чтобы их было легче идентифицировать.

• Документируйте переменные

  Ведите справочный документ со списком всех переменных среды, их назначений и значений по умолчанию.

• Тщательно тестируйте

  Проверяйте изменения в непроизводственной среде, прежде чем применять их в рабочей среде.

• Используйте описания

  Используйте поле описания, чтобы объяснить назначение переменной.

Настройка переменных среды в качестве секретов

Чтобы настроить переменные среды в качестве секретов и использовать их в Power Pages, выполните следующие действия:

1. Настройте переменную среды в качестве секрета. Подробнее см. в разделе Использование переменных среды для секретов Azure Key Vault.

2. Добавьте разрешения на доступ к секрету с портала.

   1. На портале Azure получите имя вашего приложения в разделе Регистрации приложений, соответствующее вашему веб-сайту Power Pages.
   2. Название приложения совпадает с названием вашего веб-сайта с префиксом "Portals-". Если ваш сайт называется Woodgrove Bank Applications, то названием приложения на портале Azure будет Portals-Woodgrove Bank Applications. Запомните регистрационное имя приложения для последующего использования.
   3. Войдите на портал Azure и перейдите в раздел Key Vaults.

3. Создайте новое хранилище ключей или используйте существующее.

   При создании нового хранилища ключей выберите модель разрешений. Выберите либо управление доступом на основе ролей Azure, либо политику доступа к хранилищу ключей Key Vault. Чтобы просмотреть соответствующие шаги, перейдите на следующую вкладку в зависимости от выбранной модели разрешений:

4. Добавьте свой ключ в качестве секрета в хранилище ключей. Узнайте, как создать секрет в Azure Key Vault, в разделе Задание и получение секрета из Azure Key Vault с помощью портала Azure.

Вопросы и ответы

1. Можно ли использовать переменные среды для любых параметров сайта?
   Да, любой параметр сайта, поддерживающий динамические значения, может использовать переменную среды.

2. Что произойдет, если значение для определенной среды не определено?
   Значение по умолчанию используется в качестве резервного варианта.

3. Можно ли редактировать значения переменных среды непосредственно в рабочей среде?
   Да, но убедитесь, что изменения протестированы и задокументированы, чтобы избежать непредвиденных последствий.

Заключение

Переменная среды для параметров сайта упрощает управление ALM, расширяет возможности настройки и снижает риск ошибок, связанных с ручным управлением. Разработчики и администраторы, использующие эту функцию, гарантируют, что их сайты останутся гибкими и будут соответствовать стратегиям развертывания организации.

Дополнительные сведения

• Настройка параметров сайта для веб-сайтов
• Обзор переменных среды