Развертывание многолотных приложений в плане Azure Spring Apps Enterprise

Эта статья относится к:❌ Basic/Standard ✔️ Enterprise

В этой статье показано, как развертывать приложения polyglot в плане Azure Spring Apps Enterprise и как эти приложения polyglot могут использовать функции службы сборки, предоставляемые пакетами сборок.

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

• Уже подготовленный экземпляр плана Azure Spring Apps Enterprise. Дополнительные сведения см . в кратком руководстве по созданию и развертыванию приложений в Azure Spring Apps с помощью плана Enterprise.
• Azure CLI версии 2.45.0 или более поздней. Чтобы установить расширение Azure Spring Apps, выполните следующую команду: az extension add --name spring

Развертывание приложений polyglot в экземпляре службы

Этот раздел относится к созданию и развертыванию приложений polyglot при включении службы сборки. Если отключить службу сборки, можно развертывать приложения только с помощью пользовательского образа контейнера. Вы можете создать собственный образ или использовать его, созданный экземпляром Azure Spring Apps Enterprise. Дополнительные сведения см. в статье "Развертывание приложения с помощью пользовательского образа контейнера".

Управление построителями

При создании экземпляра Azure Spring Apps Enterprise необходимо выбрать построитель по умолчанию из одного из следующих поддерживаемых пакетов сборок семейства языков:

• Java Azure Buildpack для VMware Tanzu
• Сборка .NET Core для VMware Tanzu
• Go Buildpack для VMware Tanzu
• Сборка веб-серверов для VMware Tanzu
• Node.js Buildpack для VMware Tanzu
• Python Buildpack для VMware Tanzu
• Пакет сборки образов Java native для VMware Tanzu
• PHP Buildpack для VMware Tanzu

Дополнительные сведения см. в разделе "Сборки семейства языков" для VMware Tanzu.

Эти пакеты сборки поддерживают создание исходного кода или артефактов для Java, .NET Core, Go, статических веб-файлов, Node.js и приложений Python. При создании или просмотре построителя также отображаются версии buildpack. И вы можете создать пользовательский построитель, указав пакеты сборки и стек.

Все построители, настроенные в экземпляре службы Azure Spring Apps, перечислены на странице "Служба сборки", как показано на следующем снимке экрана:

Нажмите кнопку Add (Добавить), чтобы создать новую группу. На следующем снимку экрана показаны ресурсы, которые следует использовать для создания пользовательского построителя. Стек ОС включает Bionic Base, Bionic Full, Jammy TinyJammy Baseи Jammy Full. Бионик основан на Ubuntu 18.04 (Bionic Beaver) , и Джеймми основан на Ubuntu 22.04 (Jammy Jellyfish). Дополнительные сведения см. в разделе рекомендаций по стеку ОС.

Рекомендуется Jammy OS Stack создать построитель, так как VMware не Bionic OS Stackрекомендуется.

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

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

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

1. Сохраните конфигурацию в качестве нового построителя.
2. Развертывание приложений с помощью нового построителя. Развертывания связаны с новым построителем.
3. Перенос развертываний в предыдущем построителе в новый построитель.
4. Удалите исходный построитель.

Рекомендации по стеку ОС

В Azure Spring Apps рекомендуется Jammy OS Stack создать построителя, так как Bioinic OS Stack он находится в очереди для отмены VMware. В следующем списке описаны доступные параметры:

• Jammy Tiny: Подходит для создания минимального изображения для наименьшего возможного размера и безопасности. Как и создание собственного образа Java, он может уменьшить окончательный образ контейнера. Интегрированные библиотеки ограничены. Например, вы не можете подключиться к экземпляру приложения для устранения неполадок , так как нет shell библиотеки.

  • Большинство приложений Go.
  • Приложения Java. Некоторые параметры конфигурации Apache Tomcat, такие как настройка bin/setenv.sh, недоступны, так как Tiny не имеет оболочки.

