Crea activadores de Pub/Sub

Los activadores de Pub/Sub de Cloud Build te permiten ejecutar compilaciones en respuesta a eventos de Google Cloud publicados a través de Pub/Sub. Puedes usar la información de un evento de Pub/Sub para parametrizar tu compilación y decidir si una compilación debe ejecutarse en respuesta al evento. Los activadores de Pub/Sub se pueden configurar para detectar cualquier tema de Pub/Sub.

En esta página, se explica cómo puedes crear un activador de Pub/Sub para compilar en respuesta a eventos en Artifact Registry, Container Registry y Cloud Storage.

Antes de comenzar

  • Habilita la API Cloud Build.

    Habilita la API

  • Asegúrate de que el código fuente contenga un archivo de configuración de compilación o una Dockerfile en el repositorio.
  • Para usar los comandos de gcloud en esta página, instala el SDK de Cloud.

Crea un activador de compilación que responda a los eventos de Artifact Registry

Puedes crear un activador de Pub/Sub que responda a los eventos de Artifact Registry, como cuando se envían, se etiquetan o se borran imágenes. En esta sección, se explica cómo puedes crear un activador de Pub/Sub que invoque una compilación cuando se envíe una etiqueta nueva a una imagen existente. Si no estás familiarizado con Artifact Registry, consulta la Descripción general de la administración de artefactos.

Console

Para crear un activador que escuche una etiqueta nueva enviada a una imagen existente en Artifact Registry mediante Google Cloud Console, sigue estos pasos:

  1. Abrir la página Activadores:

    Abrir la página Activadores

  2. Selecciona el proyecto en la parte superior de la página y haz clic en Abrir.

  3. Haz clic en Crear activador.

  4. Ingresa las siguientes opciones de configuración del activador:

    • Nombre: Ingresa un nombre para el activador.
    • Descripción (opcional): Ingresa una descripción para el activador.
    • Evento: Selecciona Mensaje de Pub/Sub como el evento para invocar el activador.
    • Suscripción: Selecciona el tema de Pub/Sub al que deseas suscribirte como evento de activación. Verás todos los temas existentes en el proyecto en el menú desplegable.

    • Fuente: Selecciona el repositorio que se compilará cuando se ejecute el activador.

    • Revisión: Selecciona la rama o etiqueta que se compilará cuando se ejecute el activador manual.

      • Rama: Ingresa el nombre de la rama en la que se invocará tu compilación.
      • Tag: Ingresa el nombre de la etiqueta para invocar tu compilación.
    • Configuración: Selecciona el archivo de configuración de compilación (ubicado en el repositorio remoto) o crea un archivo de configuración de compilación intercalado para usar en tu compilación.

      • Type: Selecciona el tipo de configuración que se usará para tu compilación.
        • Archivo de configuración de Cloud Build (YAML o JSON): Usa un archivo de configuración de compilación para la configuración.
        • Dockerfile: Usa Dockerfile para la configuración.
        • Buildpacks: Usa buildpacks para la configuración.
      • Ubicación: Especifica la ubicación para tu configuración.

        • Repositorio Si el archivo de configuración se encuentra en el repositorio remoto, proporciona la ubicación de tu archivoarchivo de configuración de la compilación , elDockerfile o al directorio de paquetes de compilación. Si tu tipo de configuración de compilación es Dockerfile o un paquete de compilación, deberás proporcionar un nombre para la imagen resultante y, opcionalmente, un tiempo de espera para tu compilación. Cuando hayas proporcionado el nombre de la imagen de Dockerfile o del paquete de compilación, obtendrás una vista previa del comando docker build o pack que ejecutará la compilación.
        • Variables de entorno del paquete de compilación Si seleccionastebuildpacks Como tipo de configuración, haz clic enAgregar variable de entorno de paquete para especificar las variables y los valores del entorno de compilación del paquete. Para obtener más información sobre las variables de entorno de compilación, consulta Variables de entorno.
        • Intercalada: Si seleccionaste archivo de configuración de Cloud Build (YAML o JSON) como opción de configuración, puedes especificar la configuración de compilación intercalada. Haz clic en Abrir editor para abrir tu archivo de configuración de compilación en Google Cloud Console mediante la sintaxis YAML o JSON. Haz clic en Listo para guardar la configuración de tu compilación.

    • Sustituciones Si seleccionaste el archivo de configuración de compilación como tu opción de configuración de compilación, puedes definir Variables de sustitución de un activador específico mediante este campo.

      En el siguiente ejemplo, queremos obtener el nombre de la etiqueta de imagen a partir de la carga útil y la acción asociada con el evento gcr. Para ello, crea variables de sustitución con vinculaciones de carga útil.

      Especifique las siguientes variables y valores a continuación:

      Nombre de la variable Valor de la variable
      _IMAGE_TAG $(body.message.data.tag)
      _ACTION $(body.message.data.action)

      body.message hace referencia al PubSubMessage publicado por los publicadores y consumido por los suscriptores. Para ver más ejemplos de la carga útil de notificaciones de Pub/Sub, consulta Ejemplos de notificación.

    • Filtros (opcional): Puedes crear filtros dentro de un activador que determinen si el activador ejecutará o no una compilación en respuesta a la carga útil entrante. Para ello, especifica filtros en las variables de sustitución. La expresión de filtro se debe evaluar como true para que se ejecute una compilación.

      Recomendamos usar filtros cuando configures activadores de Pub/Sub en temas con varios mensajes. Los filtros se pueden usar para controlar con precisión las compilaciones que se ejecutan en respuesta a los mensajes entrantes de Pub/Sub. Para obtener información sobre los riesgos asociados con la configuración de un activador sin filtros, consulta Riesgos asociados con un activador sin filtrar.

      En el siguiente ejemplo, queremos que el activador ejecute una compilación si se envía una etiqueta nueva a una imagen existente. Usamos los operadores de condición de filtro para comprobar si la variable _IMAGE_TAG coincide con un nombre de etiqueta existente y si la variable _ACTION coincide con INSERT a fin de buscar datos recién agregados.

      Especifique lo siguiente como filtros:

      • _IMAGE_TAG != ""
      • _ACTION == INSERT

      La sintaxis de filtro en activadores de Pub/Sub usa Common Expression Language (CEL) para la evaluación de expresiones. Para obtener más información sobre CEL, consulta el repositorio cel-spec. Si deseas ver más sintaxis de ejemplo para filtrar, puedes aplicar a tus activadores de Pub/Sub, consulta Usa CEL para filtrar eventos de compilación.

  1. Haz clic en Crear para crear el activador.
  2. .

