Compilar repositorios de GitHub Enterprise

Cloud Build te permite crear activadores en una instancia de GitHub Enterprise. En esta página, se explica cómo puedes usar los activadores de GitHub Enterprise para invocar compilaciones en respuesta a confirmaciones o solicitudes de extracción desde una instancia de GitHub Enterprise.

Antes de comenzar

  • Habilita las API de Cloud Build and Secret Manager.

    Habilita las API

Crear un activador de GitHub Enterprise

En esta sección, se explica cómo puedes crear un activador y vincularlo a la instalación de GitHub Enterprise. Si deseas usar los activadores de GitHub Enterprise en una red privada, consulta Compila repositorios desde GitHub Enterprise en una red privada para obtener más instrucciones.

Console

Si quieres aprender a crear activadores con los activadores de GitHub, consulta Crea activadores de GitHub.

API

En la siguiente plantilla JSON, se muestra cómo crear activadores a través de la línea de comandos:

  {
      "filename": "cloudbuild.yaml",
      "name": "trigger-name",
      "description": "trigger-description",
      "github": {
          "push": {
              "branch": ".*",
          },
          "owner": "owner",
          "name": "repo-name",
      "enterprise_config_resource_name": "projects/project-number/githubEnterpriseConfigs/id"
      },
      "include_build_logs": "INCLUDE_BUILD_LOGS_WITH_STATUS"
  }

Donde:

  • trigger-name es el nombre del activador.
  • trigger-description es la descripción del activador.
  • owner es el propietario del repositorio de GitHub.
  • repo-name es el nombre del repositorio de GitHub.
  • project-number es el número del proyecto de Cloud.
  • id es el ID de tu GitHubEnterpriseConfig.
  • _include_build_logs es un campo que puedes especificar para mostrar los registros de compilación de tus repositorios. Esta marca es compatible con las compilaciones de GitHub y los repositorios de GitHub Enterprise.

Ingresa el siguiente comando de curl en tu terminal, en el que project-id es el ID del proyecto de Cloud:

  curl -X POST -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8" https://cloudbuild.googleapis.com/v1/projects/project-id/triggers -d @trigger.json

Ya se creó tu activador.

Uso compartido de datos

Los datos que se envían a GitHub Enterprise desde Cloud Build te permiten identificar activadores por su nombre y ver los resultados de las compilaciones en GitHub Enterprise.

Actualmente, los siguientes datos se comparten entre Cloud Build y GitHub Enterprise:

  • ID del proyecto de nube
  • Nombre del activador
  • Registros de compilaciones

Si creaste activadores antes de agosto de 2020, es posible que el uso compartido de datos no esté habilitado para tu proyecto. Puedes habilitar el uso compartido de datos para todos los activadores de GitHub Enterprise del proyecto si haces clic en Habilitar en la pestaña Uso compartido de datos de Cloud Build.

Si tienes las verificaciones de estado obligatorias habilitadas para un repositorio de GitHub Enterprise, habilitar el uso compartido de datos puede interrumpir temporalmente las verificaciones de estado. Puedes ajustar la configuración de la verificación de estado para buscar el nombre de tu activador de la siguiente manera:

  • Inhabilita cualquier verificación necesaria específica de Cloud Build en el repositorio de GitHub.
  • Asegúrate de que el uso compartido de datos esté habilitado en Cloud Build.
  • Ejecuta una compilación nueva en Cloud Build que publique estados en tu repositorio.
  • Vuelve a habilitar las verificaciones de estado necesarias y selecciona el nombre del activador.

Próximos pasos