Conectarse a un host de GitHub Enterprise

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 la función de 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.

Conectarse a un host de GitHub Enterprise

Debes crear una aplicación de GitHub en tu instancia de GitHub Enterprise. La app 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 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 solicita que crees una conexión de host para conectar los 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. Haz clic en Clave de API.

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

    4. Haz clic en Restringir clave.

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

    6. Haz clic en Guardar.

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

  8. En la sección CA Certificate, haz clic en Browse para subir tu certificado autofirmado (opcional). El certificado no debe superar los 10 KB y debe tener el formato PEM (.pem, .cer o .crt). Si esta sección se deja en blanco, se utilizará 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 si la instancia de GitHub Enterprise está alojada de forma local y cambiaste la red con Google Cloud.

  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 que conectes tu host, aparecerá un cuadro emergente en el que se te solicitará que ingreses el nombre de tu 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 la página emergente te solicite ingresar 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. Haga clic en Crear aplicación de GitHub.

    Acabas de crear una app de GitHub en tu instancia de GitHub Enterprise. Cloud Build almacenará de forma automática tus credenciales 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 como una asociación entre Cloud Build y tu servidor de GitHub Enterprise.

    El host se conectó correctamente. Puedes hacer clic en Conectar repositorios si deseas conectar repositorios a Cloud Build. Para obtener más información, consulta Cómo conectarse a un repositorio de GitHub Enterprise.

Próximos pasos