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.
- Sigue las instrucciones para conectar un host de GitHub Enterprise.
- Sigue las instrucciones para conectar un repositorio de GitHub Enterprise.
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
- Obtén más información sobre cómo crear y administrar activadores.
- Obtén más información para compilar repositorios desde GitHub Enterprise en una red privada.