Перенос экземпляра плана Azure Spring Apps Basic или Standard в план Enterprise

Примечание.

Планы "Базовый", "Стандартный" и "Корпоративный" будут устарели начиная с середины марта 2025 г. с 3-летнего периода выхода на пенсию. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.

Стандартный план потребления и выделенного плана будет устарел с 30 сентября 2024 г. с полным завершением работы после шести месяцев. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в статье "Миграция потребления Azure Spring Apps Standard" и выделенного плана в приложения контейнеров Azure.

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

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

В этой статье используются примеры приложений Pet Clinic в качестве примеров миграции.

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

• Подписка Azure. Если у вас еще нет подписки, создайте бесплатную учетную запись Azure, прежде чем начинать работу.
• Azure CLI версии 2.45.0 или более поздней.
• Расширение плана Azure Spring Apps Enterprise. Используйте следующую команду, чтобы удалить предыдущие версии и установить последнее расширение плана Enterprise. Если вы ранее установили spring-cloud расширение, удалите его, чтобы избежать несоответствий конфигурации и версий.

  az extension add --upgrade --name spring
  az extension remove --name spring-cloud
  

• Git.

подготовка экземпляра службы к работе;

В плане Azure Spring Apps Enterprise компоненты VMware Tanzu заменяют компоненты OSS Spring Cloud, чтобы обеспечить дополнительную поддержку функций. Компоненты Tanzu включаются по запросу в соответствии с вашими потребностями. Перед созданием экземпляра службы Azure Spring Apps необходимо включить необходимые компоненты.

Примечание.

Чтобы использовать компоненты Tanzu, их необходимо включить при подготовке экземпляра службы "Приложения Azure Spring". На данный момент не существует возможности включить их после подготовки.

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

Портал Azure

1. Откройте портал Azure.

2. В поле поиска сверху введите Azure Spring Apps.

3. Выберите Azure Spring Apps из результатов и нажмите кнопку "Создать".

4. На странице "Создание Azure Spring Apps" задайте подписку, группу ресурсов и имя экземпляра.

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

   

6. На странице "Выбор плана" выберите строку Enterprise в таблице и нажмите кнопку "Выбрать".

   

7. Вернитесь на страницу "Создание Azure Spring Apps ", выберите "Условия ", чтобы согласиться с юридическими условиями и заявлениями о конфиденциальности плана Enterprise в Azure Marketplace.

8. Нажмите кнопку Далее: параметры VMware Tanzu.

9. На вкладке параметров VMWare Tanzu прокрутите список, чтобы просмотреть компоненты Tanzu. Все компоненты включены по умолчанию.

   

   Примечание.

   Решите, какие компоненты Tanzu вы хотите использовать или включить на этапе подготовки. После подготовки экземпляра Azure Spring Apps вы не сможете их включить или отключить.

10. Перейдите на вкладку Application Insights и выберите "Включить Application Insights". Изучите следующие параметры:

    • Необходимо включить Application Insights .
    • Выберите существующий экземпляр Application Insights или создайте новый.
    • Введите частоту выборки в диапазоне от 0 до 100 или используйте значение по умолчанию 10.

    Вы также можете включить Application Insights после подготовки экземпляра Azure Spring Apps. Дополнительные сведения о ценах Application Insights см. в разделе выставления счетов Application Insights для вычислений и параметров затрат журналов Azure Monitor.

    Примечание.

    За использование Application Insights в паре с Azure Spring Apps взимается плата.

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

Подготовка ресурсов занимает около 5 минут.

Azure CLI

1. Используйте следующую команду, чтобы обновить Azure CLI с расширением Azure Spring Apps:

   az extension add --upgrade --name spring
   

2. Используйте следующие команды, чтобы войти в Azure CLI и выбрать активную подписку:

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

3. Используйте следующую команду, чтобы принять юридические условия и заявления о конфиденциальности для плана Enterprise. Этот шаг требуется только при первом создании экземпляра Azure Spring Apps в плане Enterprise.

   az provider register --namespace Microsoft.SaaS
   az term accept --publisher vmware-inc --product azure-spring-cloud-vmware-tanzu-2 --plan asa-ent-hr-mtr
   

