Início Rápido: Criar um trabalho nos Aplicativos de Contêiner do Azure

Neste início rápido, você criará um trabalho de Aplicativos de Contêiner do Azure. Nos Aplicativos de Contêiner, os trabalhos são usados para iniciar tarefas conteinerizadas que são executadas por uma duração finita e, em seguida, são encerradas. Os trabalhos são mais adequados para tarefas como processamento de dados, machine learning, limpeza de recursos ou qualquer cenário que exija processamento sob demanda.

Você pode disparar um trabalho manualmente, agendar sua execução ou disparar sua execução com base em eventos. Este início rápido mostra como criar um trabalho manual ou agendado. Para descobrir como criar um trabalho orientado a eventos, consulte Implantar um trabalho controlado por eventos com aplicativos de contêiner do Azure.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se não tiver uma, poderá criar uma gratuitamente.
• O CLI do Azure.

Para obter informações sobre os recursos que os trabalhos de Aplicativos de Contêiner não dão suporte, confira Restrições de trabalhos.

Preparar o ambiente

1. Para entrar no Azure por meio da CLI do Azure, execute o comando a seguir e siga os prompts para concluir o processo de autenticação.

   az login
   

2. Verifique se você está executando a versão mais recente da CLI do Azure por meio do az upgrade comando.

   az upgrade
   

3. Instale a versão mais recente da extensão CLI de Aplicativos de Contêiner.

   az extension add --name containerapp --upgrade
   

4. Registre os namespaces Microsoft.App, Microsoft.OperationalInsights e Microsoft.Storage caso ainda não estejam registrados na sua assinatura 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 usadas ao longo deste artigo.

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

Criar um ambiente dos Aplicativos de Contêiner

O ambiente de Aplicativos de Contêiner atua como um limite de isolamento em torno de aplicativos de contêiner e trabalhos para que eles possam compartilhar a mesma rede e se comunicar 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 de Aplicativos de Contêiner usando o comando a seguir.

   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 trabalho recentes

Os trabalhos de Aplicativos de Contêiner mantêm um histórico de execuções recentes. Você pode 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 trabalhos aparecem na lista enquanto são executados.

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

Consultar logs de execução do trabalho

As execuções de trabalho gravam logs de saída no provedor de log que você configurar para o ambiente de Aplicativos de Contêiner. Por padrão, os logs são armazenados no Log Analytics.

1. Salve a ID do workspace do Log Analytics para o ambiente dos Aplicativos de Contêiner 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. Salvar o nome da execução de tarefa mais recente em 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 do Log Analytics para o trabalho executado usando o comando a seguir.

   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"
   

   Observação

   Até que a tabela ContainerAppConsoleLogs_CL esteja pronta, o comando não retornará nenhum resultado ou retornará o seguinte erro: "BadArgumentError: a solicitação tinha algumas propriedades inválidas". Em ambos os casos, aguarde alguns minutos e execute o comando novamente.

   A saída a seguir é um exemplo dos logs impressos 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!"
   ]
   

Limpar os recursos

Se você não quiser continuar a usar esse trabalho, execute o comando a seguir para excluir o grupo de recursos e todos os recursos deste início rápido.

az group delete --name "$RESOURCE_GROUP"

Próxima etapa