Crea activadores de aplicaciones de GitHub

Los activadores de aplicaciones de GitHub te permiten activar automáticamente las compilaciones en los envíos de Git y las solicitudes de extracción, y ver los resultados de tu compilación en GitHub y GCP Console. Además, admiten todas las características compatibles con los activadores de GitHub existentes. Los activadores de aplicaciones de GitHub usan la aplicación de GitHub de Cloud Build para configurarse y autenticarse en GitHub.

En esta página, se explica cómo crear activadores de aplicaciones de GitHub.

Crea activadores de aplicaciones de GitHub

En esta sección, se explica cómo instalar la aplicación de GitHub de Cloud Build para conectar tu repositorio de GitHub a tu proyecto de GCP y, luego, crear activadores de aplicaciones de GitHub.

Instala la aplicación de Cloud Build

Para instalar la aplicación de Cloud Build y conectar tu repositorio de GitHub a tu proyecto de GCP, sigue estos pasos:

  1. Abre la página Activadores en Google Cloud Platform Console.

    Abrir la página Activadores

  2. En el selector de proyectos en la barra superior, selecciona tu proyecto de GCP.

  3. Haz clic en Conectar repositorio.

  4. Selecciona GitHub (Aplicación de GitHub de Cloud Build), marca la casilla de verificación de consentimiento y haz clic en Continuar.

  5. (Opcional) Si no accediste a GitHub antes, hazlo ahora.

    Aparece la página de autorización, en la que se te solicita que autorices la conexión de la aplicación de Google Cloud Build a Google Cloud Platform.

    Captura de pantalla del botón para autorizar

    Haz clic en Autorizar a Google Cloud Build a través de GoogleCloudBuild (Authorize Google Cloud Build by GoogleCloudBuild).

  6. Haz clic en Instalar Google Cloud Build.

  7. En la ventana emergente que aparece, selecciona tu organización o nombre de usuario de GitHub.

  8. Selecciona una de las opciones siguientes según la necesidad de tu empresa:

    • Todos los repositorios: Habilita el acceso a todos los repositorios de GitHub actuales y futuros a través de la aplicación de Cloud Build.

    • Solo repositorios seleccionados: Usa el menú desplegable Seleccionar repositorios a fin de habilitar solo repositorios específicos para acceder a través de la aplicación de Cloud Build. Podrás habilitar repositorios adicionales más adelante.

  9. Haz clic en Instalar para instalar la aplicación Cloud Build.

    La ventana emergente se cierra y vuelves a la página Selecciona un repositorio en GCP Console. En esta página, conectarás tus repositorios de GitHub a tu proyecto de GCP.

  10. En la página Selecciona un repositorio que aparece, conecta tus repositorios de GitHub a tu proyecto de GCP de la manera siguiente:

    a. Confirma que se ha seleccionado la cuenta correcta de GitHub.

    b. Selecciona la casilla de verificación junto a cada repositorio de destino.

    c. Lee la renuncia de responsabilidad de consentimiento y selecciona la casilla de verificación junto a la renuncia para indicar que aceptas los términos presentados.

    d. Haz clic en Conectar repositorio.

    Si no encuentras uno o más de tus repositorios de destino, haz clic en Editar repositorios en GitHub y repite los pasos anteriores para habilitar repositorios adicionales en la aplicación de Cloud Build.

  11. (Opcional) Si deseas crear activadores de envío para los repositorios que vas a conectar, seleccione las casillas junto a cada repositorio de destino y haz clic en Crear activadores de envío; de lo contrario, haz clic en Omitir por ahora.

    Ahora has conectado uno o más repositorios de GitHub a tu proyecto de GCP. Se te redireccionará a la página de activadores en GCP Console.

Crea activadores de aplicaciones de GitHub