gcloud

Para crear un activador que escuche una etiqueta nueva enviada a una imagen existente en Artifact Registry mediante los comandos de gcloud, haz lo siguiente:

  1. Abre una ventana de terminal.
  2. Ejecuta el comando gcloud alpha para crear un activador de compilación en tu proyecto. En el siguiente ejemplo, el activador está configurado para responder a las compilaciones con una coincidencia de etiquetasprod y una acción coincidenteINSERT según la carga útil especificada como lo define la variable de sustitución,_IMAGE_TAG ,

     gcloud alpha builds triggers create pubsub \
       --name=TRIGGER_NAME \
       --topic=projects/PROJECT_ID/topics/TOPIC_NAME \
       --build-config=BUILD_CONFIG \ # or --inline-config=INLINE_BUILD_CONFIG
       --substitutions=\
         _IMAGE_TAG_='$(body.message.data.tag)'
         _ACTION='$(body.message.data.action)'
       --filter='_IMAGE_TAG == "" && _ACTION == "INSERT"'
       --repo=REPO_NAME
       --tag=TAG_NAME  # or --branch=BRANCH_NAME
    

    Aquí:

    • TRIGGER_NAME es el nombre del activador.
    • PROJECT_ID es el ID de tu proyecto de Cloud.
    • TOPIC_NAME es el nombre del tema de Pub/Sub al que te suscribiste.
    • BUILD_CONFIG es la ruta de acceso al archivo de configuración de compilación.
    • INLINE_BUILD_CONFIG es la ruta de acceso a tu archivo de configuración de compilación intercalado.
    • REPO_NAME es el nombre del repositorio de origen en el que se invoca la compilación.
    • TAG_NAME es el nombre de tu etiqueta si deseas configurar el activador para que se compile en una etiqueta.
    • BRANCH_NAME es el nombre de tu rama si deseas configurar el activador para que se compile en una rama.

Crea un activador de compilación que responda a los eventos de Container Registry

