Compilar repositorios de GitHub Enterprise

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

Crea un activador de GitHub Enterprise

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

Console

Para obtener información sobre cómo crear activadores con los activadores de GitHub, consulta Crea activadores de GitHub.

API

En la siguiente plantilla JSON, se muestra cómo crear activadores mediante 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 una 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.
  • [OPCIONAL] _include_build_logs es un campo que puedes especificar a fin de mostrar registros de compilación para los repositorios. Esta marca es compatible con compilaciones de repositorios de GitHub y GitHub Enterprise.

Ingresa el siguiente comando curl en la 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

Se creó el activador.

Uso compartido de datos

Los datos enviados a GitHub Enterprise desde Cloud Build te ayudan a identificar activadores por nombre y a ver los resultados de la compilación en GitHub Enterprise.

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

  • 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, la habilitación del 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