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

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

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

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

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

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

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

Кнопка "Развернуть в Azure" в следующем разделе запускает портал Azure интерфейс, который скачивает JAR-пакет с страницы выпусков ASA-Samples-Web-Application на сайте GitHub. Никаких локальных шагов подготовки не требуется.

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

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

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Создайте пример проекта с помощью следующих команд:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

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

1. Откройте терминал, создайте новую пустую папку, а затем перейдите к ней.

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

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

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

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

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

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   
   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
   

В этом разделе используется кнопка "Развернуть в 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. Создание экземпляра служебная шина

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

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

2. В поле поиска служба и Marketplace найдите служебную шину.

3. В разделе служебная шина нажмите кнопку "Создать".

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

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

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

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

   

7. Выберите "Перейти к ресурсу", чтобы перейти на страницу пространства имен служебная шина.

8. Выберите политики общего доступа в меню навигации и выберите RootManageSharedAccessKey.

9. На странице "Политика SAS: RootManageSharedAccessKey" скопируйте и сохраните значение основной строки подключения, которое используется для настройки подключений из приложения Spring.

10. Выберите очереди в меню навигации и выберите "Очередь".

11. На странице "Создание очереди" введите нижний регистр для имени и нажмите кнопку "Создать".

12. Создайте другую очередь, повторив предыдущий шаг, используя верхний регистр для имени.

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

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

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

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

3. Заполните форму "Стандартный" и "Стандартный " (предварительная версия) со следующими сведениями:

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

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

   • Рабочая нагрузка потребления
   • Выделенная рабочая нагрузка

   1. Заполните вкладку "Основные сведения" следующими сведениями :

      • Имя среды: myacaenv
      • План: потребление
      • Избыточность зоны: отключена

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

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

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

   

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

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

9. На странице "Создание приложения" введите simple-event-driven-app имя приложения и нажмите кнопку "Использовать пример приложения" для создания приложения.

   

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

11. После создания приложения выберите имя приложения, созданное на предыдущем шаге.

12. Выберите "Конфигурация" в области навигации и настройте следующее свойство на вкладке переменных среды.

    • SERVICE_BUS_CONNECTION_STRING. Введите основной строка подключения служебная шина.

    

13. Нажмите кнопку "Сохранить", чтобы сохранить свойства подключения.

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>-<random-string>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Примечание.

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

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

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

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

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

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

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

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

   ./mvnw azure-spring-apps:deploy
   

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

   • Вход OAuth2: необходимо авторизовать вход в Azure на основе протокола OAuth2.

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

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

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

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

   azd package
   

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

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

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

   azd deploy
   

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

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service simple-event-driven-app
   - 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 интерфейс, который скачивает JAR-пакет с страницы выпусков ASA-Samples-Web-Application на сайте GitHub. Никаких локальных шагов подготовки не требуется.

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

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

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Создайте пример проекта с помощью следующих команд:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

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

1. Откройте терминал, создайте новую пустую папку, а затем перейдите к ней.

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

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

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

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

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

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   
   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
   

В этом разделе используется кнопка "Развернуть в 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. Создание экземпляра служебная шина

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

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

2. В поле поиска служба и Marketplace найдите служебную шину.

3. В разделе служебная шина нажмите кнопку "Создать".

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

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

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

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

   

7. Выберите "Перейти к ресурсу", чтобы перейти на страницу пространства имен служебная шина.

8. Выберите политики общего доступа в меню навигации и выберите RootManageSharedAccessKey.

9. На странице "Политика SAS: RootManageSharedAccessKey" скопируйте и сохраните значение основной строки подключения, которое используется для настройки подключений из приложения Spring.

10. Выберите очереди в меню навигации и выберите "Очередь".

11. На странице "Создание очереди" введите нижний регистр для имени и нажмите кнопку "Создать".

12. Создайте другую очередь, повторив предыдущий шаг, используя верхний регистр для имени.

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

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

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

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

3. Заполните форму Основные данные , указав следующую информацию:

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

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

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

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

   

3.4. Подключение экземпляра приложения к экземпляру служебная шина

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

2. Выберите "Приложения " в меню навигации и нажмите кнопку "Создать приложение".

3. На странице "Создание приложения" введите простое приложение на основе событий для имени приложения и выберите Java 17 для платформы среды выполнения.

   

4. После создания приложения выберите имя приложения, созданное на предыдущем шаге.

5. На странице "Конфигурация" выберите вкладку переменных среды, введите SERVICE_BUS_CONNECTION_STRING для ключа, вставьте служебная шина строка подключения для значения, а затем нажмите кнопку "Сохранить".

   

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

   azd auth login
   

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

   Logged in to Azure.
   

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

   azd env set PLAN standard
   

3. Используйте следующую команду, чтобы упаковать развертываемую копию приложения, подготовить инфраструктуру шаблона в 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.

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

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

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

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

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

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

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

   ./mvnw azure-spring-apps:deploy
   

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

   • Вход OAuth2: необходимо авторизовать вход в Azure на основе протокола OAuth2.

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

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

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

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

   azd package
   

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

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

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

   azd deploy
   

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

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service simple-event-driven-app
   - 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 интерфейс, который скачивает JAR-пакет с страницы выпусков ASA-Samples-Web-Application на сайте GitHub. Никаких локальных шагов подготовки не требуется.

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

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

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Создайте пример проекта с помощью следующих команд:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

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

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

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Создайте пример проекта с помощью следующих команд:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