4. Создайте имя для экземпляра службы Azure Spring Apps. Его длина должна быть от 4 до 32 символов. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.

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

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise
   

   Дополнительные сведения о группах ресурсов см. в статье Общие сведения об Azure Resource Manager.

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

Действия по созданию приложения совпадают со стандартным планом.

1. Используйте следующую команду, чтобы задать значения по умолчанию Azure CLI. Обязательно замените заполнители своими значениями.

   az config set defaults.group=<resource-group-name>
   az config set defaults.spring=<Azure-Spring-Apps-service-instance-name>
   

2. Используйте следующие команды, чтобы создать два основных приложения для PetClinic и api-gateway customers-service:

   az spring app create --name api-gateway --instance-count 1 --memory 2Gi --assign-endpoint
   az spring app create --name customers-service --instance-count 1 --memory 2Gi
   

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

Для внешней конфигурации в распределенной системе управляемый сервер конфигурации Spring Cloud (OSS) доступен только в планах "Базовый" и "Стандартный". В плане Enterprise служба конфигурации приложений для Tanzu предоставляет аналогичные функции для приложений. В следующей таблице описаны некоторые различия в использовании между сервером конфигурации OSS и службой конфигурации приложений.

Компонент	Планы поддержки	Включен	Привязка к приложению	Профиль
Сервер конфигурации Spring Cloud	Базовый или стандартный	Всегда включен.	Автоматическая привязка	Настроен в исходном коде приложения.
Служба конфигурации приложений для Tanzu	Функции корпоративного уровня	Включите по запросу.	Привязка вручную	Предоставлено как config-file-pattern в развертывании Azure Spring Apps.

В отличие от режима клиента-сервера на сервере конфигурации OSS служба конфигурации приложений управляет конфигурацией с помощью собственного ConfigMapкода Kubernetes, который заполняется свойствами, определенными в репозиториях Git серверной части. Служба конфигурации приложений не может получить активный профиль, настроенный в исходном коде приложения, чтобы соответствовать правильной конфигурации, поэтому явная конфигурация config-file-pattern должна быть указана на уровне развертывания Azure Spring Apps.

Настройка службы конфигурации приложений для Tanzu

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

Портал Azure

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

   

2. Выберите "Параметры" и заполните форму в репозиториях, чтобы добавить новую запись со следующими сведениями:

   • Имя: default
   • Шаблоны: api-gateway,customers-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
   • Метка: master

   

3. Щелкните Проверить, чтобы проверить доступ к целевому URI.

4. После успешного завершения проверки щелкните Применить, чтобы обновить параметры конфигурации.

Azure CLI

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

az spring application-configuration-service git repo add \
    --name default \
    --patterns api-gateway,customers-service \
    --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
    --label master

Привязка приложений к службе конфигурации приложений для Tanzu

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

Портал Azure

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

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

2. Выберите привязку приложения и выберите "Привязка приложения".

   

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

Azure CLI

Используйте следующие команды, чтобы привязать приложения к службе конфигурации приложений для VMware Tanzu и Реестра служб VMware Tanzu:

az spring application-configuration-service bind --app api-gateway
az spring application-configuration-service bind --app customers-service

Дополнительные сведения см. в статье Использование службы конфигурации приложений для Tanzu.

Использование Реестра служб для Tanzu

Реестр служб является одним из собственных компонентов VMware Tanzu. Он предоставляет для приложений шаблон обнаружения служб, который является одним из основных компонентов любой архитектуры на основе микрослужб. В плане enterprise Реестр служб для Tanzu предоставляет реестр служб и обнаруживает поддержку приложений. Managed Spring Cloud Eureka доступен только в плане "Базовый" и "Стандартный" и недоступен в плане Enterprise.

Компонент	План "Стандартный"	План "Корпоративный"
Реестр служб	OSS eureka Автоматическая привязка (всегда внедрение) Всегда подготовлен	Реестр служб для Tanzu Требуется ручная привязка к приложению Включение по запросу

