Azure Container Apps のジョブ

Azure CLI を使用して手動ジョブを作成するには、 az containerapp job create コマンドを使用します。 次の例では、my-job というリソース グループと my-resource-group という Container Apps 環境内に 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"

次の Azure Resource Manager テンプレートの部分的な例では、my-job という名前のリソース グループと my-resource-group という名前の Container Apps 環境に、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"
                    }
                }
            ]
        }
    }
}

Azure portal を使用して手動ジョブを作成するには、Azure portal で コンテナー アプリ ジョブ を検索し、[ 作成] を選択します。 トリガーの種類として[マニュアル] を指定します。

サンプル コンテナー イメージを使用するには、[ コンテナー] タブ に次の値を入力します。

Azure CLI を使用してスケジュールされたジョブを作成するには、 az containerapp job create コマンドを使用します。 次の例では、my-job というリソース グループと my-resource-group という Container Apps 環境内に 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 * * * *"

次の Azure Resource Manager テンプレートの部分的な例では、my-job という名前のリソース グループと my-resource-group という名前の Container Apps 環境に、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"
                    }
                }
            ]
        }
    }
}

Azure portal を使用してスケジュールされたジョブを作成するには、Azure portal で コンテナー アプリ ジョブ を検索し、[ 作成] を選択します。 トリガーの種類として [スケジュール] を指定し、毎分実行する */1 * * * * など、cron 式を使用してスケジュールを定義します。

サンプル コンテナー イメージを使用するには、[ コンテナー] タブ に次の値を入力します。

Azure CLI を使用してイベント ドリブン ジョブを作成するには、 az containerapp job create コマンドを使用します。 次の例では、my-job というリソース グループと my-resource-group という Container Apps 環境内に 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>"

この例では、Azure Storage キュー スケール ルールを構成します。

Azure Resource Manager テンプレートの次の部分的な例では、my-job という名前のリソース グループと my-resource-group という名前の Container Apps 環境に、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"
                    }
                }
            ]
        }
    }
}

この例では、Azure Storage キュー スケール ルールを構成します。

Azure portal を使用してイベント ドリブン ジョブを作成するには、Azure portal で コンテナー アプリ ジョブ を検索し、[ 作成] を選択します。 トリガーの種類として イベント ドリブン を指定し、スケーリング ルールを構成します。

Azure CLI を使用してジョブの実行を開始するには、 az containerapp job start コマンドを使用します。 次の例では、my-job というリソース グループの my-resource-group というジョブの実行を開始します。

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

Azure Resource Manager REST API を使用してジョブの実行を開始するには、ジョブのPOST操作にstart要求を行います。

次の例では、my-job というリソース グループの 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>

<SUBSCRIPTION_ID> は、サブスクリプション ID で置き換えてください。

要求を認証するには、<TOKEN> ヘッダーの Authorization を有効なベアラー トークンに置き換えます。 トークンの生成に使用される ID には、Container Apps ジョブ リソースに対する Contributor アクセス許可が必要です。 詳細については、「Azure REST API リファレンス」を参照してください。

Azure portal でジョブの実行を開始するには、ジョブの概要ページで [ 今すぐ実行 ] を選択します。

実行を開始するときにジョブの構成をオーバーライドするには、 az containerapp job start コマンドを使用し、実行に使用するテンプレートを含む YAML ファイルを渡します。 次の例では、my-job というリソース グループの my-resource-group というジョブの実行を開始します。

az containerapp job show コマンドを使用してジョブの現在の構成を取得し、テンプレートを 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

--query "properties.template" オプションによって、ジョブのテンプレート構成のみが返されます。

my-job-template.yaml ファイルを編集して、ジョブの構成をオーバーライドします。 たとえば、環境変数をオーバーライドするには、 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!"

次のテンプレートを使用してジョブを開始します。

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

ジョブの構成をオーバーライドするには、要求本文にテンプレートを含めます。 次の例では、スタートアップ コマンドをオーバーライドして別のコマンドを実行します。

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

<SUBSCRIPTION_ID> を自分のサブスクリプション ID に、<TOKEN> ヘッダーの Authorization を有効なベアラー トークンに置き換えます。 トークンの生成に使用される ID には、Container Apps ジョブ リソースに対する Contributor アクセス許可が必要です。 詳細については、「Azure REST API リファレンス」を参照してください。

オーバーライドされた構成でジョブ実行を開始することは、Azure portal ではサポートされていません。

Azure CLI を使用してジョブ実行の状態を取得するには、 az containerapp job execution list コマンドを使用します。 次の例は、my-job というリソース グループ内の my-resource-group というジョブの直近の実行状態を返します。

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

Azure Resource Manager REST API を使用してジョブ実行の状態を取得するには、ジョブのGET操作にexecutions要求を行います。 次の例は、my-job というリソース グループ内の 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

<SUBSCRIPTION_ID> は、サブスクリプション ID で置き換えてください。

要求を認証するには、有効なベアラー トークンを含む Authorization ヘッダーを追加します。 詳細については、「Azure REST API リファレンス」を参照してください。

Azure portal を使用してジョブ実行の状態を表示するには、Azure portal で Container App Jobs を 検索し、ジョブを選択します。 左側のウィンドウの [ 監視] で、[ 実行履歴 ] を選択して、最近の実行の状態を確認します。

次の例では、高度な構成オプションを指定したジョブを作成します。

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"

Azure Resource Manager テンプレートの次の部分的な例では、高度な構成オプションを使用してジョブを作成します。

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

Azure portal を使用して詳細設定を構成するには、この記事で前述したようにジョブを作成し、左側のウィンドウの [設定] で [構成] を選択します。 [構成] ウィンドウで 構成 設定を編集します。