Puedes crear un activador de Pub/Sub que responda a los eventos de Container Registry, como cuando se envían, se etiquetan o se borran imágenes. En esta sección, se explica cómo puedes crear un activador de Pub/Sub que invoque una compilación cuando una imagen coincida con una etiqueta configurada por un filtro personalizado. Si no estás familiarizado con Container Registry, consulta la Guía de inicio rápido de Container Registry a fin de obtener información sobre cómo enviar y extraer imágenes con etiquetas.

Console

Para crear un activador que detecte un envío de una imagen en Container Registry y que coincida con un nombre de etiqueta mediante Google Cloud Console, sigue estos pasos:

  1. Abrir la página Activadores:

    Abrir la página Activadores

  2. Selecciona el proyecto en la parte superior de la página y haz clic en Abrir.

  3. Haz clic en Crear activador.

  4. Ingresa las siguientes opciones de configuración del activador:

    • Nombre: Ingresa un nombre para el activador.
    • Descripción (opcional): Ingresa una descripción para el activador.
    • Evento: Selecciona Mensaje de Pub/Sub como el evento para invocar el activador.
    • Suscripción: Selecciona el tema de Pub/Sub al que deseas suscribirte como evento de activación. Verás todos los temas existentes en el proyecto en el menú desplegable.

    • Fuente: Selecciona el repositorio que se compilará cuando se ejecute el activador.

    • Revisión: Selecciona la rama o etiqueta que se compilará cuando se ejecute el activador manual.

      • Rama: Ingresa el nombre de la rama en la que se invocará tu compilación.
      • Tag: Ingresa el nombre de la etiqueta para invocar tu compilación.
    • Configuración: Selecciona el archivo de configuración de compilación (ubicado en el repositorio remoto) o crea un archivo de configuración de compilación intercalado para usar en tu compilación.

      • Type: Selecciona el tipo de configuración que se usará para tu compilación.
        • Archivo de configuración de Cloud Build (YAML o JSON): Usa un archivo de configuración de compilación para la configuración.
        • Dockerfile: Usa Dockerfile para la configuración.
        • Buildpacks: Usa buildpacks para la configuración.
      • Ubicación: Especifica la ubicación para tu configuración.

        • Repositorio Si el archivo de configuración se encuentra en el repositorio remoto, proporciona la ubicación de tu archivoarchivo de configuración de la compilación , elDockerfile o al directorio de paquetes de compilación. Si tu tipo de configuración de compilación es Dockerfile o un paquete de compilación, deberás proporcionar un nombre para la imagen resultante y, opcionalmente, un tiempo de espera para tu compilación. Cuando hayas proporcionado el nombre de la imagen de Dockerfile o del paquete de compilación, obtendrás una vista previa del comando docker build o pack que ejecutará la compilación.
        • Variables de entorno del paquete de compilación Si seleccionastebuildpacks Como tipo de configuración, haz clic enAgregar variable de entorno de paquete para especificar las variables y los valores del entorno de compilación del paquete. Para obtener más información sobre las variables de entorno de compilación, consulta Variables de entorno.
        • Intercalada: Si seleccionaste archivo de configuración de Cloud Build (YAML o JSON) como opción de configuración, puedes especificar la configuración de compilación intercalada. Haz clic en Abrir editor para abrir tu archivo de configuración de compilación en Google Cloud Console mediante la sintaxis YAML o JSON. Haz clic en Listo para guardar la configuración de tu compilación.

    • Sustituciones Si seleccionaste el archivo de configuración de compilación como tu opción de configuración de compilación, puedes definir Variables de sustitución de un activador específico mediante este campo.

      En el siguiente ejemplo, queremos obtener el nombre de la etiqueta de imagen a partir de la carga útil y la acción asociada con el evento gcr. Para ello, crea variables de sustitución con vinculaciones de carga útil.

      Especifique las siguientes variables y valores a continuación:

      Nombre de la variable Valor de la variable
      _IMAGE_TAG $(body.message.data.tag)
      _ACTION $(body.message.data.action)

      body.message hace referencia al PubSubMessage publicado por los publicadores y consumido por los suscriptores. Para ver más ejemplos de la carga útil de notificaciones de Pub/Sub, consulta Ejemplos de notificación.

    • Filtros (opcional): Puedes crear filtros dentro de un activador que determinen si el activador ejecutará o no una compilación en respuesta a la carga útil entrante. Para ello, especifica filtros en las variables de sustitución. La expresión de filtro se debe evaluar como true para que se ejecute una compilación.

      Recomendamos usar filtros cuando configures activadores de Pub/Sub en temas con varios mensajes. Los filtros se pueden usar para controlar con precisión las compilaciones que se ejecutan en respuesta a los mensajes entrantes de Pub/Sub. Para obtener información sobre los riesgos asociados con la configuración de un activador sin filtros, consulta Riesgos asociados con un activador sin filtrar.

      En el siguiente ejemplo, queremos que el activador ejecute una compilación si el nombre de la variable de etiqueta _IMAGE_TAG coincide con un nombre de etiqueta específico, como prod. Puedes especificar tu operador de condición de filtro como "==" para una concordancia exacta. También puedes verificar la acción asociada con tu evento gcr. Por ejemplo, es posible que desees especificar _ACTION es INSERT para buscar datos recién agregados.

      Especifique lo siguiente como filtros:

      • _IMAGE_TAG == prod
      • _ACTION == INSERT

      La sintaxis de filtro en activadores de Pub/Sub usa Common Expression Language (CEL) para la evaluación de expresiones. Para obtener más información sobre CEL, consulta el repositorio cel-spec. Para ver más ejemplos de sintaxis de filtros que puedes aplicar a tus activadores de Pub/Sub, consulta Filtra compilaciones de compilaciones.

  1. Haz clic en Crear para crear el activador.
  2. .

gcloud

Para crear un activador que detecte el envío de una imagen en Container Registry y que coincida con un nombre de etiqueta, usa los comandos gcloud:

  1. Abre una ventana de terminal.
  2. Ejecuta el comando gcloud alpha para crear un activador de compilación en tu proyecto. En el siguiente ejemplo, el activador está configurado para responder a las compilaciones con una coincidencia de etiquetasprod y una acción coincidenteINSERT según la carga útil especificada como lo define la variable de sustitución,_IMAGE_TAG ,

     gcloud alpha builds triggers create pubsub \
       --name=TRIGGER_NAME \
       --topic=projects/PROJECT_ID/topics/TOPIC_NAME \
       --build-config=BUILD_CONFIG \ # or --inline-config=INLINE_BUILD_CONFIG
       --substitutions=\
         _IMAGE_TAG_='$(body.message.data.tag)'
         _ACTION='$(body.message.data.action)'
       --filter='_IMAGE_TAG == "prod" && _ACTION == "INSERT"'
       --repo=REPO_NAME
       --tag=TAG_NAME  # or --branch=BRANCH_NAME
    

    Aquí:

    • TRIGGER_NAME es el nombre del activador.
    • PROJECT_ID es el ID de tu proyecto de Cloud.
    • TOPIC_NAME es el nombre del tema de Pub/Sub al que te suscribiste.
    • BUILD_CONFIG es la ruta de acceso al archivo de configuración de compilación.
    • INLINE_BUILD_CONFIG es la ruta de acceso a tu archivo de configuración de compilación intercalado.
    • REPO_NAME es el nombre del repositorio de origen en el que se invoca la compilación.
    • TAG_NAME es el nombre de tu etiqueta si deseas configurar el activador para que se compile en una etiqueta.
    • BRANCH_NAME es el nombre de tu rama si deseas configurar el activador para que se compile en una rama.

Crea un activador de compilación que responda a los eventos de Cloud Storage

Puedes crear un activador de Pub/Sub que responda a los eventos de Cloud Storage, como cuando se envía un nuevo objeto binario a un bucket de almacenamiento existente. En esta sección, se explica cómo puedes crear un activador de Pub/Sub que responda con una compilación cuando se implementa un nuevo objeto binario en un bucket subido. Si no estás familiarizado con Cloud Storage, consulta las Guías de inicio rápido.

Console

