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 ejecutar 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 ejecutas 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 ejecutar 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 Invocació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 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.

  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 ejecutar tu compilación.

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

Próximos pasos