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

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

• Uma subscrição 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.
• Se você estiver implantando uma instância do plano do Azure Spring Apps Enterprise pela primeira vez na assinatura de destino, consulte a seção Requisitos do plano Enterprise no Azure Marketplace.

3.1. Inicie sessão no portal do Azure

Vá para o portal do Azure e insira suas credenciais para entrar no portal. A vista predefinida é o dashboard de 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:

   Definição	Valor sugerido	Description
   Subscrição	O nome da subscrição.	A subscrição do Azure que quer utilizar para o 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.
   Nome	Miasa	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.
   Planear	Enterprise	O plano de preços que determina o recurso e o custo associados à sua instância.
   Região	A região mais próxima dos seus utilizadores.	A localização que esteja mais próxima dos seus utilizadores.
   Zona redundante	não selecionado	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.
   Termos	Selecionado	A caixa de seleção do contrato associada à oferta do Marketplace. É necessário selecionar essa caixa de seleção.
   Implantar projeto de exemplo	não selecionado	A opção para usar o aplicativo de exemplo interno.

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 conclusão da implantação, você pode selecionar Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página Visão geral do serviço.

   

6. Selecione Ir para o recurso para ir para a página 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 uma área de trabalho do Log Analytics

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 do aplicativo como outdoor de futebol, selecione Registro de Serviço na coluna Vincular 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 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 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 de futebol e, em seguida, selecione Aplicar para vincular.

   

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 visão geral do trabalho selecionando o nome do football 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 acionar a execução. Uma mensagem indica que o trabalho está em execução.

   

5.1. Criar e executar o trabalho

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)
   

Use as seguintes etapas 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 ponto de extremidade público do aplicativo em uma janela do navegador para ver a interface do usuário do painel. 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 ponto de extremidade no navegador e selecione Atualizar para ver a interface do usuário alterada, conforme mostrado na captura de tela a seguir:

   

Use as seguintes etapas 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 do football-billboard aplicativo:

   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 painel. 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 ver a interface do usuário alterada, 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}