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 de forma automática a una hora específica.

Para aprender a iniciar compilaciones de forma manual con la CLI de gcloud o la API de Cloud Build, consulta Cómo iniciar 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.

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

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

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 para el activador.

      • Si seleccionas global como 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

    • 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. Nota: La región del repositorio debe coincidir con la región del activador. Si la fuente es un repositorio de Cloud Source Repositories, el repositorio no está conectado a una región en particular, sino a tu proyecto.

    • 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.
        • Paquetes de compilación: Usa paquetes de compilación para tu configuración.
      • Ubicación: Especifica la ubicación de tu configuración.

        • Repositorio: Si tu archivo de configuración se encuentra en tu repositorio remoto, proporciona la ubicación de tu archivo de configuración de compilación, el directorio Dockerfile o el directorio del paquete 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.
        • Variables de entorno de paquete de compilación (opcional): Si seleccionaste buildpacks como el tipo de configuración, haz clic en Agregar variable de entorno del paquete para especificar las variables de entorno y los valores del paquete de compilación. Para obtener más información sobre las variables de entorno del paquete de compilación, consulta Variables de entorno.
        • 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 la compilación de forma intercalada. Haz clic en Abrir editor para escribir tu archivo de configuración de compilación en Google Cloud Console con 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