Para crear activadores de aplicaciones de GitHub, sigue estos pasos:

  1. En la página de activadores, haz clic en Crear activador.

  2. Ingresa las siguientes opciones de configuración del activador:

    • Nombre: un nombre para tu activador

    • Tipo de activador: Selecciona una de las opciones siguientes para el tipo de activador:

      • Rama: Configura un activador a fin de iniciar una compilación a partir de las confirmaciones para esta rama. También puedes especificar una expresión regular con el valor de la rama para que coincida. Para obtener información acerca de la sintaxis de expresión regular aceptable, consulta la sección sobre sintaxis RE2.
      • Etiqueta: Configura un activador para que inicie una compilación a partir de las confirmaciones que contiene esta etiqueta. También puedes especificar una expresión regular con el valor de la etiqueta para que coincida. Para obtener información acerca de la sintaxis de expresión regular aceptable, consulta la sección sobre sintaxis RE2.
      • Solicitud de extracción: Puedes configurar un activador para que inicie una compilación a partir de solicitudes de extracción orientadas a la rama con la que deseas realizar la combinación. Esta es una característica nueva que solo está disponible si creas activadores de aplicaciones de GitHub.
    • Archivos incluidos (opcional): Los cambios en estos archivos activarán una compilación.

    • Archivos ignorados (opcional): Los cambios en estos archivos no activarán una compilación.

      Para obtener más información sobre los archivos incluidos y los archivos ignorados, consulta Automatiza compilaciones con activadores de compilación.

    • Configuración de compilación: Es el Dockerfile o el archivo de configuración de compilación (ubicado en el repositorio de GitHub conectado a este proyecto de GCP) que se usa en cada compilación que inicie el activador.

      Si deseas usar un Dockerfile en la configuración de tu compilación, deberás especificar el directorio del Dockerfile y proporcionar un nombre para la imagen resultante.

      Una vez que hayas proporcionado el Dockerfile y el nombre de la imagen, obtendrás una vista previa del comando docker build que ejecutará tu compilación y un resumen de la configuración del activador. Haz clic en Crear activador para guardar el activador de la compilación.

      Si deseas usar un archivo de configuración para tu compilación, deberás proporcionar la ubicación de un archivo de configuración de compilación y, opcionalmente, las variables de sustitución que deseas usar.

      Una vez que hayas establecido la ubicación, verás un resumen del activador. Haz clic en Crear activador para guardar el activador de compilación.

Ahora creaste un activador de la aplicación de GitHub.

Diferentes tipos de activadores basados en GitHub

Si tu código fuente está en GitHub, Cloud Build ofrece dos maneras de activar automáticamente tus compilaciones. En esta sección, se explican los dos activadores basados en GitHub y se comparan sus características.

  • Activadores de GitHub: Cuando creas un activador de GitHub, Cloud Build duplica tu repositorio de GitHub en Cloud Source Repositories y usa el repositorio duplicado para todas sus operaciones. Puedes crear y administrar activadores de GitHub con GCP Console.

  • Activadores de aplicaciones de GitHub: Este tipo de activador usa la aplicación de GitHub de Cloud Build para configurarse y autenticarse en GitHub. Los activadores de aplicaciones de GitHub te permiten activar automáticamente las compilaciones en los envíos de Git y las solicitudes de extracción, y ver los resultados de tu compilación en GitHub y GCP Console. Puedes crear y administrar activadores de aplicaciones de GitHub con GCP Console o la API de Cloud Build.

En la tabla siguiente, se comparan las características de los activadores de GitHub y los activadores de aplicaciones de GitHub:

Característica Activadores de GitHub Activadores de aplicaciones de GitHub
Activar compilaciones a partir de envíos al código fuente
Activar compilaciones a partir de solicitudes de extracción No
Crear activador con GCP Console
Crear activador con la API de Cloud Build No
Crear activador con la aplicación de GitHub de Cloud Build No
Ver el estado de la compilación en GCP Console
Ver el estado de la compilación en GitHub No

Pasos siguientes