Configura tareas

En este documento, se describe cómo configurar tareas en Cloud Deploy. Una tarea es una unidad de trabajo que se puede usar como un gancho de implementación, para la verificación de la implementación, para el análisis de la implementación o para una renderización personalizada o una implementación personalizada en un tipo de destino personalizado.

Puedes configurar una tarea en la canalización de entrega (como parte de la estrategia) o en la renderización o implementación del tipo de destino personalizado.

Con las tareas, puedes usar parámetros del sistema si los incluyes en la configuración de la tarea como plantillas.

Cómo definir una tarea

Puedes definir una tarea en la configuración de tu canalización de entrega o como parte de una definición de tipo de destino personalizado. El siguiente código YAML muestra la sección task que se usa en ambos casos:

  task:
    type: container
    image: IMAGE
    command: [COMMANDS_TO_RUN]
    args: [LIST_OF_ARGS]
    env:
    - KEY1:VAL1
    - KEY2:VAL2
    ...

Para la configuración de task, haz lo siguiente:

• type

  Especifica el tipo de tarea que se configura. Solo se admite container.

• image

  Es la ruta de acceso a la imagen del contenedor.

• command

  Es el comando o los comandos que se ejecutarán en el contenedor.

• args

  Es una colección de argumentos para command.

• env

  Es una colección de variables de entorno que se proporcionarán al contenedor en ejecución.

Parámetros del sistema como variables de entorno de la tarea

Cloud Deploy ofrece parámetros generados por el sistema que puedes usar como variables de entorno en tus tareas, con el campo env en la tarea container. Los parámetros basados en plantillas pueden estar presentes en los campos de clave o valor de una entrada de mapa env.

Estos son algunos ejemplos de casos de uso:

• Pasar el nombre del servicio de Cloud Run, la URL del servicio y el nombre de la revisión como variables de entorno

  task:
    type: container
    image: my-image
    command: ["/bin/bash"]
    env:
    - RUN_SERVICE_NAME : "${{ render.metadata.cloud_run.service.name }}"
    - RUN_SERVICE_URL: "${{ rollout.metadata.cloud_run.service_url }}"
    - RUN_REVISION_NAME: "${{ render.metadata.cloud_run.revision.name }}"
  

• Usar varios parámetros en una sola entrada

  task:
    type: container
    image: my-image
    command: ["/bin/bash"]
    env:
    - DEPLOY_PARAMS_KEY : "${{ deploy_params['FOO'] }}-with-${{ deploy_params['BAR'] }}"
    - "${{ project.id }}_${{ location }}" : "${{ target.id }}"
  

Parámetros del sistema disponibles

Cloud Deploy proporciona los siguientes parámetros del sistema que puedes usar en la configuración de tus tareas con este formato:

${{ parameter }}

$${{ }}

A continuación, se muestra la lista de parámetros disponibles para la creación de plantillas: