Quickstart: Criar um trabalho no Azure Container Apps

Neste guia de início rápido, irá criar um job do Azure Container Apps. Nas Aplicações de Contentores, as tarefas são usadas para iniciar atividades containerizadas que são executadas por um período finito e depois terminam. Os trabalhos são mais indicados para tarefas como processamento de dados, aprendizagem automática, limpeza de recursos ou qualquer cenário que exija processamento a pedido.

Podes ativar uma tarefa manualmente, agendar a sua execução ou desencadeá-la com base em eventos. Este quickstart mostra-lhe como criar um trabalho manual ou agendado. Para saber como criar um trabalho orientado a eventos, consulte Implementar um trabalho orientado a eventos com Azure Container Apps.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Se não tiver uma, pode criar uma gratuitamente.
• CLI do Azure.

Para informações sobre funcionalidades que os jobs das Aplicações Container não suportam, consulte Restrições de Jobs.

Preparar o ambiente

1. Para iniciar sessão no Azure a partir da CLI do Azure, execute o seguinte comando e siga os prompts para completar o processo de autenticação.

   az login
   

2. Certifique-se de que está a executar a versão mais recente da CLI do Azure através do az upgrade comando.

   az upgrade
   

3. Instale a versão mais recente da extensão Container Apps CLI.

   az extension add --name containerapp --upgrade
   

4. Registe os Microsoft.Appnamespaces , Microsoft.OperationalInsights, e Microsoft.Storage se ainda não estiverem registados na tua subscrição do Azure.

   az provider register --namespace Microsoft.App
   az provider register --namespace Microsoft.OperationalInsights
   az provider register --namespace Microsoft.Storage
   

5. Defina as variáveis de ambiente utilizadas ao longo deste artigo.

   RESOURCE_GROUP="jobs-quickstart"
   LOCATION="northcentralus"
   ENVIRONMENT="env-jobs-quickstart"
   JOB_NAME="my-job"
   

Criar um ambiente de aplicativos de contêiner

O ambiente Container Apps atua como uma barreira de isolamento para aplicações container e jobs, permitindo que partilhem a mesma rede e comuniquem entre si.

1. Crie um grupo de recursos usando o comando a seguir.

   az group create \
       --name "$RESOURCE_GROUP" \
       --location "$LOCATION"
   

2. Crie o ambiente Container Apps usando o seguinte comando.

   az containerapp env create \
       --name "$ENVIRONMENT" \
       --resource-group "$RESOURCE_GROUP" \
       --location "$LOCATION"
   

az containerapp job create \
    --name "$JOB_NAME" --resource-group "$RESOURCE_GROUP"  --environment "$ENVIRONMENT" \
    --trigger-type "Schedule" \
    --replica-timeout 1800 \
    --image "mcr.microsoft.com/k8se/quickstart-jobs:latest" \
    --cpu "0.25" --memory "0.5Gi" \
    --cron-expression "*/1 * * * *"

Listar histórico de execuções de tarefas recentes

Os trabalhos das Aplicações de Container mantêm um histórico de execuções recentes. Podes listar as execuções de um trabalho.

az containerapp job execution list \
    --name "$JOB_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --output table \
    --query '[].{Status: properties.status, Name: name, StartTime: properties.startTime}'

Os empregos aparecem na lista à medida que são publicados.

Status     Name            StartTime
---------  --------------  -------------------------
Succeeded  my-job-jvsgub6  2025-11-17T21:21:45+00:00

Consultar registos de execução de trabalhos

O trabalho executa logs de escrita e saída para o fornecedor de registos que configura para o ambiente Container Apps. Por defeito, os registos são armazenados no Log Analytics.

1. Salve o ID do espaço de trabalho do Log Analytics para o ambiente Container Apps em uma variável.

   LOG_ANALYTICS_WORKSPACE_ID=$(az containerapp env show \
       --name "$ENVIRONMENT" \
       --resource-group "$RESOURCE_GROUP" \
       --query "properties.appLogsConfiguration.logAnalyticsConfiguration.customerId" \
       --output tsv)
   

2. Guarde o nome da execução de tarefa mais recente para uma variável.

   JOB_RUN_NAME=$(az containerapp job execution list \
       --name "$JOB_NAME" \
       --resource-group "$RESOURCE_GROUP" \
       --query "[0].name" \
       --output tsv)
   

3. Execute uma consulta de Log Analytics para o trabalho executado usando o seguinte comando.

   az monitor log-analytics query \
       --workspace "$LOG_ANALYTICS_WORKSPACE_ID" \
       --analytics-query "ContainerAppConsoleLogs_CL | where ContainerGroupName_s startswith '$JOB_RUN_NAME' | order by _timestamp_d asc" \
       --query "[].Log_s"
   

   Nota

   Até que a tabela ContainerAppConsoleLogs_CL esteja pronta, o comando não devolve resultados, ou devolve o seguinte erro: "ErrorArgumentoErrado: O pedido tinha algumas propriedades inválidas." Em qualquer dos casos, espera alguns minutos e depois executa o comando novamente.

   A saída seguinte é um exemplo dos registos gerados pela execução do trabalho.

   [
       "2025/11/17 18:38:28 This is a sample application that demonstrates how to use Azure Container Apps jobs",
       "2025/11/17 18:38:28 Starting processing...",
       "2025/11/17 18:38:33 Finished processing. Shutting down!"
   ]
   

Clean up resources (Limpar recursos)

Se não vais continuar a usar este trabalho, executa o comando seguinte para eliminar o grupo de recursos e todos os recursos deste quickstart.

az group delete --name "$RESOURCE_GROUP"

Próximo passo