Создайте рабочие процессы логического приложения уровня Стандарт для гибридного развертывания на собственной инфраструктуре (предварительная версия)

Область применения: Azure Logic Apps (стандартная версия)

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

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

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

Ограничения

• Гибридное развертывание для приложений логики уровня "Стандартный" доступно и поддерживается только в том же регионе, что и приложения контейнеров Azure в AKS с поддержкой Azure Arc.

• Аутентификация с управляемым удостоверением для управляемых API соединителей на данный момент недоступна в этом предварительном выпуске.

  Кластеры Kubernetes с поддержкой Azure Arc в настоящее время не поддерживают проверку подлинности управляемого удостоверения для управляемых подключений API. Вместо этого необходимо создать собственную регистрацию приложения с помощью идентификатора Microsoft Entra. Дополнительные сведения см. далее в этом руководстве.

• Для некоторых триггеров на основе функций, таких как Azure Blob, Cosmos DB и Event Hubs, требуется подключение к учетной записи хранения Azure, связанной с приложением логики стандартного уровня. Если вы используете какие-либо триггеры на основе функций, в переменных среды стандартного логического приложения в портале Azure или в файле local.settings.json проекта приложения логики в Visual Studio Code добавьте следующий параметр приложения и укажите строку подключения учетной записи хранения.

  "Values": {
    "name": "AzureWebJobsStorage",
    "value": "{storage-account-connection-string}"
  }
  

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

• Учетная запись и подписка Azure. Если у вас нет ее, вы можете зарегистрироваться для получения бесплатной учетной записи Azure.

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

  • Кластер службы Azure Kubernetes, подключенный к Azure Arc
  • База данных SQL для локального хранения журнала выполнения рабочих процессов, входных данных и выходных данных для обработки
  • Общий файловый ресурс блока сообщений сервера (SMB) для локального хранения артефактов, используемых рабочими процессами

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

• Чтобы работать в Visual Studio Code, вам потребуется расширение Azure Logic Apps (standard) для Visual Studio Code с соответствующими предварительными условиями.

  Совет

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

Создайте стандартное приложение логики

Изменение виртуального ЦП и выделения памяти на портале Azure

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

1. На портале Azure откройте ресурс стандартного логического приложения.

2. В меню ресурсов в разделе "Параметры" выберите "Контейнеры".

3. На панели инструментов "Контейнеры" выберите "Изменить и развернуть", чтобы открыть панель "Изменить контейнер".

4. На вкладке "Свойства" в разделе "Выделение ресурсов контейнера" измените следующие значения, чтобы соответствовать вашему сценарию:

   Свойство	значение	Описание
   Ядра ЦП	— значение по умолчанию: 1 - Минимум: 0,25 - Максимум: 2	Определяет, какие ядра виртуальных ЦП следует назначить вашему экземпляру контейнера. Это значение можно увеличить на 0,25 ядра до максимального значения. Общее число всех экземпляров контейнеров для этого приложения логики ограничено 2 ядрами.
   Память	— значение по умолчанию: 2 — минимум: 0,1 - Максимум: 4	Определяет емкость памяти в гибибайтах (Ги), чтобы назначить экземпляру контейнера. Это значение можно увеличить на 0,1 Ги до максимального значения. Общая память для всех контейнерных экземпляров этого логического приложения ограничена 4 гибибайтами.

5. По завершении нажмите кнопку Сохранить.

Изменение масштабирования реплики в портале Azure

Вы можете управлять автоматическим масштабированием для диапазона реплик, развертываемых в ответ на событие триггера. Реплика — это новый экземпляр редакции или версии ресурса приложения логики. Чтобы изменить минимальные и максимальные значения этого диапазона, можно изменить правила масштабирования, чтобы определить типы событий, которые активируют масштабирование. Дополнительные сведения см. в статье Установка правил масштабирования в Контейнерах приложений Azure.

1. На портале Azure откройте ресурс стандартного логического приложения.

2. В меню ресурсов в разделе "Параметры" выберите "Масштаб".

