Краткое руководство. Развертывание приложений микрослужб в Azure Spring Apps

• Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.
• Git.
• Пакет средств разработки Java (JDK) версии 17.

• Подписка Azure. Если у вас еще нет подписки, создайте бесплатную учетную запись Azure, прежде чем начинать работу.
• Git.
• Пакет средств разработки Java (JDK) версии 17.
• Интерфейс командной строки разработчика Azure версии 1.2.0 или более поздней.

• Подписка Azure. Если у вас еще нет подписки, создайте бесплатную учетную запись Azure, прежде чем начинать работу.
• Если вы развертываете экземпляр плана Azure Spring Apps Enterprise впервые в целевой подписке, см. раздел "Требования" плана Enterprise в Azure Marketplace.
• (Необязательно) Git.
• (Необязательно) Пакет средств разработки Java (JDK) версии 17.

• Подписка Azure. Если у вас еще нет подписки, создайте бесплатную учетную запись Azure, прежде чем начинать работу.
• Если вы развертываете экземпляр плана Azure Spring Apps Enterprise впервые в целевой подписке, см. раздел "Требования" плана Enterprise в Azure Marketplace.
• Git.
• (Необязательно) Пакет средств разработки Java (JDK) версии 17.
• (Необязательно) Node.js версии 16.20 или более поздней.
• Azure CLI версии 2.45.0 или более поздней.

• Подписка Azure. Если у вас еще нет подписки, создайте бесплатную учетную запись Azure, прежде чем начинать работу.
• Если вы развертываете экземпляр плана Azure Spring Apps Enterprise впервые в целевой подписке, см. раздел "Требования" плана Enterprise в Azure Marketplace.
• Git.
• Пакет средств разработки Java (JDK) версии 17.
• Azure CLI версии 2.55.0 или более поздней.

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

1. Клонируйте пример проекта с помощью следующей команды:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

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

   bash ./scripts/run_all_without_infra.sh
   

3. После успешного завершения скрипта перейдите http://localhost:8080 в браузер, чтобы получить доступ к приложению PetClinic.

Чтобы инициализировать приложение Pet Clinic с помощью шаблонов Azure Developer CLI, выполните следующие действия.

1. В окне Bash создайте новую пустую папку и перейдите к ней.

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

   azd init --template Azure-Samples/spring-petclinic-microservices
   

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

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

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

   Initializing a new project (azd init)
   
   Downloading template code to: <your-local-path>
   (✓) Done: Initialized git repository
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

3.1. Войдите на портал Azure

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

3.2. Создание экземпляра Azure Spring Apps

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

1. Выберите "Создать ресурс" в углу портал Azure.

2. На вкладке "Службы Azure" выберите "Вычисления>Azure Spring Apps".

   

3. На странице "Создание Azure Spring Apps" заполните форму на вкладке "Основные сведения".

   

   Используйте следующую таблицу в качестве руководства для завершения формы. Рекомендуемый план — "Стандартный".

   Параметр	Предлагаемое значение	Description
   Подписка	Имя подписки.	Подписка Azure, которую вы хотите использовать для сервера. Если у вас несколько подписок, выберите подписку, для которой вы хотите выставлять счет за ресурс.
   Группа ресурсов	myresourcegroup	Новое имя группы ресурсов или уже имеющееся из подписки.
   Имя	myasa	Уникальное имя, определяющее экземпляр Azure Spring Apps. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.
   План	Стандартные	План ценообразования определяет ресурсы и затраты, связанные с вашим экземпляром.
   Регион	Регион, ближайший к вашим пользователям.	Ближайшее к пользователям расположение.
   Избыточность между зонами	не выбрано	Создает службу Azure Spring Apps в зоне доступности Azure. В настоящее время не поддерживается во всех регионах.

4. Перейдите на вкладку "Параметры диагностики " на странице "Создание Azure Spring Apps" и выберите "Создать новую ", чтобы создать экземпляр рабочих областей Log Analytics. На странице создания рабочей области Log Analytics обновите имя рабочей области Log Analytics, а затем нажмите кнопку "ОК", чтобы подтвердить создание.

   

