Início rápido: Implantar seu primeiro aplicativo Spring Batch nos Aplicativos Spring do Azure

Observação

Os planos Básico, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de desativação de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira o anúncio de desativação dos Aplicativos Spring do Azure.

O plano consumo e dedicado Standard será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira Migrar o plano Standard de consumo e dedicado dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.

Este início rápido mostra como implantar um aplicativo efêmero do Spring Batch nos Aplicativos Spring do Azure. O projeto de exemplo é derivado do exemplo do Spring Batch de Trabalho de Futebol. É um trabalho de carregamento de estatísticas. No exemplo original, um teste de unidade dispara o trabalho. No exemplo adaptado, o método main de FootballJobApplication inicia o trabalho.

Esse artigo se aplica a: ❎ Basic/Standard ✅ Enterprise

O diagrama a seguir mostra a arquitetura do sistema:

Este artigo fornece as seguintes opções para implantação em Aplicativos Spring do Azure:

• A opção do portal do Azure é a maneira mais fácil e rápida de criar recursos e implantar aplicativos com um único clique. Essa opção é adequada para os desenvolvedores do Spring que desejam implantar rapidamente aplicativos nos serviços de nuvem do Azure.
• A opção CLI do Azure é uma ferramenta de linha de comando poderosa para gerenciar recursos do Azure. Essa opção é adequada para os desenvolvedores do Spring que estão familiarizados com os serviços de nuvem do Azure.

1. Pré-requisitos

Portal do Azure

• Uma assinatura do Azure. Caso não tenha uma assinatura, crie uma conta gratuita antes de começar.
• Git.
• Se você estiver implantando a instância do plano Enterprise do Aplicativos Spring do Azure pela primeira vez na assinatura de destino, confira a seção Requisitos do plano Enterprise no Azure Marketplace.

CLI do Azure

• Uma assinatura do Azure. Caso não tenha uma assinatura, crie uma conta gratuita antes de começar.
• Git.
• Kit de Desenvolvimento Java (JDK), versão 17.
• CLI do Azure versão 2.55.0 ou superior. Use os seguintes comandos para instalar a extensão dos Aplicativos Spring do Azure: az extension add --name spring.
• Se você estiver implantando a instância do plano Enterprise do Aplicativos Spring do Azure pela primeira vez na assinatura de destino, confira a seção Requisitos do plano Enterprise no Azure Marketplace.

2. Preparar o projeto Spring

Use o seguinte comando para clonar o projeto de exemplo do GitHub:

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

3. Preparar o ambiente de nuvem

O principal recurso necessário para executar esse exemplo é uma instância dos Aplicativos Spring do Azure. Esta seção fornece as etapas para criar esse recurso.

Portal do Azure

3.1. Entre no Portal do Azure

Acesse o portal do Azure e insira suas credenciais para entrar no portal. A exibição padrão é o painel de serviço.

3.2. Criar uma instância do Azure Spring Apps

Use o seguinte comando para criar uma instância de serviço do Aplicativos Spring do Azure:

1. Selecione Criar um recurso no canto do portal do Azure.

2. Selecione Computação>Aplicativos Spring do Azure.

3. Preencha o formulário Básico com as seguintes informações:

   Configuração	Valor sugerido	Descrição
   Assinatura	O nome da sua assinatura.	A assinatura do Azure que você deseja usar para o servidor. Caso você tenha várias assinaturas, escolha a assinatura na qual você deseja receber a cobrança do recurso.
   Grupo de recursos	myresourcegroup	Um novo nome do grupo de recursos ou um existente de sua assinatura.
   Nome	myasa	Um nome exclusivo que identifica o serviço Aplicativos Spring do Azure. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hifens. O primeiro caractere do nome do serviço deve ser uma letra e o último caractere deve ser uma letra ou um número.
   Plano	Empresa	O plano de preços determina os recursos e o custo associados à sua instância.
   Região	A região mais próxima de seus usuários.	A localização mais próxima dos usuários.
   Com Redundância de Zona	Não selecionado	A opção para criar o serviço do Aplicativos Spring do Azure em uma zona de disponibilidade do Azure. Atualmente, não há suporte para esse recurso em todas as regiões.
   Plano IP de software	Pago conforme o uso	O plano de preços que permite pagar conforme o uso do Aplicativos Spring do Azure.
   Terms	Selecionadas	A caixa de seleção do contrato associada à Oferta do Marketplace. Você precisa selecionar essa caixa de seleção.
   Implantar um projeto de exemplo	Não selecionado	A opção para usar o aplicativo de exemplo interno.

