Aufträge in Azure Container Apps

Wenn Sie einen manuellen Auftrag mit der Azure CLI erstellen möchten, können Sie den Befehl az containerapp job create verwenden. Im folgenden Beispiel wird ein manueller Auftrag namens my-job in einer Ressourcengruppe namens my-resource-group und in einer Container Apps-Umgebung namens my-environment erstellt:

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

Die folgende exemplarische Azure Resource Manager-Vorlage erstellt einen manuellen Auftrag namens my-job in einer Ressourcengruppe namens my-resource-group und in einer Container Apps-Umgebung namens 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"
                    }
                }
            ]
        }
    }
}

Um einen manuellen Auftrag über das Azure-Portal zu erstellen, suchen Sie im Azure-Portal nach Container Apps-Aufträgen, und wählen Sie Erstellen aus. Geben Sie als Triggertyp Manuell an.

Geben Sie auf der Registerkarte Container die folgenden Werte ein, um ein Beispielcontainerimage zu verwenden:

Wenn Sie einen geplanten Auftrag mit der Azure CLI erstellen möchten, können Sie den Befehl az containerapp job create verwenden. Im folgenden Beispiel wird ein geplanter Auftrag namens my-job in einer Ressourcengruppe namens my-resource-group und in einer Container Apps-Umgebung namens my-environment erstellt:

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

Die folgende exemplarische Azure Resource Manager-Vorlage erstellt einen manuellen Auftrag namens my-job in einer Ressourcengruppe namens my-resource-group und in einer Container Apps-Umgebung namens 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"
                    }
                }
            ]
        }
    }
}

Um einen geplanten Auftrag über das Azure-Portal zu erstellen, suchen Sie im Azure-Portal nach Container Apps-Aufträgen, und wählen Sie Erstellen aus. Geben Sie als Triggertyp Zeitplan an, und definieren Sie den Zeitplan mit einem Cron-Ausdruck, z. B. */1 * * * * für die Ausführung im Minutentakt.

Geben Sie auf der Registerkarte Container die folgenden Werte ein, um ein Beispielcontainerimage zu verwenden:

Wenn Sie einen ereignisgesteuerten Auftrag mit der Azure CLI erstellen möchten, können Sie den Befehl az containerapp job create verwenden. Im folgenden Beispiel wird ein ereignisgesteuerter Auftrag namens my-job in einer Ressourcengruppe namens my-resource-group und in einer Container Apps-Umgebung namens my-environment erstellt:

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>"

In dem Beispiel wird eine Azure Storage-Warteschlangenskalierungsregel konfiguriert.

Die folgende exemplarische Azure Resource Manager-Vorlage erstellt einen ereignisgesteuerten Auftrag namens my-job in einer Ressourcengruppe namens my-resource-group und in einer Container Apps-Umgebung namens 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"
                    }
                }
            ]
        }
    }
}

In dem Beispiel wird eine Azure Storage-Warteschlangenskalierungsregel konfiguriert.

Um einen ereignisgesteuerten Auftrag über das Azure-Portal zu erstellen, suchen Sie im Azure-Portal nach Container Apps-Aufträgen, und wählen Sie Erstellen aus. Geben Sie als Triggertyp Ereignis an, und konfigurieren Sie die Skalierungsregel.

Verwenden Sie den Befehl az containerapp job start, um eine Auftragsausführung mithilfe der Azure CLI zu starten. Im folgenden Beispiel wird die Ausführung eines Auftrags namens my-job in einer Ressourcengruppe namens my-resource-group gestartet:

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

Wenn Sie eine Auftragsausführung mithilfe der Azure Resource Manager-REST-API starten möchten, können Sie eine POST-Anforderung an den Vorgang start des Auftrags senden.

Im folgenden Beispiel wird die Ausführung eines Auftrags namens my-job in einer Ressourcengruppe namens my-resource-group gestartet:

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>

Ersetzen Sie <SUBSCRIPTION_ID> durch Ihre Abonnement-ID.

