Rövid útmutató: Feladat létrehozása az Azure Container Appsben

Ebben a rövid útmutatóban hozzon létre egy Azure Container Apps-feladatot. A Container Appsben a feladatok olyan tárolóalapú feladatok indítására szolgálnak, amelyek véges ideig futnak, majd kilépnek. A feladatok olyan feladatokhoz ideálisak, mint az adatfeldolgozás, a gépi tanulás, az erőforrás-törlés vagy az igény szerinti feldolgozást igénylő forgatókönyvek.

A feladatokat manuálisan indíthatja el, ütemezheti a futtatásokat, vagy események alapján aktiválhatja a futtatásokat. Ez a rövid útmutató bemutatja, hogyan hozhat létre manuális vagy ütemezett feladatot. Az eseményvezérelt feladatok létrehozásának módjáról az Eseményvezérelt feladatok üzembe helyezése az Azure Container Appsben című témakörben olvashat.

Előfeltételek

Azokról a funkciókról, amelyeket a Container Apps-feladatok nem támogatnak, tekintse meg a feladatokra vonatkozó korlátozásokat.

A környezet előkészítése

  1. Ha az Azure CLI-ből szeretne bejelentkezni az Azure-ba, futtassa az alábbi parancsot, és kövesse az utasításokat a hitelesítési folyamat befejezéséhez.

    az login
    
  2. Győződjön meg arról, hogy az Azure CLI legújabb verzióját futtatja a az upgrade parancson keresztül.

    az upgrade
    
  3. Telepítse a Container Apps CLI-bővítmény legújabb verzióját.

    az extension add --name containerapp --upgrade
    
  4. Regisztrálja a Microsoft.App, Microsoft.OperationalInsightsés Microsoft.Storage a névtereket, ha még nincs regisztrálva az Azure-előfizetésben.

    az provider register --namespace Microsoft.App
    az provider register --namespace Microsoft.OperationalInsights
    az provider register --namespace Microsoft.Storage
    
  5. Határozza meg a cikkben használt környezeti változókat.

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

Container Apps-környezet létrehozása

A Container Apps-környezet elkülönítési határként működik a tárolóalkalmazások és -feladatok körül, így megoszthatják ugyanazt a hálózatot, és kommunikálhatnak egymással.

  1. Hozzon létre egy erőforráscsoportot az alábbi paranccsal.

    az group create \
        --name "$RESOURCE_GROUP" \
        --location "$LOCATION"
    
  2. Hozza létre a Container Apps-környezetet az alábbi paranccsal.

    az containerapp env create \
        --name "$ENVIRONMENT" \
        --resource-group "$RESOURCE_GROUP" \
        --location "$LOCATION"
    

Manuális feladat létrehozása és futtatása

Manuális feladatok használatához először hozzon létre egy feladatot egy triggertípussal Manual , majd indítsa el a futtatását. Több futtatást is elindíthat ugyanabból a feladatból, és egyszerre több feladatvégrehajtás is futtatható.

  1. Hozzon létre egy feladatot a Container Apps-környezetben az alábbi paranccsal.

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

    A manuális feladatok nem futnak automatikusan. Minden feladatot el kell indítania.

  2. Indítsa el a feladatot az alábbi paranccsal.

    az containerapp job start \
        --name "$JOB_NAME" \
        --resource-group "$RESOURCE_GROUP"
    

    A parancs részletes információkat ad vissza a feladat futtatásáról, a nevével együtt.

Ütemezett feladat létrehozása és futtatása

Ütemezett feladatok használatához létrehoz egy feladatot egy eseményindító típusával Schedule és egy cron olyan kifejezéssel, amely meghatározza az ütemezést.

Az alábbi paranccsal percenként elinduló Container Apps-feladat hozható létre.

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

A feladat automatikusan elindul az ütemezés alapján.

A Container Apps-feladatok cron kifejezésekkel határozzák meg az ütemezéseket. A feladatok támogatják a szabványos cron kifejezésformátumot, amely a perc, az óra, a hónap, a hónap és a hét napjának mezőit tartalmazza.

Legutóbbi feladatok futtatási előzményeinek listája

A Container Apps feladatok megőrzik a legutóbbi futtatások előzményeit. A feladatok futtatását listázhatja.

az containerapp job execution list \
    --name "$JOB_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --output table \
    --query '[].{Status: properties.status, Name: name, StartTime: properties.startTime}'

A feladatok futás közben megjelennek a listában.

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

Feladatfuttatási naplók lekérdezése

A feladat futtatások kimeneti naplókat írnak a Container Apps környezet számára konfigurált naplózási szolgáltatóhoz. A naplók alapértelmezés szerint a Log Analyticsben vannak tárolva.

  1. Mentse a Container Apps-környezet Log Analytics-munkaterület-azonosítóját egy változóba.

    LOG_ANALYTICS_WORKSPACE_ID=$(az containerapp env show \
        --name "$ENVIRONMENT" \
        --resource-group "$RESOURCE_GROUP" \
        --query "properties.appLogsConfiguration.logAnalyticsConfiguration.customerId" \
        --output tsv)
    
  2. Mentse a legutóbb futtatott feladat nevét egy változóba.

    JOB_RUN_NAME=$(az containerapp job execution list \
        --name "$JOB_NAME" \
        --resource-group "$RESOURCE_GROUP" \
        --query "[0].name" \
        --output tsv)
    
  3. Futtasson egy Log Analytics-lekérdezést a feladathoz az alábbi paranccsal.

    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"
    

    Feljegyzés

    Amíg a ContainerAppConsoleLogs_CL tábla nem áll készen, a parancs nem ad vissza eredményt, vagy a következő hibaüzenetet adja vissza: "BadArgumentError: A kérelem érvénytelen tulajdonságokkal rendelkezik." Mindkét esetben várjon néhány percet, majd futtassa újra a parancsot.

    Az alábbi kimenet egy példa a feladatfuttatás által kinyomtatott naplókra.

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

Az erőforrások eltávolítása

Ha nem fogja használni ezt a feladatot, futtassa az alábbi parancsot az erőforráscsoport és az összes erőforrás törléséhez ebből a rövid útmutatóból.

Figyelemfelhívás

Az alábbi parancs törli a megadott erőforráscsoportot és a benne lévő összes erőforrást. Ha a rövid útmutató hatókörén kívüli erőforrások a megadott erőforráscsoportban találhatók, akkor azok is törlődnek.

az group delete --name "$RESOURCE_GROUP"

Tipp.

Problémákat tapasztal? Tudassa velünk a GitHubon, ha megnyit egy hibát az Azure Container Apps adattárában.

Következő lépés