Compilar código manualmente en repositorios de origen

En esta página se explica cómo crear activadores manuales para compilar código en repositorios de origen. Los activadores manuales se pueden usar para invocar compilaciones manualmente, con la posibilidad de anular los valores de las variables de sustitución definidas 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 a una hora concreta.

Para saber cómo iniciar compilaciones manualmente con la CLI de gcloud o la API Cloud Build, consulta el artículo Iniciar compilaciones manualmente.

Antes de empezar

  • Enable the Cloud Build API.

    Enable the API

  • Ten a mano el código fuente.

Activadores manuales

Los activadores manuales te permiten configurar compilaciones que solo se ejecutan cuando invocas el activador en los repositorios conectados. Supongamos que vas a crear una canalización para desplegar tu código fuente en un entorno de staging o de producción. Puede que quieras automatizar tu flujo de trabajo, pero solo quieras ejecutar compilaciones manualmente. Para ello, puedes definir activadores manuales.

Los activadores manuales te permiten invocar compilaciones manualmente de las siguientes formas:

  • Obtener el código fuente de un repositorio alojado con una rama o una etiqueta especificadas.
  • Parametrizar tu compilación con sustituciones que no necesiten introducirse manualmente cada vez que ejecutes una compilación.
  • Anular los valores de las variables de sustitución definidas en el momento de la invocación antes de invocar una compilación.

Si quieres ejecutar compilaciones desde tu directorio de trabajo local en lugar de desde un repositorio alojado o 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 al archivo de configuración de compilación.
  • SOURCE_CODE es la ruta o el código fuente de la URL.

Para obtener más información sobre cómo usar el comando gcloud para iniciar compilaciones manualmente en tu directorio local, consulta Iniciar compilaciones manualmente.

Crear activadores manuales

Consola

Para crear un activador manual, siga estos pasos:

  1. Abre la página Activadores:

    Abre la página Activadores.

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

  3. Haz clic en Crear activador.

  4. Introduce los siguientes ajustes del activador:

    • Nombre: el nombre del activador.

    • Región: selecciona la región del activador.

      • Si seleccionas global como región, Cloud Build usará el grupo predeterminado para ejecutar la compilación.
      • Si seleccionas una región no global y el archivo de configuración de compilación asociado al activador especifica un grupo privado, Cloud Build usará el grupo privado para ejecutar la compilación. En este caso, la región que especifiques en el activador debe coincidir con la región en la que hayas creado tu grupo privado.
      • Si seleccionas una región que no es global y el archivo de configuración de compilación asociado al activador no especifica un grupo privado, Cloud Build usará el grupo predeterminado para ejecutar la compilación en la misma región que el activador.

    • Descripción (opcional): descripción del activador.

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

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

    • Revisión: selecciona la rama o la etiqueta que se va a compilar cuando se ejecute el activador manual.

    • Rama: configura un activador para compilar en esta rama. Debes especificar un valor literal. Por el momento, no se admiten expresiones regulares.

    • Etiqueta: configura un activador para que compile una versión en esta etiqueta. Debes especificar un valor literal. Por el momento, no se admiten expresiones regulares.

    • Configuración: selecciona el archivo de configuración de compilación que se encuentra en tu repositorio remoto o crea un archivo de configuración de compilación insertado para usarlo en tu compilación.

      • Tipo: selecciona el tipo de configuración que quieras usar en tu compilación.
        • Archivo de configuración de Cloud Build (yaml o json): usa un archivo de configuración de compilación para tu configuración.
        • Dockerfile usa un Dockerfile para tu configuración.

      • Ubicación: especifica la ubicación de la configuración.

        • Repositorio: si el archivo de configuración se encuentra en tu repositorio remoto, indica 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, tendrás que proporcionar un nombre para la imagen resultante y, opcionalmente, un tiempo de espera para la compilación. Cuando hayas proporcionado el nombre de la Dockerfile o de la imagen del buildpack, verás una vista previa del comando docker build o pack que ejecutará tu compilación.
        • En línea: si has seleccionado Archivo de configuración de Cloud Build (yaml o json) como opción de configuración, puedes especificar la configuración de compilación en línea. Haz clic en Abrir editor para escribir el archivo de configuración de la compilación en la Google Cloud consola con la sintaxis YAML o JSON. Haz clic en Hecho para guardar la configuración de compilación.

  5. Haz clic en Crear para crear el activador manual.

gcloud

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

Ejecutar activadores manuales

Consola

Para ejecutar un activador manual mediante la consola Google Cloud :

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

    Abre la página de activadores

  2. Busca el 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 en la parte derecha. Si has especificado campos como el nombre de una rama, el nombre de una etiqueta o variables de sustitución, podrás anular estos campos en el momento de la invocación.

    Si has especificado nuevos valores de variables para la sustitución, haz clic en Ejecutar activador para ejecutar la compilación.

    Para ejecutar activadores manuales según una programación, consulta Programar compilaciones.

gcloud

Para ejecutar un activador manual con la herramienta de línea de comandos 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 de tu activador.
  • BRANCH_NAME es el nombre de tu sucursal. También puedes especificar una etiqueta con --tag o un ID de confirmación con --sha.
  • [Opcional]SUBSTITUTION_VAR es el nombre de la variable del valor de sustitución.
  • [Opcional] SUBSTITUTION_VALUE es el valor asociado a tu variable de sustitución.

Para ejecutar activadores manuales según una programación, consulta Programar compilaciones.

Pasos siguientes