Создайте параметры между средами для входных данных рабочего процесса в Azure Logic Apps

Область применения: Azure Logic Apps (Потребление + Стандартный)

В Azure Logic Apps допустимо изменять абстрактные значения, которые могут изменяться в рабочих процессах во время разработки, тестирования и в рабочей среде, путем определения параметров. Когда вы используете параметры, а не переменные, специфичные для среды, вы можете лучше сосредоточиться на проектировании рабочих процессов и вставить переменные для конкретной среды позже.

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

Дополнительные сведения о мультитенантных и однотенантных Azure Logic Apps см . в статье "Один клиент" и "Мультитенант" в Azure Logic Apps.

Необходимые компоненты

Параметры для рабочих процессов приложений логики "Потребление" и "Стандартный"

Для рабочих процессов приложений логики "Потребление" и "Стандартный" можно определить параметры с помощью конструктора. После определения параметра можно сослаться на этот параметр из любого рабочего процесса или подключения в том же ресурсе приложения логики.

В рабочих процессах приложения логики мультитенантного потребления после создания и использования параметров в конструкторе вы определяете и задаете переменные среды в шаблонах Azure Resource Manager (шаблон ARM) и файлах параметров шаблона. В этом сценарии необходимо определить и задать параметры при развертывании. Это означает, что даже если необходимо изменить только одну переменную, необходимо повторно развернуть шаблон ARM приложения логики.

В рабочих процессах приложения логики "Стандартный" с одним арендатором можно работать с переменными среды во время выполнения и развертывания, используя параметры и настройки приложения. Настройки приложения содержат глобальные параметры конфигурации для всех рабочих процессов в одном ресурсе приложения логики. Дополнительные сведения см. в подразделах изменение параметров узла и приложения для приложений логики на основе одного клиента.

Внимание

Если у вас есть конфиденциальная информация, например строка подключения, включающих имена пользователей и пароли, обязательно используйте самый безопасный поток проверки подлинности. Например, в рабочих процессах приложения логики "Стандартный" безопасные типы данных, например securestring и secureobjectне поддерживаются. Корпорация Майкрософт рекомендует пройти проверку подлинности доступа к ресурсам Azure с помощью управляемого удостоверения , если это возможно, и назначить роль с минимальными привилегиями.

Если эта возможность недоступна, обязательно защитите строка подключения с помощью других мер, таких как Azure Key Vault, которые можно использовать с параметрами приложения. Потом можно напрямую ссылаться на такие защищенные строки, как строки подключения и ключи. Аналогично шаблонам ARM, где переменные среды определяют в процессе развертывания, настройки приложения можно задать в рамках определения рабочего процесса приложения логики. Затем можно захватывать динамически генерируемые значения инфраструктуры, такие как конечные точки подключения, строки хранения и другие. Дополнительные сведения см. в разделе "Типы приложений" для платформа удостоверений Майкрософт.

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

Например, если вы используете Visual Studio Code в качестве локального средства разработки для запуска рабочих процессов локально, в проекте приложения логики можно определить параметры с помощью файла parameters.json. Затем вы можете использовать ссылки на любые параметры в этом файле параметров из любого рабочего процесса в файле workflow.json своего проекта или из любого объекта подключения в файле connections.json своего проекта. В следующем списке приведено несколько распространенных вариантов использования.

  • Имейте файл параметров тестирования, содержащий все значения, используемые во время тестирования. При развертывании можно заменить файл параметров тестирования на файл параметров рабочей среды.

  • Параметризуйте различные части своего файла connections.json. Затем можно проверить файл connections.json в системе управления версиями и управлять всеми подключениями с помощью файла parameters.json.

  • Параметризуйте сложные объекты, такие как объект JSON authentication. Например, вы можете заменить значение объекта authentication строкой, содержащей одно выражение параметров, например @parameters('api-auth').

  • Проверяйте и редактируйте параметры приложения в файле local.settings.json своего проекта. Затем можно сослаться на эти настройки приложения в параметрах.

Примечание.

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

Определение, использование и изменение параметров

Портал Azure

  1. Откройте рабочий процесс приложения логики на портале Azure. В разделе Рабочие процессы выберите и откройте свой рабочий процесс в конструкторе.

  2. На панели инструментов конструктора щелкните Параметры.

    Снимок экрана, на котором показан портал Azure, конструктор рабочих процессов уровня

  3. На панели Параметры выберите Добавить параметр.

  4. Укажите следующую информацию о создаваемом параметре:

    Свойство Обязательное поле Description
    Полное имя Да Имя параметра, который необходимо создать.
    Тип Да Примеры типа данных для параметра: Массив, Логическое значение, Число с плавающей точкой, Целое число, Объект, Безопасный объект, Безопасная строка и Строка.
    Значение по умолчанию Да Значение по умолчанию для параметра. Необходимо указать стандартное значение параметра, так как логика рабочего процесса, сведения о соединении и значения параметров не существуют в едином месте. Перед загрузкой конструктор должен иметь возможность разрешить значения параметра.

    Важно! Для типов данных Безопасного объекта и Безопасной строки не следует задавать значение по умолчанию, поскольку оно хранится в виде обычного текста.
    Фактическое значение No Фактическое значение параметра.

    В следующем примере показано определение для строкового параметра.

    Снимок экрана, на котором показан портал Azure, конструктор рабочих процессов уровня

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

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

    1. В конструкторе откройте нужный рабочий процесс и разверните триггер или действие.

    2. В свойстве, в котором нужно использовать параметр, щелкните внутри поля редактирования этого свойства.

    3. В открывшемся списке динамического содержимого на панели Параметры выберите ранее созданный параметр, например:

      Снимок экрана, на котором показан конструктор рабочих процессов уровня

  7. Чтобы просмотреть или изменить параметры в рабочем процессе приложения логики, выполните указанные ниже шаги.

    1. Запустите рабочий процесс приложения логики в конструкторе. На панели инструментов конструктора выберите Параметры.

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

    2. Внесите изменения, закройте панель параметров и сохраните рабочий процесс приложения логики.