Guia de início rápido: implantar seu primeiro aplicativo Spring Batch no Azure Spring Apps

• Uma assinatura do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
• Git.

• Uma assinatura do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
• Git.
• Java Development Kit (JDK), versão 17.
• Azure CLI versão 2.55.0 ou superior. Use os seguintes comandos para instalar a extensão Azure Spring Apps: az extension add --name spring.

3.1. Entre no portal do Azure

Vá para o portal do Azure e insira suas credenciais para entrar no portal. A visualização padrão é o painel de controle do serviço.

3.2. Criar uma instância do Azure Spring Apps

Use as seguintes etapas para criar uma instância de serviço do Azure Spring Apps:

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

2. Selecione Compute>Azure Spring Apps.

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

   Setting	Valor sugerido	Description
   Subscription	O nome da subscrição.	A subscrição do Azure que pretende usar para o seu servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
   Grupo de recursos	myresourcegroup	Um nome de grupo de recursos novo ou um já existente na sua subscrição.
   Name	myasa	Um nome exclusivo que identifica seu serviço Azure Spring Apps. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hífenes. O primeiro caractere do nome do serviço deve ser uma letra e o último caractere deve ser uma letra ou um número.
   Plan	Enterprise	O plano de preços que determina o recurso e o custo associados à sua instância.
   Region	A região mais próxima dos seus utilizadores.	A localização que é mais próxima dos seus utilizadores.
   Zona redundante	Unselected	A opção para criar seu serviço Azure Spring Apps em uma zona de disponibilidade do Azure. Atualmente, esse recurso não é suportado em todas as regiões.
   Plano IP de software	Pay-as-You-Go	O plano de preços que lhe permite pagar à medida que avança com as Aplicações Azure Spring.
   Terms	Selected	A caixa de seleção do contrato associada à oferta do Marketplace. É necessário selecionar essa caixa de seleção.
   Implantar projeto de exemplo	Unselected	A opção de usar a aplicação de exemplo integrada.

4. Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para provisionar a instância do Azure Spring Apps.

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

   

6. Selecione Ir para o recurso para aceder à página de Visão Geral do Azure Spring Apps.

3.3. Habilitar registro de serviço

Vá para a instância do Azure Spring Apps que você criou, expanda 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 log

Para obter informações sobre como consultar os dados em logs, consulte Guia de início rápido: configurar um espaço de trabalho do Log Analytics.

3.1. Fornecer nomes para cada recurso

Crie variáveis para manter os nomes dos recursos usando os comandos a seguir. Certifique-se de substituir os espaços reservados pelos seus próprios 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 seguintes etapas para criar um novo grupo de recursos:

1. Use o seguinte comando para entrar 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 para determinar a ID da assinatura a ser usada:

   az account list --output table
   

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

   az account set --subscription <subscription-ID>
   

5. Use o seguinte comando 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

O Azure Spring Apps é usado para hospedar o aplicativo Web Spring. Use as seguintes etapas para criar uma instância do Azure Spring Apps e um aplicativo dentro dela:

1. Use o seguinte comando para criar uma instância de serviço do Azure Spring Apps e habilitar o registro do 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 do Azure Spring Apps Enterprise foi criada com êxito:

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

Use as seguintes etapas para implantar o aplicativo:

1. Vá para a instância do Azure Spring Apps 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 Nome da Aplicação como football-billboard, selecione Registo de Serviço na coluna Associar e 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 para o seu sistema. Em seguida, execute o comando. Aguarde alguns 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 football-billboard aplicativo. 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.

Use as seguintes etapas para implantar o aplicativo:

1. Use o seguinte comando para navegar até a pasta do projeto de exemplo a partir 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 do Azure Spring Apps e vincular o registro do 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.1. Criar e executar a tarefa

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 do trabalho, como paralelismo, limite de repetição e tempo limite. Adicione variáveis de ambiente e 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 Registro de Serviço. Em seguida, selecione Vinculação de trabalho, selecione Vincular trabalho para selecionar o trabalho relacionado ao futebol e, em seguida, selecione Aplicar para efetuar a vinculação.

   

3. Volte para o painel Trabalhos depois de vincular o trabalho, selecione Implantar Trabalho e 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 para o seu sistema. Em seguida, execute o comando. Aguarde alguns 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 resumo da tarefa football selecionando o nome da tarefa. 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 acionar a execução. Uma mensagem indica que o trabalho está em execução.

   

5.1. Criar e executar a tarefa

Use as seguintes etapas para criar e executar o trabalho:

1. Use o seguinte comando navegue até a pasta de projeto de exemplo da pasta football-billboard onde você parou anteriormente:

   cd ..
   cd football
   

2. Use o seguinte comando para criar um trabalho na instância do Azure Spring Apps e vincular 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 football projeto de exemplo no trabalho. Este comando carrega e compila o código-fonte no Azure e o torna pronto 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 definir a EXECUTION_NAME variável como o nome de execução do trabalho:

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

Utilize os seguintes passos para validar:

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

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

   

3. Abra o endpoint público da aplicação numa janela do navegador para ver a interface de utilizador estilo billboard. Deixe o aplicativo aberto.

   

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

5. Volte para a página do endpoint no navegador e selecione Recarregar para ver a interface modificada, conforme mostrado na captura de tela a seguir:

   

Utilize os seguintes passos 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 log de trabalho que transmite 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 da football-billboard aplicação:

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

3. Abra o endpoint público da aplicação numa janela do navegador para ver a interface de utilizador estilo billboard. 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 endpoint no navegador e selecione Recarregar para ver a interface modificada, conforme mostrado na captura de tela a seguir:

   

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

1. Localize 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 Grupo de recursos , selecione Excluir. Introduza o nome do seu grupo de recursos na caixa de texto para confirmar a eliminação e, em seguida, selecione Eliminar.

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}