Ersetzen Sie <TOKEN> im Header Authorization durch ein gültiges Bearertoken, um die Anforderung zu authentifizieren. Die zum Generieren des Tokens verwendete Identität muss über Berechtigungen vom Typ Contributor für die Container Apps-Auftragsressource verfügen. Weitere Informationen finden Sie unter Azure-REST-API-Referenz.

Um eine Auftragsausführung im Azure-Portal zu starten, wählen Sie auf der Übersichtsseite des Auftrags Jetzt ausführen aus.

Um die Konfiguration des Auftrags beim Starten einer Ausführung außer Kraft zu setzen, verwenden Sie den Befehl az containerapp job start, und übergeben Sie eine YAML-Datei, die die Vorlage für die Ausführung enthält. Im folgenden Beispiel wird die Ausführung eines Auftrags namens my-job in einer Ressourcengruppe namens my-resource-group gestartet.

Rufen Sie die aktuelle Konfiguration des Auftrags mit dem Befehl az containerapp job show ab, und speichern Sie die Vorlage in einer Datei namens 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

Die Option --query "properties.template" gibt nur die Vorlagenkonfiguration des Auftrags zurück.

Bearbeiten Sie die Datei my-job-template.yaml, um die Konfiguration des Auftrags außer Kraft zu setzen. Um beispielsweise die Umgebungsvariablen außer Kraft zu setzen, ändern Sie den Abschnitt env:

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!"

Starten Sie den Auftrag mithilfe der Vorlage:

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

Schließen Sie eine Vorlage in den Anforderungstext ein, um die Konfiguration des Auftrags außer Kraft zu setzen. Im folgenden Beispiel wird der Startbefehl außer Kraft gesetzt, um einen anderen Befehl auszuführen:

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>

{
    "template": {
        "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!"
                ]
            }
        ]
    }
}

Ersetzen Sie <SUBSCRIPTION_ID> durch Ihre Abonnement-ID und <TOKEN> im Header Authorization durch ein gültiges Bearertoken. Die zum Generieren des Tokens verwendete Identität muss über Berechtigungen vom Typ Contributor für die Container Apps-Auftragsressource verfügen. Weitere Informationen finden Sie unter Azure-REST-API-Referenz.

Das Starten einer Auftragsausführung mit einer außer Kraft gesetzten Konfiguration wird im Azure-Portal nicht unterstützt.

Verwenden Sie den Befehl az containerapp job execution list, um den Status von Auftragsausführungen mithilfe der Azure CLI abzurufen. Im folgenden Beispiel wird der Status der letzten Ausführung eines Auftrags namens my-job in einer Ressourcengruppe namens my-resource-group zurückgegeben:

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

Wenn Sie den Status von Auftragsausführungen mithilfe der Azure Resource Manager-REST-API abrufen möchten, können Sie eine GET-Anforderung an den Vorgang executions des Auftrags senden. Im folgenden Beispiel wird der Status der letzten Ausführung eines Auftrags namens my-job in einer Ressourcengruppe namens my-resource-group zurückgegeben:

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

Ersetzen Sie <SUBSCRIPTION_ID> durch Ihre Abonnement-ID.

Fügen Sie einen Header vom Typ Authorization mit einem gültigen Bearertoken hinzu, um die Anforderung zu authentifizieren. Weitere Informationen finden Sie unter Azure-REST-API-Referenz.

Um den Status der Auftragsausführungen über das Azure-Portal anzuzeigen, suchen Sie im Azure-Portal nach Container Apps-Aufträgen, und wählen Sie den entsprechenden Auftrag aus. Die Registerkarte Ausführungsverlauf zeigt den Status der letzten Ausführungen an.

Im folgenden Beispiel wird ein Auftrag mit erweiterten Konfigurationsoptionen erstellt:

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"

Die folgende exemplarische Azure Resource Manager-Vorlage erstellt einen Auftrag mit erweiterten Konfigurationsoptionen:

{
    "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"
                    }
                }
            ]
        }
    }
}

Um erweiterte Einstellungen über das Azure-Portal zu konfigurieren, suchen Sie im Azure-Portal nach Container Apps-Aufträgen, und wählen Sie Erstellen aus. Wählen Sie Konfiguration aus, um die Einstellungen zu konfigurieren.