Crea activadores manuales

En esta página, se explica cómo crear activadores manuales. Los activadores manuales se pueden usar para invocar compilaciones de forma manual, con la capacidad de anular valores de variables de sustitución definidos en el momento de la invocación antes de ejecutar una compilación. También puedes programar activadores manuales para que se ejecuten de forma automática a una hora específica.

Para obtener información para iniciar las compilaciones de forma manual con la herramienta de línea de comandos de gcloud o la API de Cloud Build, consulta Inicia las compilaciones de forma manual.

Antes de comenzar

  • Habilita la API Cloud Build.

    Habilita la API

  • Ten listo tu código fuente.

Activadores manuales

Los activadores manuales te permiten configurar compilaciones que solo se ejecutan cuando invocas el activador en repositorios conectados. Supongamos que creas una canalización para implementar tu código fuente en un entorno de etapa de pruebas o de producción. Es posible que desees automatizar el flujo de trabajo, pero solo deseas invocar compilaciones de forma manual. Puedes definir activadores manuales para hacerlo.

Los activadores manuales te permiten invocar de forma manual las compilaciones de la siguiente manera:

  • Recupera el código fuente de un repositorio alojado con una rama o etiqueta específica.
  • Parametrizar tu compilación con sustituciones que no necesitan pasarse de forma manual cada vez que invocas una compilación.
  • Anula los valores de variables de sustitución definidos en el momento de la invocación antes de invocar una compilación.

Para invocar compilaciones desde el directorio de trabajo local en lugar de un repositorio alojado o si deseas enviar compilaciones sin crear un activador, puedes ejecutar el siguiente comando de gcloud en tu directorio de trabajo:

gcloud builds submit --config build-config source-code

Aquí:

  • build-config es la ruta de acceso al archivo de configuración de compilación.
  • source-code es la ruta de acceso o URL del código fuente.

Si deseas obtener más información para usar el comando gcloud a fin de iniciar compilaciones de forma manual en tu directorio local, consulta Inicia compilaciones de forma manual.

Crea activadores manuales

Para crear un activador manual, haz lo siguiente:

  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: un nombre para tu activador
    • Descripción (opcional): Una descripción para tu activador
    • Cuándo: Selecciona Ejecución manual para configurar el activador de modo que las compilaciones solo se ejecuten cuando se invoque de forma manual.
    • Fuente: Selecciona el repositorio que se compilará cuando se ejecute el activador manual.
    • Revisión: Selecciona la rama o etiqueta que se compilará cuando se ejecute el activador manual.
      • Rama: Configura un activador a fin de compilarlo en esta rama. Debes especificar un valor literal. Por el momento, no se admiten las expresiones regulares.
      • Etiqueta: Configura un activador para compilar en esta etiqueta. Debes especificar un valor literal. Por el momento, no se admiten las expresiones regulares.
    • Configuración: Selecciona el archivo de configuración de compilación ubicado en tu repositorio remoto o crea un archivo de configuración de compilación intercalado para usarlo en tu compilación.

      • Tipo: selecciona el tipo de configuración que se usará para la 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 un Dockerfile para la configuración.
      • Ubicación: especifica la ubicación de la configuración.

        • Repositorio Si tu archivo de configuración está ubicado en tu repositorio remoto, proporciona la ubicación de laarchivo de configuración de compilación o elDockerfile y un nombre para la imagen resultante. Si tu configuración es una Dockerfile, puedes proporcionar un tiempo de espera opcional para tu compilación. Cuando hayas proporcionado el Dockerfile y el nombre de la imagen, verás una vista previa del comando docker build que se ejecutará en la compilación.
        • En línea: Si seleccionaste Archivo de configuración de Cloud Build (yaml o json) como tu opción de configuración, puedes especificar tu 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 con la sintaxis YAML o JSON. Haz clic en Listo para guardar la configuración de compilación.
  5. Haz clic en Crear para crear el activador manual.

Ejecuta activadores manuales

Para ejecutar un activador manual con Google Cloud Console, sigue estos pasos:

  1. Abre la página Activadores en Google Cloud Console.

    Abrir la página Activadores

  2. Ubica tu activador en la lista.

  3. Haz clic en Ejecutar activador.

    Después de hacer clic en Ejecutar activador, verás el panel de la ventana Ejecutar activador del lado derecho. Si especificaste campos como un nombre de rama, un nombre de etiqueta o variables de sustitución, podrás anular estos campos en el momento de la invocación.

    Si especificaste valores variables nuevos para tu sustitución, haz clic en Ejecutar activador a fin de invocar tu compilación.

Para ejecutar activadores manuales según la programación, consulta Programa compilaciones.

Próximos pasos