Para crear un activador que escuche los eventos de Cloud Storage mediante Google Cloud Console, sigue estos pasos:

  1. Abrir la página Activadores:

    Abrir la página Activadores

  2. Selecciona el proyecto en la parte superior de la página y haz clic en Abrir.

  3. Haz clic en Crear activador.

  4. Ingresa las siguientes opciones de configuración del activador:

    • Nombre: Ingresa un nombre para el activador.
    • Descripción (opcional): Ingresa una descripción para el activador.
    • Evento: Selecciona Mensaje de Pub/Sub como el evento para invocar el activador.
    • Suscripción: Selecciona el tema de Pub/Sub al que deseas suscribirte como evento de activación. Verás todos los temas existentes en el proyecto en el menú desplegable.

    • Fuente: Selecciona el repositorio que se compilará cuando se ejecute el activador.

    • Revisión: Selecciona la rama o etiqueta que se compilará cuando se ejecute el activador manual.

      • Rama: Ingresa el nombre de la rama en la que se invocará tu compilación.
      • Tag: Ingresa el nombre de la etiqueta para invocar tu compilación.
    • Configuración: Selecciona el archivo de configuración de compilación (ubicado en el repositorio remoto) o crea un archivo de configuración de compilación intercalado para usar en tu compilación.

      • Type: Selecciona el tipo de configuración que se usará para tu compilación.
        • Archivo de configuración de Cloud Build (YAML o JSON): Usa un archivo de configuración de compilación para la configuración.
        • Dockerfile: Usa Dockerfile para la configuración.
        • Buildpacks: Usa buildpacks para la configuración.
      • Ubicación: Especifica la ubicación para tu configuración.

        • Repositorio Si el archivo de configuración se encuentra en el repositorio remoto, proporciona la ubicación de tu archivoarchivo de configuración de la compilación , elDockerfile o al directorio de paquetes de compilación. Si tu tipo de configuración de compilación es Dockerfile o un paquete de compilación, deberás proporcionar un nombre para la imagen resultante y, opcionalmente, un tiempo de espera para tu compilación. Cuando hayas proporcionado el nombre de la imagen de Dockerfile o del paquete de compilación, obtendrás una vista previa del comando docker build o pack que ejecutará la compilación.
        • Variables de entorno del paquete de compilación Si seleccionastebuildpacks Como tipo de configuración, haz clic enAgregar variable de entorno de paquete para especificar las variables y los valores del entorno de compilación del paquete. Para obtener más información sobre las variables de entorno de compilación, consulta Variables de entorno.
        • Intercalada: Si seleccionaste archivo de configuración de Cloud Build (YAML o JSON) como opción de configuración, puedes especificar la configuración de compilación intercalada. Haz clic en Abrir editor para abrir tu archivo de configuración de compilación en Google Cloud Console mediante la sintaxis YAML o JSON. Haz clic en Listo para guardar la configuración de tu compilación.

    • Sustituciones Si seleccionaste el archivo de configuración de compilación como tu opción de configuración de compilación, puedes definir Variables de sustitución de un activador específico mediante este campo.

      En este ejemplo, queremos observar la implementación de un objeto binario nuevo cuando se sube a un bucket. Para obtener estos datos, podemos crear variables de sustitución con vinculaciones de carga útil.

      Especifique las siguientes variables y valores a continuación:

      Nombre de la variable Valor de la variable
      _EVENT_TYPE $(body.message.attributes.eventType)
      _BUCKET_ID $(body.message.attributes.bucketId)
      _OBJECT_ID $(body.message.attributes.objectId)

      body.message hace referencia al PubSubMessage publicado por los publicadores y consumido por los suscriptores. Para ver más ejemplos de la carga útil de notificaciones de Pub/Sub, consulta Ejemplos de notificación.

    • Filtros (opcional): Puedes crear filtros dentro de un activador que determinen si el activador ejecutará o no una compilación en respuesta a la carga útil entrante. Para ello, especifica filtros en las variables de sustitución. La expresión de filtro se debe evaluar como true para que se ejecute una compilación.

      Recomendamos usar filtros cuando configures activadores de Pub/Sub en temas con varios mensajes. Los filtros se pueden usar para controlar con precisión las compilaciones que se ejecutan en respuesta a los mensajes entrantes de Pub/Sub. Para obtener información sobre los riesgos asociados con la configuración de un activador sin filtros, consulta Riesgos asociados con un activador sin filtrar.

      Como queremos que el activador ejecute una compilación si el objeto binario nuevo se implementó en un bucket específico, podemos usar el operador “==” para buscar coincidencias exactas. También puedes usar la palabra clave “coincidentes” si quieres hacer coincidir por expresiones regulares.

      Especifique lo siguiente como filtros:

      • _EVENT_TYPE == OBJECT_FINALIZE
      • _OBJECT_ID coincide con ^<object-id>$
      • _BUCKET_ID coincide con ^<bucket-id>$
  1. Haz clic en Crear para crear el activador.
  2. .

