Trabalhos em Aplicativos de Contêiner do Azure

Para criar um trabalho manual usando a CLI do Azure, use o az containerapp job create comando. O exemplo a seguir cria um trabalho manual nomeado my-job em um grupo de recursos chamado my-resource-group e um ambiente Container Apps chamado my-environment:

az containerapp job create \
    --name "my-job" --resource-group "my-resource-group"  --environment "my-environment" \
    --trigger-type "Manual" \
    --replica-timeout 1800 \
    --replica-retry-limit 0 \
    --replica-completion-count 1 \ 
    --parallelism 1 \ 
    --image "mcr.microsoft.com/k8se/quickstart-jobs:latest" \
    --cpu "0.25" --memory "0.5Gi"

O seguinte exemplo parcial de um modelo do Azure Resource Manager cria um trabalho manual nomeado my-job num grupo de recursos nomeado my-resource-group e num ambiente Container Apps nomeado my-environment:

{
    "location": "North Central US",
    "name": "my-job",
    "properties": {
        "configuration": {
            "manualTriggerConfig": {
                "parallelism": 1,
                "replicaCompletionCount": 1
            },
            "replicaRetryLimit": 0,
            "replicaTimeout": 1800,
            "triggerType": "Manual"
        },
        "environmentId": "/subscriptions/<subscription_id>/resourceGroups/my-resource-group/providers/Microsoft.App/managedEnvironments/my-environment",
        "template": {
            "containers": [
                {
                    "image": "mcr.microsoft.com/k8se/quickstart-jobs:latest",
                    "name": "main",
                    "resources": {
                        "cpu": 0.25,
                        "memory": "0.5Gi"
                    }
                }
            ]
        }
    }
}

Para criar um trabalho manual usando o portal Azure, procure por Jobs de Aplicações de Container no portal Azure e selecione Criar. Especifique Manual como o tipo de gatilho.

Para usar uma imagem de contentor de exemplo, introduza os seguintes valores no separador Contentor :

Para criar um trabalho agendado usando a CLI do Azure, use o az containerapp job create comando. O exemplo a seguir cria um trabalho agendado nomeado my-job em um grupo de recursos chamado my-resource-group e um ambiente Container Apps chamado my-environment:

az containerapp job create \
    --name "my-job" --resource-group "my-resource-group"  --environment "my-environment" \
    --trigger-type "Schedule" \
    --replica-timeout 1800 \
    --replica-retry-limit 0 \ 
    --parallelism 1 \
    --replica-completion-count 1 \
    --image "mcr.microsoft.com/k8se/quickstart-jobs:latest" \
    --cpu "0.25" --memory "0.5Gi" \
    --cron-expression "*/1 * * * *"

O seguinte exemplo parcial de um modelo do Azure Resource Manager cria um trabalho manual nomeado my-job num grupo de recursos nomeado my-resource-group e num ambiente Container Apps nomeado my-environment:

{
    "location": "North Central US",
    "name": "my-job",
    "properties": {
        "configuration": {
            "scheduleTriggerConfig": {
                "cronExpression": "*/1 * * * *",
                "parallelism": 1,
                "replicaCompletionCount": 1
            },
            "replicaRetryLimit": 0,
            "replicaTimeout": 1800,
            "triggerType": "Schedule"
        },
        "environmentId": "/subscriptions/<subscription_id>/resourceGroups/my-resource-group/providers/Microsoft.App/managedEnvironments/my-environment",
        "template": {
            "containers": [
                {
                    "image": "mcr.microsoft.com/k8se/quickstart-jobs:latest",
                    "name": "main",
                    "resources": {
                        "cpu": 0.25,
                        "memory": "0.5Gi"
                    }
                }
            ]
        }
    }
}

Para criar uma tarefa agendada usando o portal Azure, procure por Jobs de Aplicações Container no portal Azure e selecione Criar. Especifique Schedule como o tipo de gatilho e defina o schedule com uma expressão cron, como */1 * * * * executar a cada minuto.

Para usar uma imagem de contentor de exemplo, introduza os seguintes valores no separador Contentor :

Para criar um trabalho orientado a eventos usando a CLI do Azure, use o az containerapp job create comando. O exemplo a seguir cria um trabalho controlado por eventos nomeado my-job em um grupo de recursos chamado my-resource-group e um ambiente Container Apps chamado my-environment:

az containerapp job create \
    --name "my-job" --resource-group "my-resource-group"  --environment "my-environment" \
    --trigger-type "Event" \
    --replica-timeout 1800 \
    --image "docker.io/myuser/my-event-driven-job:latest" \
    --cpu "0.25" --memory "0.5Gi" \
    --min-executions "0" \
    --max-executions "10" \
    --scale-rule-name "queue" \
    --scale-rule-type "azure-queue" \
    --scale-rule-metadata "accountName=mystorage" "queueName=myqueue" "queueLength=1" \
    --scale-rule-auth "connection=connection-string-secret" \
    --secrets "connection-string-secret=<QUEUE_CONNECTION_STRING>"