4. Selecione Revisar e criar para revisar suas seleções. Em seguida, selecione Criar para provisionar a instância dos Aplicativos Spring do Azure.

5. Na barra de ferramentas, selecione o ícone (sino) Notificações para monitorar o processo de implantação. Após a conclusão da implantação, selecione Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página de Visão geral do serviço.

   

6. Selecione Ir para o recurso para ir para a página Visão geral dos Aplicativos Spring do Azure.

3.3. Habilitar o registro de serviço

Vá para a instância dos Aplicativos Spring do Azure que você criou, expanda os Componentes gerenciados no painel de navegação e selecione Registro de Serviço. Em seguida, na página Visão Geral, selecione Gerenciar para abrir a página Gerenciar, selecione Habilitar Registro de Serviço e selecione Aplicar.

3.4. Configurar um espaço de trabalho de análise de logs

Para obter informações sobre como consultar os dados nos registos, confira Início rápido: Configurar um workspace do Log Analytics.

CLI do Azure

3.1. Fornecer nomes para cada recurso

Crie variáveis para manter os nomes dos recursos usando os comandos a seguir. Substitua os espaços reservados pelos seus valores.

export LOCATION=<location>
export RESOURCE_GROUP=<resource-group-name>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>

3.2. Criar um novo grupo de recursos

Use as etapas a seguir para criar um novo grupo de recursos:

1. Use o seguinte comando para fazer logon na CLI do Azure:

   az login
   

2. Use o seguinte comando para definir o local padrão:

   az configure --defaults location=${LOCATION}
   

3. Use o comando a seguir para listar todas as assinaturas disponíveis e determinar a ID de assinatura a ser usada:

   az account list --output table
   

4. Use o comando a seguir para definir a assinatura padrão:

   az account set --subscription <subscription-ID>
   

5. Use o comando a seguir para criar um grupo de recursos:

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

6. Use o seguinte comando para definir o grupo de recursos recém-criado como o grupo de recursos padrão:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Criar uma instância do Azure Spring Apps

Os Aplicativos Spring do Azure são usados para hospedar o aplicativo Web Spring. Use as seguintes etapas para criar uma instância dos Aplicativos Spring do Azure e um aplicativo dentro dela:

1. Use o seguinte comando para criar uma instância de serviço dos Aplicativos Spring do Azure e habilitar o registro de serviço:

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

2. Use o seguinte comando para verificar se a instância de serviço do plano Enterprise dos Aplicativos Spring do Azure foi criada com sucesso:

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. Implantar o aplicativo football-billboard nos Aplicativos Spring do Azure

Portal do Azure

Use as seguintes etapas para implantar o aplicativo:

1. Vá para a instância dos Aplicativos Spring do Azure que você criou, expanda Configurações no painel de navegação e selecione Aplicativos.

2. No painel Aplicativos, selecione Criar Aplicativo para abrir a página Criar Aplicativo.

3. Defina o Nome do aplicativo como football-billboard, selecione Registro de Serviço na coluna Associar e, em seguida, selecione Criar.

   

4. Depois de criar o aplicativo, selecione Implantar Aplicativo e copie o comando da CLI do Azure para implantar o aplicativo. Em seguida, abra uma janela bash e cole o comando na linha de comando, substituindo o caminho do artefato pelo valor correto do seu sistema. Em seguida, execute o comando. Aguarde vários minutos até que a compilação e a implantação sejam bem-sucedidas. O comando e a saída devem ser semelhantes ao exemplo a seguir:

   $ 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. Após a implantação, volte para o painel Aplicativos e selecione o aplicativo football-billboard. Em seguida, vá para a página de visão geral e selecione Atribuir ponto de extremidade para expor o ponto de extremidade público do aplicativo.

CLI do Azure

Use as seguintes etapas para implantar o aplicativo:

1. Use o seguinte comando para navegar até a pasta do projeto de exemplo da pasta raiz do repositório:

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

2. Use o seguinte comando para criar um aplicativo na instância dos Aplicativos Spring do Azure e associar o registro de serviço:

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

3. Use o seguinte comando para implantar o aplicativo:

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

5. Implantar o exemplo de trabalho nos Aplicativos Spring do Azure

Esta seção fornece as etapas para implantar o exemplo.

Portal do Azure

5.1. Criar e executar o trabalho

Use as seguintes etapas para criar e executar o trabalho:

1. Navegue até o painel Trabalhos e selecione Criar Trabalho. Preencha o nome do trabalho como football. Configure os parâmetros de trabalho, como paralelismo, limite de repetição e tempo limite. Adicione as variáveis de ambiente e as variáveis de ambiente secretas conforme necessário. Após a confirmação, selecione Criar.

   