gcloud

Para crear un activador de compilación que escuche los eventos de compilación con un tipo de evento específico en Cloud Storage, sigue estos pasos:

  1. Abre una ventana de terminal.
  2. Ejecuta el comando gcloud alpha para crear un activador de compilación en tu proyecto. En el siguiente ejemplo, el activador está configurado para responder a las compilaciones con un evento de Cloud Storage asociado con un objeto binario nuevo enviado a un bucket de almacenamiento existente:

     gcloud alpha builds triggers create pubsub \
       --name=TRIGGER_NAME \
       --topic=projects/PROJECT_ID/topics/TOPIC_NAME \
       --build-config=BUILD_CONFIG \ # or --inline-config=INLINE_BUILD_CONFIG
       --substitutions=\
         _EVENT_TYPE='$(body.message.attributes.eventType)'
         _BUCKET_ID='$(body.message.attributes.bucketId)'
         _OBJECT_ID='$(body.message.attributes.objectId)'
       --filter='_EVENT_TYPE == "OBJECT_FINALIZE" && _OBJECT_ID.matches("<object-id>") && _BUCKET_ID.matches("<bucket-id>")'
       --repo=REPO_NAME
       --tag=TAG_NAME  # or --branch=BRANCH_NAME
    

    Aquí:

    • TRIGGER_NAME es el nombre del activador.
    • PROJECT_ID es el ID de tu proyecto de Cloud.
    • TOPIC_NAME es el nombre del tema de Pub/Sub al que te suscribiste.
    • BUILD_CONFIG es la ruta de acceso al archivo de configuración de compilación.
    • INLINE_BUILD_CONFIG es la ruta de acceso a tu archivo de configuración de compilación intercalado.
    • REPO_NAME es el nombre del repositorio de origen en el que se invoca la compilación.
    • TAG_NAME es el nombre de tu etiqueta si deseas configurar el activador para que se compile en una etiqueta.
    • BRANCH_NAME es el nombre de tu rama si deseas configurar el activador para que se compile en una rama.

Riesgos asociados con un activador sin filtrar

Si no configuraste filtros en el activador de Pub/Sub, este podría terminar invocando una cantidad infinita de compilaciones si el activador modifica un artefacto o un objeto que publica un mensaje nuevo en el tema de manera involuntaria que está escuchando. Por ejemplo, el activador puede invocar una cantidad infinita de compilaciones si:

  • Apunta a un tema gcr.
  • Crea cualquier imagen o etiqueta en gcr.
  • Apunta a un tema gcs para un objeto específico de tu bucket y lo modifica.

Si encuentras un bucle infinito, puedes borrar el activador o actualizarlo para que apunte a un tema distinto a fin de evitar que se generen cargos adicionales por cada compilación que invoques.

Usa CEL para filtrar eventos de compilación

Cloud Build usa CEL con la variable, build, en los campos enumerados en el recurso Build para acceder a los campos asociados con el evento de compilación, como el ID del activador, la lista de imágenes o los valores de sustitución. Puedes usar la string filter para filtrar los eventos de compilación en tu archivo de configuración de compilación con cualquier campo enumerado en el recurso compilación. Para encontrar la sintaxis exacta asociada con tu campo, consulta el archivo cloudbuild.proto.

Filtrado por ID de activador

Para filtrar por ID de activador, especifica ese valor en el campo filter mediante build.build_trigger_id, en el que trigger-id es tu ID de activador como una string:

filter: build.build_trigger_id == trigger-id

Cómo filtrar por estado

Para filtrar por estado, especifica el estado de compilación que deseas filtrar en el campo filter mediante build.status.

En el siguiente ejemplo, se muestra cómo filtrar eventos de compilación con un estado SUCCESS mediante el campo filter:

filter: build.status == Build.Status.SUCCESS

También puedes filtrar compilaciones con diferentes estados. En el siguiente ejemplo, se muestra cómo filtrar eventos de compilación que tengan un estado SUCCESS, FAILURE o TIMEOUT mediante el campo filter:

filter: build.status in [Build.Status.SUCCESS, Build.Status.FAILURE, Build.Status.TIMEOUT]

