Conéctate a un host de GitHub Enterprise

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

En esta página, se explica cómo conectar un host de GitHub Enterprise a Cloud Build.

Antes de comenzar

  • Habilita las API de Cloud Build and Secret Manager.

    Habilita las API

Permisos de IAM obligatorios

Para conectar tu host de GitHub Enterprise, otorga la función de editor de Cloud Build (roles/cloudbuild.builds.editor) y propietario de integraciones de Cloud Build (cloudbuild.integrations.owner) a tu cuenta de usuario.

Para agregar las funciones necesarias a tu cuenta de usuario, consulta Configura el acceso a los recursos de Cloud Build. Para obtener más información sobre las funciones de IAM asociadas con Cloud Build, consulta Funciones y permisos de IAM.

Conéctate a un host de GitHub Enterprise

Debes crear una aplicación de GitHub en tu instancia de GitHub Enterprise. La aplicación envía eventos de webhook a un extremo de Cloud Build. Cuando se reciben estos eventos, Cloud Build validará la carga útil y ejecutará una compilación si el evento corresponde a un activador de GitHub de Cloud Build.

En esta sección, se explica cómo puedes crear una app de GitHub:

  1. Accede a tu instancia de GitHub Enterprise.
  2. Asegúrate de tener instalada la versión más reciente de GitHub Enterprise.

    Algunas versiones de GitHub Enterprise pueden requerir que se inhabiliten las cookies de SameSite para completar los siguientes pasos en un navegador Chrome. Si tienes una versión de GitHub Enterprise anterior a la versión 2.21.3, deberás inhabilitar las cookies de SameSite:

    1. Ve a chrome://flags/.
    2. Escribe samesite en la barra de filtros.
    3. Asegúrate de que las cookies predeterminadas de SameSite estén inhabilitadas.

      Captura de pantalla de SameSite inhabilitada

    4. Reinicia el navegador.

  3. Abre la página Administrar repositorios de Cloud Build:

    Abrir la página Administrar repositorios

  4. Haz clic en Conectar host.

    Verás el panel Conectar host, que te pedirá que crees una conexión de host para conectar tus repositorios de GitHub Enterprise a Cloud Build.

  5. En la sección URL del host, ingresa la URL de tu instancia de GitHub Enterprise. Por ejemplo, ghe.example.com

  6. En la sección Clave de API, haz clic en Generar para generar una clave de API o ingresa una clave de API si ya tienes una.

    Si deseas crear una clave de API de forma manual, completa el siguiente paso:

    Para obtener una clave de API, haz lo siguiente:

    1. Abre la página Credenciales en Cloud Console:

      Abre la página Credenciales.

    2. Haz clic en Crear credenciales.

    3. Haga clic en Clave de API.

      Verás un cuadro emergente con tu clave de API creada.

    4. Haz clic en Restringir clave.

    5. En Restricciones de API, selecciona API de Cloud Build en el menú desplegable.

    6. Haz clic en Guardar.

  7. [OPCIONAL] En la sección Organización, ingresa la organización para la que se creará la app de GitHub. Si esta sección se deja en blanco, la app se creará con la cuenta de usuario actual.

  8. [OPCIONAL] En la sección Certificado de CA, haz clic en Explorar para subir tu certificado autofirmado. El certificado no debe superar los 10 KB y debe estar en formato PEM (.pem, .cer o .crt). Si esta sección se deja en blanco, se usará un conjunto predeterminado de certificados.

  9. [OPCIONAL] En la sección Red, ingresa el nombre de tu Proyecto de red y un Nombre de red para tu red si tu instancia de GitHub Enterprise está alojada en una red privada. Debes completar este paso si deseas compilar repositorios en una red privada. Para obtener más información, consulta Compila repositorios desde GitHub Enterprise en una red privada.

  10. Haz clic en Conectar host.

    Si tu instancia de GitHub Enterprise se encuentra en una red privada, el proceso de conexión del host puede tardar varios minutos en completarse.

  11. Si deseas conectar tus repositorios a Cloud Build, haz clic en Conectar repositorios. De lo contrario, haga clic en Listo.

  12. Después de conectar el host, aparecerá un cuadro emergente que te pedirá que ingreses el nombre de la app de GitHub Enterprise. Antes de ingresar el nombre de la app, es posible que se te solicite acceder. Si usas Google Chrome como navegador, es posible que en la página emergente se te solicite que ingreses información sobre la app de GitHub Enterprise de forma manual.

  13. Después de acceder, ingresa un nombre para tu app de GitHub.

  14. Haz clic en Crear app de GitHub.

    Acabas de crear una app de GitHub en tu instancia de GitHub Enterprise. Cloud Build almacenará tus credenciales automáticamente en Secret Manager y conectará el host a tu proyecto de Cloud. En la API, esta conexión se representa como un recurso de GitHubEnterpriseConfig o una asociación entre Cloud Build y tu servidor de GitHub Enterprise.

    El host ahora está conectado correctamente. Puedes hacer clic en Conectar repositorios si deseas conectar repositorios a Cloud Build. Para obtener más información, consulta Conéctate a un repositorio de GitHub Enterprise.

Próximos pasos