Привязка приложения к реестру служб Tanzu

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

Портал Azure

1. В экземпляре Azure Spring Apps Enterprise выберите реестр служб.

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

3. Выберите "Привязать приложение".

4. Выберите приложение в раскрывающемся меню и выберите "Применить ", чтобы привязать приложение к реестру служб Tanzu.

   

Azure CLI

Используйте следующие команды, чтобы привязать приложения к службе конфигурации приложений для VMware Tanzu и Реестра служб VMware Tanzu:

az spring service-registry bind --app api-gateway
az spring service-registry bind --app customers-service

Примечание.

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

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

Сборка и развертывание приложений

В плане Enterprise служба сборки Tanzu используется для создания приложений. Она предоставляет больше возможностей, например приложения polyglot, для выполнения развертывания из артефактов, таких как исходный код и ZIP-файлы.

Чтобы использовать Службу сборки Tanzu, необходимо указать ресурс для задачи сборки и построитель. Можно также задать параметр --build-env для указания сред сборки.

Если приложение привязывается к службе конфигурации приложений для Tanzu, необходимо указать дополнительный аргумент —config-file-pattern.

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

Локальное создание приложений

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

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

   git clone -b enterprise https://github.com/azure-samples/spring-petclinic-microservices
   cd spring-petclinic-microservices
   mvn clean package -DskipTests
   

   Компиляция проекта может занять несколько минут. По завершении у вас есть отдельные JAR-файлы для каждой службы в соответствующей папке.

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

   az spring app deploy \
       --name api-gateway \
       --artifact-path spring-petclinic-api-gateway/target/spring-petclinic-api-gateway-2.3.6.jar \
       --config-file-patterns api-gateway
   az spring app deploy \
       --name customers-service \
       --artifact-path spring-petclinic-customers-service/target/spring-petclinic-customers-service-2.3.6.jar \
       --config-file-patterns customers-service
   

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

   az spring app list --output table
   

   Выходные данные этой команды выглядят примерно так:

   Name                  Location    ResourceGroup       Public Url                                                 Production Deployment    Provisioning State    CPU    Memory    Running Instance    Registered Instance    Persistent Storage    Bind Service Registry    Bind Application Configuration Service
   --------------------  ----------  ---------------  ---------------------------------------------------------  -----------------------  --------------------  -----  --------  ------------------  ---------------------  --------------------  -----------------------  ----------------------------------------
   api-gateway           eastus      <resource group>   https://<service_name>-api-gateway.asc-test.net                    default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   customers-service     eastus      <resource group>                                                                      default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   

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

План Azure Spring Apps Enterprise использует привязки buildpack для интеграции Application Insights с типом ApplicationInsights вместо агента in-Process. Дополнительные сведения см. в разделе "Настройка сертификатов интеграции APM и ЦС".

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

План "Стандартный"	План "Корпоративный"
Аналитика приложений New Relic Dynatrace AppDynamics	Аналитика приложений New Relic Dynatrace AppDynamics ElasticAPM

Портал Azure

Для проверки или обновления текущих параметров в Application Insights выполните следующие действия:

1. В экземпляре Azure Spring Apps Enterprise выберите Application Insights.

2. Включите или отключите Application Insights, выбрав "Изменить привязку " или "Отменить привязку".

   

3. Выберите "Изменить привязку". Измените параметры привязки и нажмите кнопку "Сохранить".

   

Azure CLI

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

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

az spring build-service builder buildpack-binding create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Используйте следующую команду для перечисления всех привязок buildpack и поиска привязок Application Insights для типа ApplicationInsights:

az spring build-service builder buildpack-binding list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --builder-name <your-builder-name>

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

az spring build-service builder buildpack-binding set \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

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

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

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

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

Дополнительные сведения см. в статье Использование внутрипроцессного агента Java Application Insights в Приложениях Azure Spring.

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

• Azure Spring Apps
• Использование портала API для VMware Tanzu
• Использование Spring Cloud Gateway