Para ver los valores de estado adicionales por los que puedes filtrar, consulta Estado en la referencia del recurso Compilar.

Filtrado por etiqueta

Para filtrar por etiqueta, especifica el valor de tu etiqueta en el campo filter con build.tags, en el que tag-name es el nombre de tu etiqueta:

filter: tag-name in build.tags

Puedes filtrar según la cantidad de etiquetas especificadas en tu evento de compilación mediante size. En el siguiente ejemplo, el campo filter filtra los eventos de compilación que tienen exactamente dos etiquetas especificadas con una etiqueta especificada como v1:

filter: size(build.tags) == 2 && "v1" in build.tags

Filtrado por imágenes

Para filtrar por imágenes, especifica el valor de la imagen en el campo filter mediante build.images, en el que image-name es el nombre completo de tu imagen, como se muestra en Container Registry, como gcr.io/example/image-one:

filter: image-name in build.images

En el siguiente ejemplo, filter filtra en los eventos de compilación en los que se especificaron gcr.io/example/image-one o gcr.io/example/image-two como nombres de imagen:

filter: "gcr.io/example/image-one" in build.images || "gcr.io/example/image-two" in build.images

Filtrado por tiempo

Puedes filtrar eventos de compilación en función de la hora de creación, de inicio o de finalización de la compilación si especificas una de las siguientes opciones en el campo filter: build.create_time, build.start_time o build.finish_time.

En el siguiente ejemplo, el campo filter usa timestamp con el fin de filtrar los eventos de compilación con un tiempo de solicitud para crear la compilación el 20 de julio de 2020 a las 6:00 a.m.

filter: build.create_time == timestamp("2020-07-20:T06:00:00Z")

También puedes filtrar eventos de compilación por comparaciones de tiempo. En el siguiente ejemplo, el campo filter usa timestamp para filtrar los eventos de compilación con una hora de inicio entre el 20 de julio de 2020 a las 6:00 a.m. y el 30 de julio de 2020 a las 6:00 a.m.

filter: timestamp("2020-07-20:T06:00:00Z") >= build.start_time && build.start_time <= timestamp("2020-07-30:T06:00:00Z")

Si deseas obtener más información sobre cómo se expresan las zonas horarias en CEL, consulta la definición del lenguaje para zonas horarias.

Para filtrar por duración de una compilación, puedes usar duration a fin de comparar marcas de tiempo. En el siguiente ejemplo, el campo filter usa duration para filtrar eventos de compilación con compilaciones que se ejecutan durante al menos cinco minutos:

filter: build.finish_time - build.start_time >= duration("5m")

Filtrado por sustituciones

Para filtrar por sustitución, especifica la variable de sustitución en el campo filter mediante build.substitutions. En el siguiente ejemplo, el campo filter enumera las compilaciones que contienen la variable de reemplazo substitution-variable y verifica si substitution-variable coincide con el substitution-value especificado:

filter: build.substitutions[substitution-variable] == substitution-value

Aquí:

  • substitution-variable es el nombre de tu variable de sustitución.
  • substitution-value es el nombre de tu valor de reemplazo.

También puedes filtrar por valores de variable de sustitución predeterminados. En el siguiente ejemplo, el campo filter enumera las compilaciones que tienen el nombre de la rama master y las compilaciones que tienen el nombre del repositorio github.com/user/my-example-repo. Las variables de reemplazo predeterminadas BRANCH_NAME y REPO_NAME se pasan como claves a build.substitutions:

filter: build.substitutions["BRANCH_NAME"] == "master" && build.substitutions["REPO_NAME"] == "github.com/user/my-example-repo"

Si deseas filtrar en strings mediante expresiones regulares, puedes usar la función integrada matches. En el siguiente ejemplo, el campo filter filtra las compilaciones con un estado de FAILURE o TIMEOUT, y que también tiene una variable de sustitución de compilación TAG_NAME con un valor que coincide con la expresión regular. v{DIGIT}.{DIGIT}.{3 DIGITS}).

filter: build.status in [Build.Status.FAILURE, Build.Status.TIMEOUT] && build.substitutions["TAG_NAME"].matches("^v\\d{1}\\.\\d{1}\\.\\d{3}$")`

Para ver una lista de valores de sustituciones predeterminadas, consulta Usa sustituciones predeterminadas.

¿Qué sigue?