O exemplo configura uma regra de escala de fila do Armazenamento do Azure.

O seguinte exemplo parcial de um modelo Azure Resource Manager cria um trabalho orientado a eventos nomeado my-job num grupo de recursos chamado my-resource-group e um ambiente Container Apps nomeado my-environment:

{
    "location": "North Central US",
    "name": "my-job",
    "properties": {
        "configuration": {
            "eventTriggerConfig": {
                "scale": {
                    "maxExecutions": 10,
                    "minExecutions": 0,
                    "pollingInterval": 15,
                    "rules": [
                        {
                            "auth": [
                                {
                                    "triggerParameter": "connection",
                                    "secretRef": "connection-string-secret"
                                }
                            ],
                            "metadata": {
                                "accountName": "mystorage",
                                "queueLength": 1,
                                "queueName": "myqueue"
                            },
                            "name": "queue",
                            "type": "azure-queue"
                        }
                    ]
                }
            },
            "replicaRetryLimit": 0,
            "replicaTimeout": 1800,
            "triggerType": "Event",
            "secrets": [
                {
                    "name": "connection-string-secret",
                    "value": "<QUEUE_CONNECTION_STRING>"
                }
            ]
        },
        "environmentId": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/my-resource-group/providers/Microsoft.App/managedEnvironments/my-environment",
        "template": {
            "containers": [
                {
                    "image": "docker.io/myuser/my-event-driven-job:latest",
                    "name": "main",
                    "resources": {
                        "cpu": 0.25,
                        "memory": "0.5Gi"
                    }
                }
            ]
        }
    }
}

O exemplo configura uma regra de escala de fila do Armazenamento do Azure.

Para criar um trabalho orientado a eventos usando o portal Azure, procure por Jobs de Aplicações de Container no portal Azure e selecione Criar. Especifique o tipo de gatilho baseado em eventos e configure a regra de escalabilidade.

Para iniciar a execução de um trabalho usando a CLI do Azure, use o az containerapp job start comando. O exemplo a seguir inicia uma execução de um trabalho nomeado my-job em um grupo de recursos chamado my-resource-group:

az containerapp job start --name "my-job" --resource-group "my-resource-group"

Para iniciar a execução de um trabalho usando a API REST do Azure Resource Manager, faça uma POST requisição para a operação start do trabalho.

O exemplo a seguir inicia uma execução de um trabalho nomeado my-job em um grupo de recursos chamado my-resource-group:

POST https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/my-resource-group/providers/Microsoft.App/jobs/my-job/start?api-version=2023-05-01
Authorization: Bearer <TOKEN>

Substitua <SUBSCRIPTION_ID> pelo seu ID de subscrição.

Para autenticar a solicitação, substitua <TOKEN> no cabeçalho Authorization por um token de portador válido. A identidade utilizada para gerar o token tem de ter a permissão Microsoft.App/jobs/start/action no recurso de tarefa do Container Apps. As funções incorporadas Operador de Tarefas do Container Apps e Contribuidor de Tarefas do Container Apps incluem esta permissão. Para mais informações, consulte a API Jobs - Start REST.

Para iniciar uma execução de trabalho no portal Azure, selecione Executar agora na página de visão geral do trabalho.

Para substituir a configuração do job ao iniciar uma execução, use o comando az containerapp job start e passe um ficheiro YAML contendo o modelo para usar na execução. O exemplo a seguir inicia uma execução de um trabalho nomeado my-job em um grupo de recursos chamado my-resource-group.

Recupere a configuração atual do trabalho com o az containerapp job show comando e guarde o modelo num ficheiro chamado my-job-template.yaml:

az containerapp job show --name "my-job" --resource-group "my-resource-group" --query "properties.template" --output yaml > my-job-template.yaml

A --query "properties.template" opção retorna apenas a configuração do modelo do trabalho.

Edite o my-job-template.yaml arquivo para substituir a configuração do trabalho. Por exemplo, para substituir as variáveis de ambiente, modifique a env seção:

containers:
- name: print-hello
  image: ubuntu
  resources:
    cpu: 1
    memory: 2Gi
  env:
  - name: MY_NAME
    value: Azure Container Apps jobs
  args:
  - /bin/bash
  - -c
  - echo "Hello, $MY_NAME!"

Inicie o trabalho usando o modelo:

az containerapp job start --name "my-job" --resource-group "my-resource-group" \
    --yaml my-job-template.yaml

Para substituir a configuração do trabalho, inclua um modelo no corpo da solicitação. O exemplo a seguir substitui o comando de inicialização para executar um comando diferente:

POST https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/my-resource-group/providers/Microsoft.App/jobs/my-job/start?api-version=2023-05-01
Content-Type: application/json
Authorization: Bearer <TOKEN>

{
    "containers": [
        {
            "image": "mcr.microsoft.com/k8se/quickstart-jobs:latest",
            "name": "main",
            "resources": {
                "cpu": 0.25,
                "memory": "0.5Gi"
            },
            "command": [
                "echo",
                "Hello, Azure Container Apps jobs!"
            ]
        }
    ]
}

Substitua <SUBSCRIPTION_ID> pelo ID da sua subscrição e substitua <TOKEN> no cabeçalho Authorization por um token de portador válido. A identidade utilizada para gerar o token tem de ter a permissão Microsoft.App/jobs/start/action no recurso de tarefa do Container Apps. As funções incorporadas Operador de Tarefas do Container Apps e Contribuidor de Tarefas do Container Apps incluem esta permissão. Para mais informações, consulte a API Jobs - Start REST.

Não há suporte para iniciar uma execução de trabalho com uma configuração substituída no portal do Azure.

Para obter os estados das execuções de trabalhos usando a CLI do Azure, use o az containerapp job execution list comando. O exemplo a seguir retorna o status da execução mais recente de um trabalho nomeado my-job em um grupo de recursos chamado my-resource-group:

az containerapp job execution list --name "my-job" --resource-group "my-resource-group"

Para obter o estado das execuções de trabalhos usando a API REST do Azure Resource Manager, faça um GET pedido à operação do executions trabalho. O exemplo a seguir retorna o status da execução mais recente de um trabalho nomeado my-job em um grupo de recursos chamado my-resource-group:

GET https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/my-resource-group/providers/Microsoft.App/jobs/my-job/executions?api-version=2023-05-01

Substitua <SUBSCRIPTION_ID> pelo seu ID de subscrição.

Para autenticar o pedido, adicione um Authorization cabeçalho que contenha um token portador válido. Para obter mais informações, consulte Referência da API REST do Azure.

Para ver o estado das execuções de trabalhos usando o portal Azure, procure Trabalhos de Aplicações de Contentor no portal Azure e selecione o trabalho. No painel esquerdo, em Monitorização, selecione Histórico de Execuções para ver o estado das execuções recentes.

O exemplo a seguir cria um trabalho com opções de configuração avançadas:

az containerapp job create \
    --name "my-job" --resource-group "my-resource-group"  --environment "my-environment" \
    --trigger-type "Schedule" \
    --replica-timeout 1800 --replica-retry-limit 3 --replica-completion-count 5 --parallelism 5 \
    --image "myregistry.azurecr.io/quickstart-jobs:latest" \
    --cpu "0.25" --memory "0.5Gi" \
    --command "/startup.sh" \
    --env-vars "MY_ENV_VAR=my-value" \
    --cron-expression "0 0 * * *"  \
    --registry-server "myregistry.azurecr.io" \
    --registry-username "myregistry" \
    --registry-password "myregistrypassword"

O seguinte exemplo parcial de um modelo Azure Resource Manager cria um trabalho com opções avançadas de configuração:

{
    "location": "North Central US",
    "name": "my-job",
    "properties": {
        "configuration": {
            "scheduleTriggerConfig": {
                "cronExpression": "0 0 * * *",
                "parallelism": 5,
                "replicaCompletionCount": 5
            },
            "replicaRetryLimit": 3,
            "replicaTimeout": 1800,
            "triggerType": "Schedule",
            "secrets": [
                {
                    "name": "registry-password",
                    "value": "myregistrypassword"
                }
            ]
            "registries": [
                {
                    "server": "myregistry.azurecr.io",
                    "username": "myregistry",
                    "passwordSecretRef": "registry-password"
                }
            ]
        },
        "environmentId": "/subscriptions/<subscription_id>/resourceGroups/my-resource-group/providers/Microsoft.App/managedEnvironments/my-environment",
        "template": {
            "containers": [
                {
                    "command": [
                        "/startup.sh"
                    ],
                    "cpu": 0.25,
                    "envVars": [
                        {
                            "name": "MY_ENV_VAR",
                            "value": "my-value"
                        }
                    ],
                    "image": "myregistry.azurecr.io/quickstart-jobs:latest",
                    "memory": "0.5Gi",
                    "name": "main",
                    "resources": {
                        "cpu": 0.25,
                        "memory": "0.5Gi"
                    }
                }
            ]
        }
    }
}

Para configurar definições avançadas usando o portal Azure, crie o trabalho conforme descrito anteriormente neste artigo e depois, em Definições no painel esquerdo, selecione Configuração. Edita as definições de configuração no painel de Configuração .