2. Depois de criar o trabalho, expanda Componentes gerenciados no painel de navegação e selecione o Registro de Serviço. Em seguida, selecione Associação de trabalho, escolha Associar trabalho para selecionar o trabalho de futebol e, em seguida, Aplicar para associar.

   

3. Volte para o painel Trabalhos depois de associar o trabalho, selecione Implantar Trabalho e, em seguida, copie o comando da CLI do Azure para implantar o trabalho. Em seguida, abra uma janela bash e cole o comando na linha de comando, substituindo o caminho do artefato pelo valor correto do seu sistema. Em seguida, execute o comando. Aguarde vários minutos até que a compilação e a implantação sejam bem-sucedidas. O comando e a saída devem ser semelhantes ao exemplo a seguir:

   $ 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. Após a implantação, abra a página de visão geral do trabalho football selecionando o nome do trabalho. Selecione Executar para iniciar a execução da tarefa. Você pode personalizar cada execução do trabalho com parâmetros diferentes, como variáveis de ambiente, ou apenas selecionar Executar para disparar a execução. Uma mensagem indica que o trabalho está em execução.

   

CLI do Azure

5.1. Criar e executar o trabalho

Use as seguintes etapas para criar e executar o trabalho:

1. Use o seguinte comando para navegar até a pasta do projeto de exemplo na pasta football-outdoor onde você parou anteriormente:

   cd ..
   cd football
   

2. Use o seguinte comando para criar um trabalho na instância dos Aplicativos Spring do Azure e associar o registro de serviço:

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

3. Use o comando a seguir para implantar o projeto de exemplo football no trabalho. Esse comando carrega e compila o código-fonte no Azure e o prepara para iniciar.

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

4. Use o seguinte comando para iniciar o trabalho e defina a variável EXECUTION_NAME como o nome da execução do trabalho:

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

6. Verificar o resultado da execução do trabalho e a interface do usuário do outdoor

Agora você pode acessar a execução do trabalho e verificar o resultado.

Portal do Azure

Use as etapas a seguir para validar:

1. No painel Execuções, verifique o resultado da execução do trabalho. Aguarde alguns segundos e atualize para exibir o status voltar para Concluído. Esse valor significa que a execução do trabalho é concluída com sucesso.

2. Selecione Exibir logs para consultar os logs da execução do trabalho.

   

3. Abra o ponto de extremidade público do aplicativo em uma janela do navegador para ver a interface do usuário do outdoor. Deixe o aplicativo aberto.

   

4. Volte para a página de visão geral do trabalho football e selecione Executar para disparar a execução novamente.

5. Volte para a página do ponto de extremidade no navegador e selecione Atualizar para exibir a interface do usuário alterada, conforme mostrado na seguinte captura de tela:

   

CLI do Azure

Use as etapas a seguir para validar:

1. Use o seguinte comando para consultar o resultado da execução usando o nome do trabalho e seu nome de execução:

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

   O streaming de log do trabalho que está transmitindo a execução do trabalho deve ser semelhante ao exemplo a seguir:

   [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. Use o seguinte comando para recuperar o ponto de extremidade do aplicativo football-billboard:

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

3. Abra o ponto de extremidade público do aplicativo em uma janela do navegador para ver a interface do usuário do outdoor. Deixe o aplicativo aberto.

   

4. Use o seguinte comando para iniciar o trabalho novamente:

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

5. Volte para a página do ponto de extremidade no navegador e selecione Atualizar para exibir a interface do usuário alterada, conforme mostrado na seguinte captura de tela:

   

7. Limpar os recursos

Exclua os recursos que você criou neste artigo quando não precisar mais deles. Você pode excluir o grupo de recursos do Azure, que inclui todos os recursos no grupo de recursos.

Portal do Azure

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo a instância de serviço recém-criada:

1. Encontre o grupo de recursos no portal do Azure. No menu de navegação, selecione Grupos de recursos e, em seguida, selecione o nome do seu grupo de recursos.

2. Na página do Grupo de recursos, selecione Excluir. Insira o nome do seu grupo de recursos na caixa de texto para confirmar a exclusão e selecione Excluir.

CLI do Azure

Use o seguinte comando para excluir todo o grupo de recursos, incluindo a instância de serviço recém-criada:

az group delete --name ${RESOURCE_GROUP}

8. Próximas etapas

Para obter mais informações, consulte os seguintes artigos:

• Exemplos de Aplicativos Spring do Azure .
• Azure para desenvolvedores do Spring
• Documentação do Spring Cloud do Azure