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 actualizaciones manuales para que se ejecuten automáticamente en un momento específico.

Para obtener información para iniciar las compilaciones de forma manual con gcloud CLI o la API de Cloud Build, consulta Inicia las compilaciones de forma manual.

Antes de comenzar

  • Enable the Cloud Build API.

    Enable the 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 deseas enviar compilaciones sin crear un activador, puedes ejecutar el siguiente comando gcloud en el 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

Console

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 tu activador.

      • Si seleccionas la región global, Cloud Build usa la configuración para ejecutar tu compilación.
      • Si seleccionas una región no global y los archivo de configuración de compilación asociado con el activador especifica un grupo privado, Cloud Build usa 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 tu 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 se invoque de forma manual.

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

    • Revisión: Selecciona la rama o etiqueta que deseas compilar cuando se active el activador manual. o en cualquier plataforma que ejecute Knative.

    • 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 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.
        • Intercalado: Si seleccionaste el archivo de configuración de Cloud Build (YAML o JSON) como opción de configuración, puedes especificar la 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 de 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.

gcloud

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

Ejecuta activadores manuales

Console

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 un programa, 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

Aquí:

  • TRIGGER_NAME es el nombre del activador.
  • REGION es la región del activador.
  • BRANCH_NAME es el nombre de tu rama. 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 para tu valor de sustitución.
  • [Opcional] SUBSTITUTION_VALUE es el valor asociado con tu variable de sustitución.

Para ejecutar activadores manuales de forma programada, consulta Programa compilaciones.

Próximos pasos