• Jammy Base: подходит для большинства приложений без собственных расширений.

  • Приложения Java и приложения .NET Core.
  • Перейдите к приложениям, которым требуются некоторые библиотеки C.
  • Node.js, приложения Python или веб-серверы без собственных расширений.

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

  • Node.js или приложения Python с собственными расширениями.

Дополнительные сведения см . в документации по Ubuntu Stacks .

Управление реестром контейнеров

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

После включения реестра контейнеров пользователя со службой сборки можно отобразить и настроить реестр с помощью портал Azure или Azure CLI.

az spring container-registry list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> 

az spring container-registry show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name>

az spring container-registry update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name> \
    --server <your-container-registry-login-server> \
    --username <your-container-registry-username> \
    --password <your-container-registry-password>

az spring container-registry delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name> 

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

az spring build-service show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name>

az spring build-service update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --registry-name <your-container-registry-name> 

Создание и развертывание приложений polyglot

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

• Для службы сборки с помощью управляемого реестра контейнеров Azure Spring Apps можно создать приложение на образ, а затем развернуть его в текущем экземпляре службы Azure Spring Apps. Сборка и развертывание выполняются вместе с помощью az spring app deploy команды.

• Для службы сборки с помощью реестра контейнеров, управляемого пользователем, можно создать приложение в образ контейнера, а затем развернуть образ в текущем экземпляре Azure Spring Apps Enterprise и других экземплярах. Команды сборки и развертывания разделены. Вы можете использовать команду сборки для создания или обновления сборки, а затем использовать команду развертывания для развертывания образа контейнера в экземпляре службы.

Дополнительные сведения см. в разделе "Служба сборки по запросу" в разделе Use Tanzu Build Service.

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

az configure --defaults group=<resource-group-name> spring=<service-name>

az spring build-service build list
az spring build-service build show --name <build-name>
az spring build-service build create --name <build-name> --artifact-path <artifact-path>
az spring build-service build update --name <build-name> --artifact-path <artifact-path>
az spring build-service build delete --name <build-name>

В следующих примерах Azure CLI показано создание и развертывание файла артефакта для двух сценариев реестра контейнеров:

• Управляемый реестр контейнеров Azure Spring Apps.
• Реестр контейнеров, управляемый пользователем.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username>

При развертывании приложения с файлом артефакта используйте --artifact-path для указания пути к файлу. КАК JAR-файлы, так и WAR допустимы.

Если Azure CLI обнаруживает пакет WAR как тонкий JAR-файл, используйте --disable-validation для отключения проверки.

В следующем примере папка исходного кода развертывается в активном развертывании с помощью --source-path параметра для указания папки.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

az spring build-service build create \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

Вы также можете настроить среду сборки для создания приложения. Например, в приложении Java можно указать версию JDK с помощью среды сборки BP_JVM_VERSION .

Чтобы указать среды сборки, используйте --build-env, как показано в следующем примере. Доступные переменные среды сборки описаны далее в этой статье.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

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

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Ресурс ЦП и памяти сборки по умолчанию.1 vCPU, 2 Gi Если приложению требуется меньше или больше памяти, используйте --build-memory для указания ресурсов памяти , например, 500Mi, 1Gi2Giи т. д. Если приложению требуется меньшее или большее количество ресурсов ЦП, используйте для --build-cpu указания ресурсов ЦП , например, 500m, 12и т. д. Максимальное ограничение ресурсов ЦП и памяти для сборки .8 vCPU, 16Gi

Ресурсы ЦП и памяти ограничены размером пула агентов службы сборки. Дополнительные сведения см. в разделе пула агентов сборки сборки Use Tanzu Build Service. Сумма квоты ресурсов сборки обработки не может превышать размер пула агентов.

Параллельное число задач сборки зависит от размера пула агентов и каждого ресурса сборки. Например, если ресурс сборки является значением по умолчанию 1 vCPU, 2 Gi , а размер пула агентов равен 6 vCPU, 12 Gi6.

Другие задачи сборки блокируются в течение некоторого времени из-за ограничений квоты ресурсов.

Приложение должно прослушивать порт 8080. Приложения Spring Boot переопределяют SERVER_PORT использование 8080 автоматически.