В этом разделе используется кнопка "Развернуть в 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. Создание экземпляра служебная шина

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

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

2. В поле поиска служба и Marketplace найдите служебную шину.

3. В разделе служебная шина нажмите кнопку "Создать".

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

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

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

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

   

7. Выберите "Перейти к ресурсу", чтобы перейти на страницу пространства имен служебная шина.

8. Выберите очереди в меню навигации и выберите "Очередь".

9. На странице "Создание очереди" введите нижний регистр для имени и нажмите кнопку "Создать".

10. Создайте другую очередь, повторив предыдущий шаг, используя верхний регистр для имени.

3.3. Создание экземпляра 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.

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

   

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

3.4. Подключение экземпляра приложения к экземпляру служебная шина

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

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

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

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

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

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

6. Заполните вкладку "Основные сведения" следующими сведениями :

   • Тип службы: выберите служебная шина.
   • Имя подключения: заполнено автоматически созданным именем, которое можно изменить.
   • Подписка. Выберите нужную подписку.
   • Пространство имен: выберите созданное пространство имен.
   • Тип клиента: Select SpringBoot.

7. Настройте вкладку "Далее: проверка подлинности " со следующими сведениями:

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

8. Выберите Далее: сеть. Используйте параметр по умолчанию Настройка правил брандмауэра для включения доступа к целевой службе.

9. Нажмите кнопку "Далее" и "Создать ", чтобы просмотреть выбранные элементы, а затем нажмите кнопку "Создать ", чтобы создать подключение.

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

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

export RESOURCE_GROUP=<event-driven-app-resource-group-name>
export LOCATION=<desired-region>
export SERVICE_BUS_NAME_SPACE=<event-driven-app-service-bus-namespace>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>
export APP_NAME=<event-driven-app-name>

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

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

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

   az login
   

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

   az configure --defaults location=${LOCATION}
   

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

   az account list --output table
   

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

   az account set --subscription <subscription-ID>
   

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

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

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

   az configure --defaults group=${RESOURCE_GROUP}
   

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

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

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

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

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

az spring create \
    --name ${AZURE_SPRING_APPS_INSTANCE} \
    --sku Enterprise

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

az spring app create \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME}

3.5. Создание экземпляра служебная шина

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

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

   az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
   

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

   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name lower-case
   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name upper-case
   

3.6. Подключение экземпляра приложения к экземпляру служебная шина

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

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

   export SERVICE_BUS_CONNECTION_STRING=$( \
       az servicebus namespace authorization-rule keys list \
           --namespace-name ${SERVICE_BUS_NAME_SPACE} \
           --name RootManageSharedAccessKey \
           --query primaryConnectionString \
           --output tsv)
   

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

   az spring app update \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME} \
       --env SPRING_CLOUD_AZURE_SERVICEBUS_CONNECTIONSTRING=${SERVICE_BUS_CONNECTION_STRING} \
             SPRING_CLOUD_AZURE_KEYVAULT_SECRET_PROPERTYSOURCEENABLED=false
   

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

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

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

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

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

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

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

   ./mvnw azure-spring-apps:deploy
   

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

   • Вход OAuth2: необходимо авторизовать вход в Azure на основе протокола OAuth2.

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

   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

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

az spring app deploy \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME} \
    --artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar

1. Отправьте сообщение в lower-case очередь с помощью обозревателя служебная шина. Дополнительные сведения см. в разделе "Отправка сообщения в очередь или раздел раздела"Использование обозревателя служебная шина для выполнения операций с данными в служебная шина.

2. Убедитесь, что в очередь отправлено upper-case новое сообщение. Дополнительные сведения см. в разделе "Просмотр сообщения" обозревателя служебная шина для выполнения операций с данными в служебная шина.

3. Перейдите на страницу обзора экземпляра Azure Spring Apps и выберите журналы, чтобы проверить журналы приложения.

   

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

1. Отправьте сообщение в lower-case очередь с помощью обозревателя служебная шина. Дополнительные сведения см. в разделе "Отправка сообщения в очередь или раздел раздела"Использование обозревателя служебная шина для выполнения операций с данными в служебная шина.

2. Убедитесь, что в очередь отправлено upper-case новое сообщение. Дополнительные сведения см. в разделе "Просмотр сообщения" обозревателя служебная шина для выполнения операций с данными в служебная шина.

3. Перейдите на страницу обзора экземпляра Azure Spring Apps и выберите журналы, чтобы проверить журналы приложения.

   

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

1. Отправьте сообщение в lower-case очередь с помощью обозревателя служебная шина. Дополнительные сведения см. в разделе "Отправка сообщения в очередь или раздел раздела"Использование обозревателя служебная шина для выполнения операций с данными в служебная шина.

2. Убедитесь, что в очередь отправлено upper-case новое сообщение. Дополнительные сведения см. в разделе "Просмотр сообщения" обозревателя служебная шина для выполнения операций с данными в служебная шина.

3. Перейдите на страницу обзора экземпляра Azure Spring Apps и выберите журналы, чтобы проверить журналы приложения.

   

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

   az spring app logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME}
   

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

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

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

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

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

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

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

az group delete --name ${RESOURCE_GROUP}

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

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

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

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

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

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

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

azd down

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

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

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

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