3. На странице "Масштабирование" в разделе "Параметр правила масштабирования" измените следующие значения, чтобы соответствовать вашему сценарию:

   Свойство	значение	Описание
   Минимальные реплики	— значение по умолчанию: 1 — минимум: 0 — максимум: 1000	Определяет минимальное количество реплик, допускаемых для ревизии в любой момент времени. Это значение переопределяет правила масштабирования и должно быть меньше максимального количества реплик.
   Максимальное число реплик	— значение по умолчанию: 30 — минимум: 0 — максимум: 1000	Определяет максимальное количество реплик, разрешенных для ревизии в любой момент времени. Это значение переопределяет правила масштабирования.

4. По завершении нажмите кнопку Сохранить.

Управление входящим трафиком в логическое приложение в портале Azure

Вы можете предоставить приложение логики общедоступному интернету, виртуальной сети и другим приложениям логики в вашей среде, включив входящий трафик. Azure применяет настройки входящего трафика с помощью набора правил, которые управляют маршрутизацией внешнего и внутреннего трафика для вашего приложения логики. При включении входящего трафика вам не нужно создавать Azure Load Balancer, общедоступный IP-адрес или другие ресурсы Azure, чтобы включить входящие HTTP-запросы или TCP-трафик. Для получения дополнительной информации см. раздел «Ingress в контейнерных приложениях».

1. В меню ресурсов в разделе Параметры выберите Вход.

2. На странице Ingress рядом с Ingress установите флажок Включено.

3. На основе вашего сценария настройте остальные параметры.

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

   • Настройка интерфейса доступа для вашего приложения в Контейнерных приложениях Azure
   • Настройка ограничений входящего IP-адреса в приложениях контейнеров Azure

Настройка проверки подлинности для управляемых подключений API

Чтобы проверить подлинность управляемых подключений API в рабочих процессах приложения логики уровня "Стандартный", размещенных в кластерах Kubernetes с поддержкой Azure Arc, необходимо создать собственную регистрацию приложения с помощью идентификатора Microsoft Entra. Затем вы можете добавить значения этой регистрации приложения в качестве переменных среды в ваш стандартный ресурс логического приложения, чтобы использовать их для аутентификации ваших API-соединений.

Создание регистрации приложения с помощью идентификатора Microsoft Entra

Портал Azure

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

2. После завершения создания найдите регистрацию нового приложения на портале.

3. В меню ресурсов выберите "Обзор" и сохраните следующие значения, которые потребуется позже для проверки подлинности подключения:

   • Идентификатор клиента
   • Идентификатор клиента
   • Секрет клиента

4. Для идентификатора объекта выполните следующие действия.

   1. На странице Обзор выберите ссылку Управляемое приложение в локальном каталоге для регистрации приложения, как показано.

      

   2. На открывающейся странице скопируйте и сохраните значение идентификатора объекта:

      

5. Добавьте сохраненные значения в виде переменных среды в ресурс логического приложения Standard.

Azure CLI (Интерфейс командной строки для Azure)

1. Чтобы создать регистрацию приложения, используйте команду az ad sp create.

2. Чтобы просмотреть все свойства, используйте команду az ad sp show.

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

   • Идентификатор клиента
   • Код объекта
   • Идентификатор клиента
   • Секрет клиента

4. Добавьте сохраненные значения в виде переменных среды в ресурс логического приложения Standard.

Добавьте значения регистрации приложений в ваше логическое приложение Standard

1. Перейдите в портал Azure и откройте ваш ресурс логического приложения Standard.

2. В меню ресурсов в разделе "Параметры" выберите "Контейнеры" и перейдите на вкладку "Переменные среды".

   Дополнительные сведения о параметрах приложения и параметрах узла см. в разделе "Изменение параметров приложения" и параметров узла.

3. На панели инструментов выберите "Изменить" и "Развернуть".

4. На панели "Изменить контейнер" выберите переменные среды и нажмите кнопку "Добавить".

