Compila código de forma manual en repositorios de código fuente

En esta página, se explica cómo crear activadores manuales para compilar código en repositorios de código fuente. 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 automáticamente en un momento específico.

Para aprender a iniciar compilaciones de forma manual con gcloud CLI o la API de Cloud Build, consulta Inicia compilaciones de forma manual.

Antes de comenzar

  • Habilita la API de 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.

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

gcloud builds submit --config BUILD_CONFIG SOURCE_CODE

Donde:

  • 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

Consola

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
    • Región: Selecciona la región de tu activador.

      • Si seleccionas global como la región, Cloud Build usa el grupo predeterminado para ejecutar tu compilación.
      • Si seleccionas una región no global y el archivo de configuración de compilación asociado con el activador especifica un grupo privado, Cloud Build usa el grupo privado para ejecutar tu compilación. En este caso, la región que especifiques en el activador debe coincidir con la región en la que creaste el grupo privado.
      • Si seleccionas una región no global y el archivo de configuración de compilación asociado con el activador no especifica un grupo privado, Cloud Build usa el grupo predeterminado para ejecutar la compilación en la misma región que el activador.
    • Descripción (opcional): Una descripción para tu activador

    • Evento: Selecciona Invocación manual para configurar el activador, de modo que las compilaciones solo se ejecuten cuando el activador se invoque de forma manual.

    • Fuente: Selecciona el repositorio que se compilará cuando se ejecute el activador manual. Puedes especificar 1a generación o 2a generación como fuente.

    • 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 usarás 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 Dockerfile para la configuración.
      • Ubicación: Especifica la ubicación de tu configuración.

        • Repositorio: Si el archivo de configuración se encuentra en el repositorio remoto, proporciona la ubicación del archivo de configuración de compilación, el directorio Dockerfile o el directorio de paquetes de compilación. Si el 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, de forma opcional, un tiempo de espera para tu compilación. Cuando proporciones el Dockerfile o el nombre de la imagen del paquete de compilación, verás una vista previa del comando docker build o pack que ejecutará tu compilación.
        • Intercalada: 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 de forma intercalada. Haz clic en Abrir editor para escribir tu archivo de configuración de compilación en la consola de Google Cloud con la sintaxis YAML o JSON. Haz clic en Done para guardar la configuración de la compilación.
  5. Haz clic en Crear para crear el activador manual.

gcloud

Para obtener una lista completa de las marcas, consulta la referencia de gcloud sobre cómo crear activadores manuales.

Ejecuta activadores manuales

Consola

Para ejecutar un activador manual con la consola de Google Cloud, sigue estos pasos:

  1. Abre la página Activadores en la consola de Google Cloud.

    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 lo programado, consulta Programa compilaciones.

gcloud

Para ejecutar un activador manual con la herramienta de línea de comandos de gcloud, ejecuta el siguiente comando:

      gcloud builds triggers run TRIGGER_NAME \
         --region=REGION \
         --branch=BRANCH_NAME \
         --substitutions=SUBSTITUTION_VAR=SUBSTITUTION_VALUE

Donde:

  • TRIGGER_NAME es el nombre del activador.
  • REGION es la región del activador.
  • BRANCH_NAME es el nombre de la rama. También puedes especificar una etiqueta con --tag o un ID de confirmación con --sha.
  • [Opcional]SUBSTITUTION_VAR es el nombre de variable para tu valor de sustitución.
  • [Opcional] SUBSTITUTION_VALUE es el valor asociado con tu variable de sustitución.

Para ejecutar activadores manuales según el programa, consulta Programa compilaciones.

Próximos pasos