5. Перейдите на вкладку Application Insights на странице "Создание Azure Spring Apps" , а затем выберите "Создать" , чтобы создать новый экземпляр Application Insights. На странице "Создание нового ресурса Application Insights" обновите имя Application Insights при необходимости, выберите рабочую область для режима ресурсов и нажмите кнопку "ОК", чтобы подтвердить создание.

   

6. Выберите "Рецензирование" и " Создать ", чтобы просмотреть выбранные варианты. Затем выберите "Создать ", чтобы подготовить экземпляр Azure Spring Apps.

7. Щелкните значок уведомлений (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать "Закрепить на панели мониторинга", чтобы создать ярлык на панели мониторинга портал Azure на странице обзора службы.

   

8. Выберите "Перейти к ресурсу", чтобы перейти на страницу обзора Azure Spring Apps.

9. Выберите сервер конфигурации в области навигации.

10. На странице "Сервер конфигурации" для URI введите https://github.com/Azure-Samples/spring-petclinic-microservices-config.git и нажмите кнопку "Проверить".

    

11. После проверки нажмите кнопку "Применить ", чтобы завершить конфигурацию сервера конфигурации конфигурации.

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

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

   azd auth login
   

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

   Logged in to Azure.
   

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

   azd provision
   

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

   • Выберите подписку Azure для использования: используйте стрелки для перемещения, введите для фильтрации и нажмите клавишу ВВОД.
   • Выберите расположение Azure для использования: используйте стрелки для перемещения, введите для фильтрации, а затем нажмите клавишу ВВОД.

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

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Примечание.

   Выполнение этой команды может занять некоторое время. Индикатор хода выполнения отображается при подготовке ресурсов Azure.

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

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

   ./mvnw -P spring-apps com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config
   

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

   • Выберите дочерние модули, чтобы настроить(входные номера, разделенные запятыми, например[1-2,4,6], ВВОД, чтобы выбрать ALL): нажмите клавишу ВВОД , чтобы выбрать все.
   • Вход OAuth2: авторизация входа в Azure на основе протокола OAuth2.
   • Выберите подписку: выберите номер списка подписок созданного экземпляра Azure Spring Apps, который по умолчанию соответствует первой подписке в списке. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
   • Выберите Azure Spring Apps для развертывания: выберите список созданного экземпляра Azure Spring Apps. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
   • Выберите приложения для предоставления общедоступного доступа:(входные номера, разделенные запятыми, например[1-2,4,6], ВВОД, чтобы выбрать NONE): введите 1,5 для admin-server и api-gateway.
   • Подтвердите сохранение всех указанных выше конфигураций (Y/n): нажмите кнопку y. Если нажать клавишу N, конфигурация не сохраняется в POM-файлах.

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

   ./mvnw azure-spring-apps:deploy
   

4. Для запроса входа OAuth2 авторизуйте имя входа в Azure на основе протокола OAuth2.

   Примечание.

   Развертывание в Azure Spring Apps может занять до 25 минут.

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

[INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:admin-server-default-xx-xx-xxx  Status:Running Reason:null       DiscoverStatus:UP
[INFO] Getting public url of app(admin-server)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io

...

[INFO] Getting public url of app(api-gateway)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io

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

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

   azd package
   

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

   SUCCESS: Your application was packaged for Azure in xx minutes xx seconds.
   

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

   azd deploy
   

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

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service admin-server
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io
   
   (✓) Done: Deploying service api-gateway
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io
   
   (✓) Done: Deploying service customers-service
   - No endpoints were found
   
   (✓) Done: Deploying service vets-service
   - No endpoints were found
   
   (✓) Done: Deploying service visits-service
   - No endpoints were found
   
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

Кнопка "Развернуть в Azure" в следующем разделе запускает интерфейс портал Azure, который развертывает исходный код из репозитория Spring PetClinic. Никаких локальных шагов подготовки не требуется.

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

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

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

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

   ./mvnw clean package -DskipTests
   

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

1. Откройте новое окно Bash и выполните следующую команду, чтобы запустить сервер конфигурации:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

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

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

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

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Откройте новое окно Bash и перейдите в каталог проекта spring-petclinic-frontend . Используйте следующие команды, чтобы установить зависимости и запустить интерфейсное приложение:

   npm install
   npm run start
   

5. После успешного завершения скрипта перейдите http://localhost:8080 в браузер, чтобы получить доступ к приложению PetClinic.

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

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

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

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

   ./mvnw clean package -DskipTests
   

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

1. Откройте новое окно Bash и выполните следующую команду, чтобы запустить сервер конфигурации:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

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

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

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

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Откройте новое окно Bash и перейдите в каталог проекта spring-petclinic-frontend . Используйте следующие команды, чтобы установить зависимости и запустить интерфейсное приложение:

   npm install
   npm run start
   

5. После успешного завершения скрипта перейдите http://localhost:8080 в браузер, чтобы получить доступ к приложению PetClinic.

В этом разделе используется кнопка "Развернуть в Azure" для запуска интерфейса развертывания в портал Azure. В этом интерфейсе используется шаблон ARM для создания ресурсов Azure.

3.1. Войдите на портал Azure

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

3.2. Создание ресурсов Azure

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

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

   

2. Заполните форму на вкладке "Основные сведения". Используйте следующую таблицу в качестве руководства для завершения формы:

   Параметр	Предлагаемое значение	Description
   Подписка	Имя подписки.	Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
   Группа ресурсов	myresourcegroup	Новое имя группы ресурсов или уже имеющееся из подписки.
   Регион	Регион, ближайший к вашим пользователям.	Регион используется для создания группы ресурсов.

   

3. Выберите "Рецензирование" и " Создать ", чтобы просмотреть выбранные варианты. Затем выберите "Создать ", чтобы развернуть приложение в Azure Spring Apps.

4. На панели инструментов щелкните значок Уведомления (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать "Закрепить на панели мониторинга", которая создает плитку для этой службы на панели мониторинга портал Azure в качестве ярлыка на странице обзора службы. Выберите "Перейти к ресурсу", чтобы открыть страницу обзора службы.

   

3.1. Войдите на портал Azure

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

3.2. Создание экземпляра Azure Spring Apps

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

1. Выберите "Создать ресурс" в углу портал Azure.

2. Выберите Compute>Azure Spring Apps.

3. Заполните форму на вкладке "Основные сведения". Используйте следующую таблицу в качестве руководства для завершения формы:

   Параметр	Предлагаемое значение	Description
   Подписка	Имя подписки.	Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
   Группа ресурсов	myresourcegroup	Новое имя группы ресурсов или уже имеющееся из подписки.
   Имя	myasa	Уникальное имя, определяющее службу Azure Spring Apps. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.
   Регион	Регион, ближайший к вашим пользователям.	Ближайшее к пользователям расположение.
   Варианты размещения и планы	Функции корпоративного уровня	План ценообразования, определяющий ресурс и затраты, связанные с экземпляром.
   Избыточность между зонами	не выбрано	Параметр создания службы Azure Spring Apps в зоне доступности Azure. Эта функция в настоящее время не поддерживается во всех регионах.
   План IP-адресов программного обеспечения	Оплата по мере использования	План ценообразования, который позволяет платить по мере использования Azure Spring Apps.
   Развертывание примера проекта	не выбрано	Параметр для использования встроенного примера приложения.

4. Перейдите на вкладку "Параметры диагностики " на странице "Создание Azure Spring Apps" и выберите "Создать новую ", чтобы создать экземпляр рабочих областей Log Analytics. На странице создания рабочей области Log Analytics обновите имя рабочей области Log Analytics, а затем нажмите кнопку "ОК", чтобы подтвердить создание.

5. Перейдите на вкладку Application Insights на странице "Создание Azure Spring Apps" , а затем выберите "Создать" , чтобы создать новый экземпляр Application Insights. На странице "Создание нового ресурса Application Insights" обновите имя Application Insights при необходимости, выберите рабочую область для режима ресурсов и нажмите кнопку "ОК", чтобы подтвердить создание.

6. Выберите "Рецензирование" и " Создать ", чтобы просмотреть выбранные варианты. Затем выберите "Создать ", чтобы подготовить экземпляр Azure Spring Apps.

7. Щелкните значок уведомлений (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать "Закрепить на панели мониторинга", чтобы создать ярлык на панели мониторинга портал Azure на странице обзора службы.

   

8. Выберите "Перейти к ресурсу", чтобы перейти на страницу обзора Azure Spring Apps.

3.3. Настройка экземпляра Azure Spring Apps

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

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

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

1. В области навигации выберите "Приложения" и выберите " Создать приложение".

2. На странице "Создание приложения" для имени приложения используйте внешний интерфейс и оставьте все остальные поля со значениями по умолчанию.

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

   • customers-service
   • vets-service
   • visits-service

4. Нажмите кнопку "Создать" , чтобы завершить создание приложения.

   

Настройка реестра служб

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

1. В области навигации выберите "Реестр служб".

2. Выберите привязку приложения, выберите "Привязать приложение", выберите customers-service из списка и нажмите кнопку "Применить".

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

   • vets-service
   • visits-service

   

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

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

1. В области навигации выберите службу конфигурации приложений и выберите "Параметры".

2. Заполните репозиторий следующими сведениями и нажмите кнопку "Проверить".

   • Имя: по умолчанию
   • Шаблоны: application,api-gateway,customers-service,vets-service,visits-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config.git.
   • Метка: master

   

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

4. Выберите привязку приложения, выберите "Привязать приложение", выберите customers-service из списка и нажмите кнопку "Применить".

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

   • vets-service
   • visits-service

   

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

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

1. В области навигации выберите "Приложения" , а затем выберите customers-service приложение.

2. На странице обзора приложения выберите "Конфигурация", выберите шаблоны файлов конфигурации на вкладке "Общие параметры", а затем выберите приложение и customers-service. Нажмите кнопку "Сохранить", чтобы задать шаблоны файлов конфигурации.

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

   • vets-service: выберите приложение и vets-service.
   • visits-service: выберите приложение и visits-service.

Настройка шлюза Spring Cloud

В этом разделе показано, как настроить Шлюз Spring Cloud.

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

1. В области навигации выберите Spring Cloud Gateway.

2. На вкладке "Обзор" выберите "Да ", чтобы назначить конечную точку. Сохраните URL-адрес конечной точки для последующего использования.

Затем настройте маршрутизацию для Spring Cloud Gateway. Так как портал Azure в настоящее время не поддерживает конфигурацию маршрута для Шлюза Spring Cloud, откройте окно Bash и выполните следующие действия Azure CLI для настройки маршрутизации:

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

   az login
   

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

   az extension add --name spring --upgrade
   az provider register --namespace Microsoft.SaaS
   

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

   Примечание.

   Этот шаг необходим, только если подписка никогда не использовалась для создания экземпляра плана Enterprise в Azure Spring Apps.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

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

   export SUBSCRIPTION_ID=<subscription-ID>
   export RESOURCE_GROUP=<resource-group-name>
   export SPRING_APPS_NAME=<Azure-Spring-Apps-instance-name>
   export APP_CUSTOMERS_SERVICE=customers-service
   export APP_VETS_SERVICE=vets-service
   export APP_VISITS_SERVICE=visits-service
   export APP_FRONTEND=frontend
   

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

   az account set --subscription ${SUBSCRIPTION_ID}
   

6. Используйте следующую команду, чтобы задать маршрутизацию для customers-service приложения:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json \
         '[
           {
             "predicates": [
               "Path=/api/customer/**"
             ],
             "filters": [
               "StripPrefix=2"
             ]
           }
         ]'
   

7. Используйте следующую команду, чтобы задать маршрутизацию для vets-service приложения:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/vet/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

8. Используйте следующую команду, чтобы задать маршрутизацию для visits-service приложения:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/visit/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

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

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --app-name ${APP_FRONTEND} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/**"
              ],
              "filters": [
                "StripPrefix=0"
              ],
              "order": 1000
            }
          ]'
   

Настройка средств разработчика

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

1. В области навигации выберите "Средства разработчика".

2. Выберите " Назначить конечную точку", чтобы назначить конечную точку для средств разработчика.

3. Сохраните конечную точку приложения Live View , чтобы использовать ее позже.

3.1. Укажите имена для каждого ресурса

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

export LOCATION=<location>
export RESOURCE_GROUP=myresourcegroup
export SPRING_APPS=myasa
export APP_FRONTEND=frontend
export APP_CUSTOMERS_SERVICE=customers-service
export APP_VETS_SERVICE=vets-service
export APP_VISITS_SERVICE=visits-service
export GIT_CONFIG_REPO=default

3.2. Вход в Azure CLI

Выполните следующие действия, чтобы войти в систему:

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

   az login
   

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

   az account list --output table
   

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

   az account set --subscription <subscription-ID>
   

3.3. Создание группы ресурсов

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

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

   az configure --defaults location=${LOCATION}
   

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

   az group create --resource-group ${RESOURCE_GROUP}
   

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

   az configure --defaults group=${RESOURCE_GROUP}
   

3.4. Установка расширения и регистрация пространства имен

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

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.5. Создание экземпляра Azure Spring Apps

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

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

   Примечание.

   Этот шаг необходим, только если подписка никогда не использовалась для создания экземпляра плана Enterprise в Azure Spring Apps.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

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

   az spring create \
       --name ${SPRING_APPS} \
       --sku Enterprise \
       --enable-application-configuration-service \
       --enable-service-registry \
       --enable-gateway \
       --enable-application-live-view
   

3.6. Настройка экземпляра Azure Spring Apps

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

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

   export SPRING_APPS_RESOURCE_ID=$(az spring show \
       --name ${SPRING_APPS} \
       --query id \
       --output tsv)
   az monitor diagnostic-settings create \
       --resource ${SPRING_APPS_RESOURCE_ID} \
       --name logs-and-metrics \
       --workspace ${SPRING_APPS} \
       --logs '[
         {
           "category": "ApplicationConsole",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         },
         {
            "category": "SystemLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
            }
         },
         {
            "category": "IngressLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
             }
         }
       ]' \
       --metrics '[
         {
           "category": "AllMetrics",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         }
       ]'
   

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

   az spring app create --service ${SPRING_APPS} --name ${APP_FRONTEND}
   az spring app create --service ${SPRING_APPS} --name ${APP_CUSTOMERS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VETS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VISITS_SERVICE}
   

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

   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_CUSTOMERS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VETS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VISITS_SERVICE}
   

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

   az spring application-configuration-service git repo add \
       --service ${SPRING_APPS} \
       --name ${GIT_CONFIG_REPO} \
       --patterns application,api-gateway,customers-service,vets-service,visits-service \
       --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
       --label master
   

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

   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_CUSTOMERS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VETS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VISITS_SERVICE}
   

6. Чтобы назначить конечную точку Шлюзу Spring Cloud, используйте следующую команду:

   az spring gateway update --service ${SPRING_APPS} --assign-endpoint
   

7. Используйте следующую команду, чтобы задать маршрутизацию для customers-service приложения:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/customer/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
      ]'
   

8. Используйте следующую команду, чтобы задать маршрутизацию для vets-service приложения:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/vet/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

9. Используйте следующую команду, чтобы задать маршрутизацию для visits-service приложения:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/visit/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

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

    az spring gateway route-config create \
        --service ${SPRING_APPS} \
        --name ${APP_FRONTEND} \
        --app-name ${APP_FRONTEND} \
        --routes-json '[
          {
            "predicates": [
              "Path=/**"
            ],
            "filters": [
              "StripPrefix=0"
            ],
            "order": 1000
          }
        ]'
    

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

    az spring dev-tool update --service ${SPRING_APPS} --assign-endpoint
    

Кнопка "Развернуть в Azure" в предыдущем разделе запускает портал Azure интерфейс, включающий развертывание приложения, поэтому ничего другого не требуется.

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

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

   ./mvnw -P spring-apps-enterprise com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

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

   • Выберите дочерние модули для настройки: нажмите клавишу ВВОД , чтобы выбрать все.
   • Выберите подписку: выберите номер списка подписок созданного экземпляра Azure Spring Apps, который по умолчанию соответствует первой подписке в списке. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
   • Используйте существующие Azure Spring Apps в Azure: нажмите y , чтобы использовать существующий экземпляр Azure Spring Apps.
   • Выберите приложения для предоставления общедоступного доступа: нажмите клавишу ВВОД , чтобы выбрать нет.
   • Подтвердите сохранение всех указанных выше конфигураций: нажмите клавишу Y. Если нажать клавишу N, конфигурация не сохраняется в POM-файлах.

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

   ./mvnw azure-spring-apps:deploy
   

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

   [INFO] Start deploying artifact(customers-service-3.0.1.jar) to deployment(default) of app(customers-service)...
   [INFO] Artifact(customers-service-3.0.1.jar) is successfully deployed to deployment(default) of app(customers-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(vets-service-3.0.1.jar) to deployment(default) of app(vets-service)...
   [INFO] Artifact(vets-service-3.0.1.jar) is successfully deployed to deployment(default) of app(vets-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(visits-service-3.0.1.jar) to deployment(default) of app(visits-service)...
   [INFO] Artifact(visits-service-3.0.1.jar) is successfully deployed to deployment(default) of app(visits-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

3. Портал Azure не поддерживает развертывание интерфейсных приложений, поэтому для развертывания интерфейсного приложения используйте следующую команду Azure CLI:

   az spring app deploy \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --source-path spring-petclinic-frontend \
       --build-env BP_WEB_SERVER=nginx
   

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

   [5/5] Updating deployment in app "frontend" (this operation can take a while to complete)
   Azure Spring Apps will use rolling upgrade to update your deployment, you have 1 instance, Azure Spring Apps will update the deployment in 1 round.
   The deployment is in round 1, 1 old instance is deleted/deleting and 1 new instance is started/starting
   Your application is successfully deployed.
   

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

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

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_FRONTEND} \
       --build-env BP_WEB_SERVER=nginx \
       --source-path ./spring-petclinic-frontend
   

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

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --source-path \
       --config-file-pattern application,customers-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-customers-service \
           BP_JVM_VERSION=17
   

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

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --source-path \
       --config-file-pattern application,vets-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-vets-service \
           BP_JVM_VERSION=17
   

4. Используйте следующую команду для сборки visits-service и развертывания приложения:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --source-path \
       --config-file-pattern application,visits-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-visits-service \
           BP_JVM_VERSION=17
   

5.1. Доступ к приложениям

После завершения развертывания можно найти URL-адрес шлюза Spring Cloud из выходных данных развертывания, как показано на следующем снимке экрана:

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

5.2. Запрос журналов приложений

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

5.3. Мониторинг приложений

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

URL-адрес динамического представления приложения можно найти в выходных данных развертывания. Откройте URL-адрес динамического представления приложения для мониторинга среды выполнения приложений, как показано на следующем снимке экрана:

5.1. Доступ к приложениям

Используйте конечную точку, назначенную шлюзом Spring Cloud, например https://<your-Azure-Spring-Apps-instance-name>-gateway-xxxxx.svc.azuremicroservices.io. Приложение должно выглядеть следующим образом:

5.2. Запрос журналов приложений

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

5.3. Мониторинг приложений

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

Откройте URL-адрес приложения Live View, предоставляемый средствами разработчика для мониторинга среды выполнения приложений, как показано на следующем снимке экрана:

5.1. Доступ к приложениям

Чтобы получить URL-адрес Шлюза Spring Cloud, используйте следующие команды:

export GATEWAY_URL=$(az spring gateway show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${GATEWAY_URL}"

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

5.2. Запрос журналов приложений

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

5.3. Мониторинг приложений

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

Используйте следующие команды, чтобы получить URL-адрес для Приложения Live View:

export DEV_TOOL_URL=$(az spring dev-tool show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${DEV_TOOL_URL}/app-live-view"

Откройте URL-адрес динамического представления приложения для мониторинга среды выполнения приложений, как показано на следующем снимке экрана:

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

1. Найдите группу ресурсов на портале Azure. В меню навигации выберите группы ресурсов и выберите имя группы ресурсов.

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

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

azd down

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

• Общий объем ресурсов для удаления: <общий> объем ресурсов, вы уверены, что хотите продолжить?: Нажмите клавишу y.

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

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

Чтобы удалить всю группу ресурсов, выполните следующие действия.

1. Найдите группу ресурсов на портале Azure. В меню навигации выберите группы ресурсов и выберите имя группы ресурсов.

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

Чтобы удалить всю группу ресурсов, выполните следующие действия.

1. Найдите группу ресурсов на портале Azure. В меню навигации выберите группы ресурсов и выберите имя группы ресурсов.

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

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

az group delete --name ${RESOURCE_GROUP}