Gerenciar e usar trabalhos no plano Enterprise do 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 dedicado e consumo Standard dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.
Este artigo se aplica a: ❎ Básico/Padrão ✅ Enterprise
Este artigo mostra como gerenciar o ciclo de vida de um trabalho e como executar ele no plano Enterprise do Aplicativos Spring do Azure.
Pré-requisitos
- Uma instância do plano Enterprise dos Aplicativos Spring do Azure já provisionada. Para obter mais informações, confira Início Rápido: criar e implantar aplicativos nos Aplicativos Spring do Azure usando o plano Enterprise.
Criar e implantar um trabalho
Use os comandos a seguir para criar e implantar um trabalho:
az spring job create --name <job-name>
az spring job deploy \
--name <job-name> \
--artifact-path <artifact-path>
Na visualização pública, é possível criar no máximo 10 trabalhos por instância de serviço.
Iniciar e cancelar uma execução de trabalho
Use o comando a seguir para iniciar uma execução de trabalho:
az spring job start --name <job-name>
Quando o comando é executado com êxito ele retorna o nome da execução do trabalho. Com o parâmetro --wait-until-finished true, o comando não retorna até que a execução do trabalho seja concluída.
Use o comando a seguir para consultar o status da execução do trabalho. Substitua o <execution-name> pelo nome retornado do comando inicial.
az spring job execution show \
--job <job-name> \
--name <execution-name>
Use o seguinte comando para cancelar as execuções de trabalho que estão em execução:
az spring job execution cancel \
--job <job-name> \
--name <execution-name>
Consultar histórico de execução de trabalho
Para mostrar o histórico de execução, use o seguinte comando:
az spring job execution list --job <job-name>
Na visualização pública, os 10 últimos registros de execução de trabalho concluídos ou com falha por trabalho são mantidos no histórico.
Consultar os logs de execução do trabalho
Para obter o histórico de execuções de trabalho no portal do Azure, use a seguinte consulta do Log Analytics:
AppPlatformLogsforSpring
| where AppName == '<job-name>' and InstanceName startswith '<execution-name>'
| order by TimeGenerated asc
Para obter mais informações, consulte Início Rápido: configurar um workspace do Log Analytics.
Para obter logs em tempo real, use o seguinte comando na linha de comando:
az spring job logs \
--name <job-name> \
--execution <execution-name>
Se houver várias instâncias para a execução do trabalho, especifique --instance <instance-name> para exibir apenas os logs de uma instância.
Realizar novamente a execução do trabalho
Use o seguinte comando para disparar uma nova execução de trabalho:
az spring job start \
--name <job-name> \
--args <argument-value> \
--envs <key=value>
Integrar com componentes gerenciados
Na versão prévia pública, os trabalhos podem se integrar continuamente ao Servidor de Configuração do Spring Cloud para gerenciamento de configuração eficiente e Registro do Serviço do Tanzu para descoberta de serviço.
Integrar ao Servidor de Configuração do Spring Cloud
Com o Servidor de Configuração do Spring Cloud é possível gerenciar as configurações ou as propriedades exigidas por um trabalho em repositórios Git e carregar isso no trabalho. Depois de definir as configurações do repositório Git para o Servidor de Configuração do Spring Cloud, será necessário associar os trabalhos ao servidor.
Use o seguinte comando para associar o trabalho ao Servidor de Configuração do Spring Cloud durante a criação do trabalho:
az spring job create \
--name <job-name> \
--bind-config-server true
Em trabalhos existentes, use o seguinte comando para fazer a associação deles ao Servidor de Configuração do Spring Cloud:
az spring config-server bind --job <job-name>
Quando não precisar mais do Servidor de Configuração do Spring Cloud para seus trabalhos, é possível fazer a desassociação dele. Essa alteração entra em vigor nas novas execuções de trabalho.
Use o comando a seguir para desassociar um trabalho:
az spring config-server unbind --job <job-name>
Integrar ao Registro do Serviço do Tanzu
É comum que um trabalho chame uma API de um aplicativo de longa execução em colaboração para consultar informações, notificações e assim por diante. Para habilitar o trabalho a descobrir aplicativos em execução no mesmo serviço do Aplicativos Spring do Azure, você pode associar aplicativos e trabalhos a um registro de serviço gerenciado. A seção a seguir descreve como associar um trabalho ao Registro do Serviço do Tanzu.
Use o comando a seguir para associar um trabalho ao Registro do Serviço do Tanzu durante a criação do trabalho:
az spring job create --bind-service-registry true
Em trabalhos existentes, use o seguinte comando para fazer a associação deles ao Registro do Serviço do Tanzu:
az spring service-registry bind --job <job-name>
Ao realizar a execução do trabalho, ele pode acessar pontos de extremidade de aplicativos registrados por meio do registro de serviço.
Se você não precisar mais do registro de serviço para seus trabalhos, é possível fazer a desassociação dele. Essa alteração entra em vigor nas novas execuções de trabalho.
Use o comando a seguir para desassociar o trabalho:
az spring service-registry unbind --job <job-name>