Inicio rápido: Creación de un trabajo en Azure Container Apps

En este Inicio Rápido, usted creará una tarea de Azure Container Apps. En Container Apps, los trabajos se utilizan para iniciar tareas en contenedores que se ejecutan durante una duración finita y luego finalizan. Los trabajos son más adecuados para tareas como el procesamiento de datos, el aprendizaje automático, la limpieza de recursos o cualquier escenario que requiera procesamiento a petición.

Puede desencadenar un trabajo manualmente, programar su ejecución o desencadenar su ejecución en función de los eventos. En este inicio rápido se muestra cómo crear un trabajo manual o programado. Para obtener información sobre cómo crear un trabajo controlado por eventos, consulte Implementación de un trabajo controlado por eventos con Azure Container Apps.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Si no tiene ninguna, puede crear una gratis.
• LaCLI de Azure.

Para obtener información sobre las características que los trabajos de Container Apps no admiten, consulte Restricciones de trabajos.

Preparación del entorno

1. Para iniciar sesión en Azure desde la CLI de Azure, ejecute el siguiente comando y siga las indicaciones para completar el proceso de autenticación.

   az login
   

2. Asegúrese de que ejecuta la versión más reciente de la CLI de Azure mediante el az upgrade comando .

   az upgrade
   

3. Instale la versión más reciente de la extensión de la CLI de Container Apps.

   az extension add --name containerapp --upgrade
   

4. Registre los Microsoft.App, Microsoft.OperationalInsights, y Microsoft.Storage si aún no están registrados en su suscripción de Azure.

   az provider register --namespace Microsoft.App
   az provider register --namespace Microsoft.OperationalInsights
   az provider register --namespace Microsoft.Storage
   

5. Defina las variables de entorno que se usan en este artículo.

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

Creación de un entorno de Container Apps

El entorno de Container Apps actúa como una frontera de aislamiento alrededor de las aplicaciones y trabajos del contenedor para que puedan compartir la misma red y comunicarse entre sí.

1. Cree un grupo de recursos mediante el comando siguiente.

   az group create \
       --name "$RESOURCE_GROUP" \
       --location "$LOCATION"
   

2. Cree el entorno de Container Apps mediante el comando siguiente.

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

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

Enumeración del historial de ejecución de trabajos recientes

Los trabajos de Container Apps mantienen un historial de ejecuciones recientes. Puede enumerar las ejecuciones de un trabajo.

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

Los trabajos aparecen en la lista a medida que se ejecutan.

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

Consulta de registros de ejecución de trabajos

Las ejecuciones de trabajos escriben registros de salida en el proveedor de registros que configure para el entorno de Container Apps. De forma predeterminada, los registros se almacenan en Log Analytics.

1. Guarde el identificador del área de trabajo de Log Analytics para el entorno de Container Apps en una variable.

   LOG_ANALYTICS_WORKSPACE_ID=$(az containerapp env show \
       --name "$ENVIRONMENT" \
       --resource-group "$RESOURCE_GROUP" \
       --query "properties.appLogsConfiguration.logAnalyticsConfiguration.customerId" \
       --output tsv)
   

2. Guarde el nombre de la última ejecución del trabajo en una variable.

   JOB_RUN_NAME=$(az containerapp job execution list \
       --name "$JOB_NAME" \
       --resource-group "$RESOURCE_GROUP" \
       --query "[0].name" \
       --output tsv)
   

3. Ejecute una consulta de Log Analytics para el trabajo que se ejecute mediante el comando siguiente.

   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"
   

   Nota:

   Hasta que la tabla de ContainerAppConsoleLogs_CL esté lista, el comando no devuelve ningún resultado o devuelve el siguiente error: "BadArgumentError: La solicitud tenía algunas propiedades no válidas". En cualquier caso, espere unos minutos y vuelva a ejecutar el comando.

   La salida siguiente es un ejemplo de los registros generados durante la ejecución del trabajo.

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

Limpieza de recursos

Si no va a seguir usando este trabajo, ejecute el siguiente comando para eliminar el grupo de recursos y todos los recursos de este inicio rápido.

az group delete --name "$RESOURCE_GROUP"

Paso siguiente