Gerenciar e usar trabalhos no plano do Azure Spring Apps Enterprise
Nota
Os planos Basic, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.
O plano de consumo padrão e dedicado 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 obter mais informações, consulte Migrar consumo padrão e plano dedicado do Azure Spring Apps para Aplicativos de Contêiner do Azure.
Este artigo aplica-se a: ❎ Basic/Standard ✅ Enterprise
Este artigo mostra como gerenciar o ciclo de vida de um trabalho e executá-lo no plano do Azure Spring Apps Enterprise.
Pré-requisitos
- Uma instância de plano do Azure Spring Apps Enterprise já provisionada. Para obter mais informações, consulte Guia de início rápido: criar e implantar aplicativos no Azure Spring Apps usando o plano Enterprise.
Criar e implantar um trabalho
Use os seguintes comandos para criar e implantar um trabalho:
az spring job create --name <job-name>
az spring job deploy \
--name <job-name> \
--artifact-path <artifact-path>
Para a visualização pública, você pode criar um máximo de 10 trabalhos por instância de serviço.
Iniciar e cancelar a execução de um trabalho
Use o seguinte comando para iniciar uma execução de trabalho:
az spring job start --name <job-name>
Se o comando for executado com êxito, ele retornará o nome da execução do trabalho. Com o --wait-until-finished true parâmetro, o comando não retorna até que a execução do trabalho seja concluída.
Para consultar o status da execução do trabalho, use o seguinte comando. Substitua o <execution-name> pelo nome retornado do comando start.
az spring job execution show \
--job <job-name> \
--name <execution-name>
Para cancelar as execuções de trabalho que estão em execução, use o seguinte comando:
az spring job execution cancel \
--job <job-name> \
--name <execution-name>
Histórico de execução de trabalhos de consulta
Para mostrar o histórico de execução, use o seguinte comando:
az spring job execution list --job <job-name>
Para a visualização pública, os últimos 10 registros de execução de trabalho concluídos ou com falha por trabalho são mantidos no histórico.
Consultar logs de execução de tarefas
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 Guia de início rápido: configurar um espaço de trabalho do Log Analytics.
Para 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 os logs apenas para uma instância.
Executar 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>
Integração com componentes gerenciados
Para a visualização pública, os trabalhos podem se integrar perfeitamente ao Spring Cloud Config Server para gerenciamento eficiente de configuração e ao Tanzu Service Registry para descoberta de serviços.
Integração com o Spring Cloud Config Server
Com o Spring Cloud Config Server, você pode gerenciar as configurações ou propriedades exigidas por um trabalho nos repositórios Git e, em seguida, carregá-los no trabalho. Depois de configurar as configurações de repositório Git para o Spring Cloud Config Server, você precisa vincular os trabalhos ao servidor.
Use o seguinte comando para vincular o trabalho ao Spring Cloud Config Server durante a criação do trabalho:
az spring job create \
--name <job-name> \
--bind-config-server true
Para trabalhos existentes, use o seguinte comando para vinculá-los ao Spring Cloud Config Server:
az spring config-server bind --job <job-name>
Se você não precisar mais do Spring Cloud Config Server para seus trabalhos, poderá desvinculá-los dele. Essa alteração entra em vigor em novas execuções de trabalho.
Use o seguinte comando para desvincular um trabalho:
az spring config-server unbind --job <job-name>
Integração com o registro do Tanzu Service
É 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 para descobrir aplicativos em execução no mesmo serviço Azure Spring Apps, você pode vincular seus aplicativos e trabalhos a um registro de serviço gerenciado. A seção a seguir descreve como vincular um trabalho ao Tanzu Service Registry.
Use o seguinte comando para vincular um trabalho ao Tanzu Service Registry durante a criação do trabalho:
az spring job create --bind-service-registry true
Para trabalhos existentes, use o seguinte comando para vinculá-los ao Tanzu Service Registry:
az spring service-registry bind --job <job-name>
Quando você executa 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, poderá desvinculá-los dele. Essa alteração entra em vigor em novas execuções de trabalho.
Use o seguinte comando para desvincular o trabalho:
az spring service-registry unbind --job <job-name>