Azure Container Apps'teki işler

Azure CLI kullanarak el ile iş oluşturmak için komutunu kullanın az containerapp job create . Aşağıdaki örnek, adlı bir kaynak grubunda ve adlı bir Container Apps ortamında adlı my-job my-resource-group my-environmentel ile bir iş oluşturur:

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"

Aşağıdaki örnek Azure Resource Manager şablonu, adlı bir kaynak grubunda ve adlı bir Container Apps ortamında adlı my-job my-resource-group my-environmentel ile bir iş oluşturur:

{
    "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ını kullanarak el ile iş oluşturmak için Azure portalında Kapsayıcı Uygulama İşleri'ni arayın ve Oluştur'u seçin. Tetikleyici türü olarak El ile seçeneğini belirtin.

Örnek kapsayıcı görüntüsü kullanmak için Kapsayıcılar sekmesine aşağıdaki değerleri girin:

Azure CLI kullanarak zamanlanmış iş oluşturmak için komutunu kullanın az containerapp job create . Aşağıdaki örnek adlı bir kaynak grubunda adlı my-job zamanlanmış bir iş ve adlı my-resource-group my-environmentbir Container Apps ortamı oluşturur:

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

Aşağıdaki örnek Azure Resource Manager şablonu, adlı bir kaynak grubunda ve adlı bir Container Apps ortamında adlı my-job my-resource-group my-environmentel ile bir iş oluşturur:

{
    "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ını kullanarak zamanlanmış bir iş oluşturmak için Azure portalında Kapsayıcı Uygulama İşleri'ni arayın ve Oluştur'u seçin. Tetikleyici türü olarak Schedule değerini belirtin ve zamanlamayı dakikada bir çalıştırmak gibi */1 * * * * bir cron ifadesiyle tanımlayın.

Örnek kapsayıcı görüntüsü kullanmak için Kapsayıcılar sekmesine aşağıdaki değerleri girin:

Azure CLI kullanarak olay odaklı bir iş oluşturmak için komutunu kullanın az containerapp job create . Aşağıdaki örnek adlı bir kaynak grubunda adlı my-job olay temelli bir iş ve adlı my-resource-group my-environmentbir Container Apps ortamı oluşturur:

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

Örnek bir Azure Depolama kuyruğu ölçek kuralı yapılandırıyor.

Aşağıdaki örnek Azure Resource Manager şablonu adlı kaynak grubunda adlı my-job olay temelli bir iş ve adlı my-resource-group my-environmentbir Container Apps ortamı oluşturur:

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

Örnek bir Azure Depolama kuyruğu ölçek kuralı yapılandırıyor.

Azure portalını kullanarak olay odaklı bir iş oluşturmak için Azure portalında Kapsayıcı Uygulama İşleri'ni arayın ve Oluştur'u seçin. Tetikleyici türü olarak Olay belirtin ve ölçeklendirme kuralını yapılandırın.

Azure CLI kullanarak bir iş yürütme başlatmak için komutunu kullanın az containerapp job start . Aşağıdaki örnek adlı my-resource-groupkaynak grubunda adlı my-job bir işin yürütülmesini başlatır:

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

Azure Resource Manager REST API'sini kullanarak bir iş yürütme başlatmak için işin start işlemine bir POST istek gönderin.

Aşağıdaki örnek adlı my-resource-groupkaynak grubunda adlı my-job bir işin yürütülmesini başlatır:

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>

değerini abonelik kimliğiniz ile değiştirin <SUBSCRIPTION_ID> .

İsteğin kimliğini doğrulamak için üst bilgideki Authorization değerini geçerli bir taşıyıcı belirteci ile değiştirin<TOKEN>. Belirteci oluşturmak için kullanılan kimliğin Container Apps iş kaynağı için izni olmalıdır Contributor . Daha fazla bilgi için bkz . Azure REST API başvurusu.

Azure portalında bir iş yürütme başlatmak için işin genel bakış sayfasında Şimdi çalıştır'ı seçin.

Yürütmeyi başlatırken işin yapılandırmasını geçersiz kılmak için komutunu kullanın az containerapp job start ve yürütme için kullanılacak şablonu içeren bir YAML dosyası geçirin. Aşağıdaki örnek adlı my-resource-groupkaynak grubunda adlı my-job bir işin yürütülmesini başlatır.

komutuyla az containerapp job show işin geçerli yapılandırmasını alın ve şablonu adlı my-job-template.yamlbir dosyaya kaydedin:

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

--query "properties.template" seçeneği yalnızca işin şablon yapılandırmasını döndürür.

my-job-template.yaml İşin yapılandırmasını geçersiz kılmak için dosyayı düzenleyin. Örneğin, ortam değişkenlerini geçersiz kılmak için bölümünü değiştirin 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!"

şablonu kullanarak işi başlatın:

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

İşin yapılandırmasını geçersiz kılmak için istek gövdesine bir şablon ekleyin. Aşağıdaki örnek, farklı bir komut çalıştırmak için başlangıç komutunu geçersiz kılar:

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

değerini abonelik kimliğiniz ve <TOKEN> üst bilgisinde Authorization geçerli bir taşıyıcı belirteci ile değiştirin<SUBSCRIPTION_ID>. Belirteci oluşturmak için kullanılan kimliğin Container Apps iş kaynağı için izni olmalıdır Contributor . Daha fazla bilgi için bkz . Azure REST API başvurusu.

Geçersiz kılınmış bir yapılandırmayla iş yürütme başlatmak Azure portalında desteklenmez.

Azure CLI kullanarak iş yürütmelerinin durumlarını almak için komutunu kullanın az containerapp job execution list . Aşağıdaki örnek, adlı my-resource-groupkaynak grubunda adlı my-job bir işin en son yürütülmesinin durumunu döndürür:

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

Azure Resource Manager REST API'sini kullanarak iş yürütmelerinin durumunu almak için işin işlemine bir GET istekte bulunun executions . Aşağıdaki örnek, adlı my-resource-groupkaynak grubunda adlı my-job bir işin en son yürütülmesinin durumunu döndürür:

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

değerini abonelik kimliğiniz ile değiştirin <SUBSCRIPTION_ID> .

İsteğin kimliğini doğrulamak için geçerli taşıyıcı Authorization belirteci olan bir üst bilgi ekleyin. Daha fazla bilgi için bkz . Azure REST API başvurusu.

Azure portalını kullanarak iş yürütmelerinin durumunu görüntülemek için Azure portalında Kapsayıcı Uygulama İşleri'ni arayın ve işi seçin. Yürütme geçmişi sekmesi, son yürütmelerin durumunu görüntüler.

Aşağıdaki örnek, gelişmiş yapılandırma seçeneklerine sahip bir iş oluşturur:

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"

Aşağıdaki örnek Azure Resource Manager şablonu, gelişmiş yapılandırma seçeneklerine sahip bir iş oluşturur:

{
    "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ını kullanarak gelişmiş ayarları yapılandırmak için Azure portalında Kapsayıcı Uygulama İşleri'ni arayın ve Oluştur'u seçin. Ayarları yapılandırmak için Yapılandırma'yı seçin.