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

Примечание.

Первые 50 виртуальных ЦП и 100 ГБ памяти освобождаются каждый месяц. Дополнительные сведения см. в статье "Сокращение цен" — Azure Spring Apps делает больше, затраты меньше! в приложениях в блоге Azure.

Примечание.

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

В этом кратком руководстве показано, как развернуть эфемерное приложение Spring Batch в Azure Spring Apps. Пример проекта является производным от примера задания футбола Spring Batch. Это задание загрузки статистики. В исходном примере модульное тестирование активирует задание. В адаптированном примере main метод FootballJobApplication инициирует задание.

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

На следующей схеме показана архитектура системы:

В этой статье приведены следующие варианты развертывания в Azure Spring Apps:

• Вариант портал Azure — самый простой и самый быстрый способ создания ресурсов и развертывания приложений с помощью одного щелчка мыши. Этот вариант подходит для разработчиков Spring, которые хотят быстро развернуть приложения в облачных службах Azure.
• Параметр Azure CLI использует мощное средство командной строки для управления ресурсами Azure. Этот вариант подходит для разработчиков Spring, знакомых с облачными службами Azure.

1. Предварительные требования

Портал Azure

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

Azure CLI

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

2. Подготовка проекта Spring

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

git clone https://github.com/Azure-Samples/azure-spring-apps-samples.git

3. Подготовка облачной среды

Основной ресурс, необходимый для запуска этого примера, — это экземпляр Azure Spring Apps. В этом разделе приведены действия по созданию этого ресурса.

Портал Azure

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

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

3.2. Создание экземпляра 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. Эта функция в настоящее время не поддерживается во всех регионах.
   План IP-адресов программного обеспечения	Оплата по мере использования	План ценообразования, который позволяет платить по мере использования Azure Spring Apps.
   Terms	Выбрано	Соглашение проверка box, связанное с предложением Marketplace. Вам потребуется выбрать этот проверка box.
   Развертывание примера проекта	не выбрано	Параметр для использования встроенного примера приложения.

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

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

   

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

3.3. Включение реестра служб

Перейдите к созданному экземпляру Azure Spring Apps, разверните управляемые компоненты в области навигации и выберите "Реестр служб". Затем на странице "Обзор" выберите "Управление", чтобы открыть страницу "Управление", выберите "Включить реестр служб" и нажмите кнопку "Применить".

3.4. Настройка рабочей области анализа журналов

Сведения о запросе данных в журналах см . в кратком руководстве по настройке рабочей области Log Analytics.

Azure CLI

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

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

export LOCATION=<location>
export RESOURCE_GROUP=<resource-group-name>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-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 Spring Apps используется для размещения веб-приложения Spring. Выполните следующие действия, чтобы создать экземпляр Azure Spring Apps и приложение внутри него:

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

   az spring create \
       --name ${AZURE_SPRING_APPS_INSTANCE} \
       --sku enterprise \
       --enable-sr
   

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

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. Развертывание футбольного рекламного приложения в Azure Spring Apps

Портал Azure

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

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

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

3. Задайте имя приложения на футбольный рекламный щит, выберите "Реестр служб" в столбце "Привязка" и нажмите кнопку "Создать".

   

4. После создания приложения выберите "Развернуть приложение " и скопируйте команду Azure CLI для развертывания приложения. Затем откройте окно Bash и вставьте команду в командную строку, заменив путь артефакта правильным значением для системы. Затем выполните команду. Подождите несколько минут до успешной сборки и развертывания. Команда и выходные данные должны выглядеть примерно так:

   $ az spring app deploy -s job-demo -g job-demo -n football-billboard --artifact-path target/spring-batch-football-billboard-0.0.1-SNAPSHOT.jar
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football-billboard'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

5. После развертывания вернитесь в область "Приложения" и выберите football-billboard приложение. Затем перейдите на страницу обзора и выберите " Назначить конечную точку", чтобы предоставить общедоступную конечную точку для приложения.

Azure CLI

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

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

   cd azure-spring-apps-samples/job-samples/football-billboard
   

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

   az spring app create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --assign-endpoint true \
       --bind-sr
   

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

   az spring app deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

5. Развертывание примера задания в Azure Spring Apps

В этом разделе приведены шаги по развертыванию примера.

Портал Azure

5.1. Создание и выполнение задания

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

1. Перейдите в область "Задания" , а затем выберите "Создать задание". Введите имя задания как football. Настройте параметры задания, такие как параллелизм, ограничение повтора и время ожидания. Добавьте переменные среды и переменные секретной среды по мере необходимости. После подтверждения нажмите кнопку "Создать".

   

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

   

3. Вернитесь к области заданий после привязки задания, выберите " Развернуть задание", а затем скопируйте команду Azure CLI для развертывания задания. Затем откройте окно Bash и вставьте команду в командную строку, заменив путь артефакта правильным значением для системы. Затем выполните команду. Подождите несколько минут до успешной сборки и развертывания. Команда и выходные данные должны выглядеть примерно так:

   $ az spring job deploy -s job-demo -g job-demo -n football --artifact-path target/spring-batch-football-0.0.1-SNAPSHOT-jar-with-dependencies.jar --build-env BP_JVM_VERSION=17
   This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

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

   

Azure CLI

5.1. Создание и выполнение задания

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

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

   cd ..
   cd football
   

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

   az spring job create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --bind-sr
   

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

   az spring job deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

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

   export EXECUTION_NAME=$(az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --query name \
       --output tsv)
   

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

Теперь можно получить доступ к выполнению задания и проверка его результата.

Портал Azure

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

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

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

   

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

   

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

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

   

Azure CLI

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

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

   az spring job logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --execution ${EXECUTION_NAME} \
       --all-instances
   

   Потоковая передача журнала заданий должна выглядеть примерно так:

   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - No TaskExecutor has been set, defaulting to synchronous executor.
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is {} player summary before job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] launched with the following parameters: [{}]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [playerLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [playerLoad] executed in 200ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [gameLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [gameLoad] executed in 290ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [summarizationStep]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [summarizationStep] executed in 7ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] completed with the following parameters: [{}] and the following status: [COMPLETED] in 519ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is 1 player summary after job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseFactory - Shutting down embedded database: url='jdbc:hsqldb:mem:testdb'
   ...
   

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

   az spring app show \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --query properties.url
   

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

   

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

   az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football
   

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

   

7. Очистка ресурсов

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

Портал Azure

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

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

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

Azure CLI

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

az group delete --name ${RESOURCE_GROUP}

8. Дальнейшие действия

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

• Примеры Azure Spring Apps.
• Разработчики Azure для Spring
• Документация по Spring Cloud Azure