Поддерживаемые языки для развертываний

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

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

Ограничения на собственные образы Java

Native Image — это технология компиляции кода Java заранее в собственный исполняемый файл. Собственные образы обеспечивают различные преимущества, такие как мгновенное запуск и сокращение потребления памяти. Вы можете упаковыть собственные образы в упрощенный образ контейнера для более быстрого и эффективного развертывания. Из-за оптимизации закрытого мира применяются следующие ограничения :

• Для следующих функций Java требуется настройка во время сборки исполняемого файла:
  • Загрузка динамического класса
  • Отражение
  • Динамический прокси-сервер
  • JNI (собственный интерфейс Java)
  • Сериализация
• Байт-код больше недоступен во время выполнения, поэтому отладка и мониторинг с помощью средств, предназначенных для JVMTI, невозможна.

Следующие функции не поддерживаются в Azure Spring Apps из-за ограничения собственного образа Java. Azure Spring Apps будет поддерживать их, когда образ Java Native Image и сообщество преодолеет ограничение.

Развертывание приложений Java

Пакет buildpack для развертывания приложений Java — tanzu-buildpacks/java-azure.

В следующей таблице перечислены функции, поддерживаемые в Azure Spring Apps:

Развертывание приложений .NET

Пакет buildpack для развертывания приложений .NET — tanzu-buildpacks/dotnet-core.

В следующей таблице перечислены функции, поддерживаемые в Azure Spring Apps:

Развертывание приложений Python

Пакет buildpack для развертывания приложений Python — tanzu-buildpacks/python.

В следующей таблице перечислены функции, поддерживаемые в Azure Spring Apps:

Развертывание приложений Go

Пакет buildpack для развертывания приложений Go — tanzu-buildpacks/go.

В следующей таблице перечислены функции, поддерживаемые в Azure Spring Apps:

Развертывание приложений Node.js

Пакет buildpack для развертывания Node.js приложений — tanzu-buildpacks/nodejs.

В следующей таблице перечислены функции, поддерживаемые в Azure Spring Apps:

Развертывание приложений WebServer

Пакет сборки для развертывания приложений WebServer — tanzu-buildpacks/web-servers.

Дополнительные сведения см. в разделе "Развертывание статических веб-файлов".

Развертывание приложений машинного образа Java (предварительная версия)

Пакет buildpack для развертывания приложений машинного образа Java — tanzu-buildpacks/java-native-image.

Вы можете развернуть собственные приложения образов Spring Boot с помощью пакета сборки tanzu-buildpacks/java-native-image . Spring Native поддерживает компиляцию приложений Spring Boot в собственные исполняемые файлы. Пакет buildpack использует пакет образов Liberica Native Image Kit (NIK) для создания собственных образов приложений Spring Boot, и эти приложения полностью поддерживаются.

При создании собственного образа Java необходимо задать среду BP_NATIVE_IMAGE true сборки и ресурс памяти сборки не должен быть меньше 8Gi. Размер пула агента службы сборки не должен быть меньше 4 vCPU, 8 Gi. Дополнительные сведения см. в разделе пула агентов сборки сборки Use Tanzu Build Service.

Если вы хотите создать собственный образ в образ контейнера меньшего размера, рекомендуется использовать построитель с стеком Jammy Tiny ОС. Дополнительные сведения см. в разделе рекомендаций по стеку ОС.

В следующей таблице перечислены функции, поддерживаемые в Azure Spring Apps:

Существуют некоторые ограничения для собственного образа Java. Дополнительные сведения см. в разделе ограничений образов Java Native Image.

Развертывание приложений PHP

Пакет buildpack для развертывания приложений PHP — tanzu-buildpacks/php.

Пакет сборки Tanzu PHP совместим только с полным стеком ОС. Рекомендуется использовать построитель с стеком Jammy Full ОС. Дополнительные сведения см. в разделе рекомендаций по стеку ОС.

В следующей таблице перечислены функции, поддерживаемые в Azure Spring Apps:

Следующие шаги

• Развертывание статических веб-файлов