5. В следующей таблице добавьте каждую переменную среды с указанным значением:

   Переменная среды	значение
   WORKFLOWAPP_AAD_CLIENTID	< my-client-ID>
   WORKFLOWAPP_AAD_OBJECTID	< my-object-ID>
   WORKFLOWAPP_AAD_TENANTID	< my-tenant-ID>
   WORKFLOWAPP_AAD_CLIENTSECRET	< my-client-secret>

6. По завершении нажмите кнопку Сохранить.

Хранение и ссылка на идентификатор клиента и секрет клиента

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

1. На портале Azure перейдите к своему ресурсу приложения логики.

2. В меню ресурсов в разделе "Параметры" выберите "Секреты".

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

4. На панели "Добавить секрет" укажите следующие сведения для каждого секрета и нажмите кнопку "Добавить".

   Ключ	значение
   WORKFLOWAPP_AAD_CLIENTID	< my-client-ID>
   WORKFLOWAPP_AAD_CLIENTSECRET	< my-client-secret>

Известные проблемы и устранение неполадок

Кластеры Kubernetes с поддержкой Arc

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

Хост функций не запущен

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

1. На портале Azure откройте ресурс приложения логики.

2. В меню ресурсов выберите Обзор.

3. На странице "Обзор" рядом с полем "URL-адрес приложения" выберите URL-адрес ресурса.

   Если приложение работает правильно, откроется окно браузера и отображается следующее сообщение:

   

   В противном случае, если приложение имеет какие-либо сбои, убедитесь, что модули pod AKS работают правильно. В Windows PowerShell выполните следующие команды:

   az aks get-credentials {resource-group-name} --name {aks-cluster-name} --admin
   kubectl get ns
   kubectl get pods -n logicapps-aca-ns
   kubectl describe pod {logic-app-pod-name} -n logicapps-aca-ns 
   

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

   • az aks get-credentials
   • Инструмент командной строки (kubectl)

Кластер не имеет достаточно узлов

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

Warning: FailedScheduling  4m52s (x29 over 46m)  default-scheduler  0/2 nodes are available: 2 Too many pods. preemption: 0/2 nodes are available: 2 No preemption victims found for incoming pod.

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

1. В портале Azure перейдите к вашему экземпляру службы Kubernetes.

2. В меню экземпляра в разделе «Параметры» выберите пулы узлов.

3. На панели инструментов узла нажмите кнопку +Добавить пул узлов.

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

• Создайте пулы узлов для кластера в Azure Kubernetes Service (AKS)
• Управление пулами узлов для кластера в Служба Azure Kubernetes (AKS)
• Обзор автомасштабирования кластера в Служба Azure Kubernetes (AKS)
• Использование автомасштабирования кластера в Служба Azure Kubernetes (AKS)

Драйвер SMB Container Storage Interface (CSI) не установлен

После выполнения предыдущей kubectl describe pod команды, если появится следующее предупреждение, убедитесь, установлен ли драйвер CSI для общей папки SMB правильно:

Warning FailedScheduling 5m16s (x2 over 5m27s)  default-scheduler 0/14 nodes are available: pod has unbound immediate PersistentVolumeClaims. preemption: 0/14 nodes are available: 14 Preemption is not helpful for scheduling.

Normal NotTriggerScaleUp 9m49s (x31 over 14m) cluster-autoscaler pod didn't trigger scale-up: 3 pod has unbound immediate PersistentVolumeClaims

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

kubectl get csidrivers

Если список результатов, который отображается, не включает smb.csi.k8s.io, из командной строки Windows и выполните следующую команду:

helm repo add csi-driver-smb
helm repo update helm install csi-driver-smb csi-driver-smb/csi-driver-smb --namespace kube-system --version v1.15.0

Чтобы проверить состояние pod драйвера SMB CSI, в командной строке Windows выполните следующую команду:

kubectl --namespace=kube-system get pods --selector="app.kubernetes.io/name=csi-driver-smb" --watch

Дополнительные сведения см. о драйверах интерфейса хранилища контейнеров (CSI) в службе Azure Kubernetes (AKS).

Связанный контент

• Установите требования к развертыванию стандартного логического приложения на вашей собственной инфраструктуре.