Habilitación de GitHub Connect para GHE.com

Habilite GitHub Connect para compartir datos entre GHE.com y tu instancia de GitHub Enterprise Server.

En este artículo

Puede acceder a características y flujos de trabajo adicionales en tu instancia de GitHub Enterprise Server habilitando GitHub Connect. Consulta Acerca de GitHub Connect.

Si se conecta a una empresa en GHE.com:

  • Las estadísticas del servidor no están disponibles.
  • GitHub.com las acciones no están disponibles.

¿Qué ocurre cuando GitHub Connect está habilitado?

Cuando habilitas GitHub Connect, configuras una conexión entre tu instancia de GitHub Enterprise Server y una cuenta empresarial en GitHub Enterprise Cloud. La conexión usa HTTPS a través de los puertos 443 o 80 y está protegido por TLS.

El habilitar GitHub Connect crea una GitHub App que pertenece a la cuenta empresarial de GitHub Enterprise Cloud. GitHub Enterprise Server usa las credenciales de GitHub App para hacerle solicitudes a GitHub Enterprise Cloud.

GitHub Enterprise Server almacena credenciales desde la GitHub App. Las siguientes credenciales se replicarán en todos los nodos en un ambiente de clúster o de disponibilidad alta y se almacenarán en cualquier respaldo, incluyendo las capturas de pantalla que crea GitHub Enterprise Server Backup Utilities.

  • Un token de autenticación, que es válido durante una hora
  • Una clave privada, que se utiliza para generar un nuevo token de autenticación

Requisitos previos

  • Acceso administrativo: Necesita acceso administrativo a una cuenta empresarial en GHE.com y a una GitHub Enterprise Server instancia.

  • Requisito de versión: La GitHub Enterprise Server instancia debe ejecutar GitHub Enterprise Server la versión 3.12 o posterior.

  • Configuración del proxy: Si usa un servidor proxy, permita la conectividad a los siguientes GHE.com nombres de host (reemplace SUBDOMAIN por el subdominio de la empresa).

    • SUBDOMAIN.ghe.com
    • api.SUBDOMAIN.ghe.com
    • uploads.SUBDOMAIN.ghe.com

    Consulta Configuración de un servidor proxy web de salida.

Paso 1: Habilitación de la conexión a GHE.com

De forma predeterminada, GitHub Connect se conecta GitHub Enterprise Server a GitHub.com. Debe habilitar su instancia para conectarse al subdominio de su empresa en GHE.com.

Para habilitar la conexión, alguien con acceso SSH administrativo a tu instancia de GitHub Enterprise Server debe completar las siguientes tareas.

  1. SSH en tu instancia de GitHub Enterprise Server Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Reemplace HOSTNAME por el nombre de host de la instancia, o el nombre de host o la dirección IP de un nodo. Para más información, consulta Acceder al shell administrativo (SSH).

    Shell
    ssh -p 122 admin@HOSTNAME

  2. Para permitir que la instancia se conecte a GHE.com para GitHub Connect, ejecute el siguiente comando. Reemplace SUBDOMAIN por el subdominio de su empresa en GHE.com, por ejemplo octocorp.

    Shell
    ghe-config app.github.github-connect-ghe-com-enabled true
ghe-config app.github.github-connect-ghe-com-subdomain "SUBDOMAIN"

  3. Para aplicar la configuración, ejecuta el siguiente comando.

    Nota:

    Durante una ejecución de configuración, los servicios en tu instancia de GitHub Enterprise Server pueden reiniciarse, lo que puede provocar un breve tiempo de inactividad para los usuarios.

    Shell
    ghe-config-apply

Una vez completada la ejecución, puede configurar GitHub Connect.

Paso 2: Habilitar GitHub Connect

Para habilitar GitHub Connect, debe ser propietario de la empresa en GitHub Enterprise Server y GitHub Enterprise Cloud.

Las personas con una cuenta de usuario en ambos entornos pueden conectar las cuentas desde tu instancia de GitHub Enterprise Server.

  1. Inicie sesión en tu instancia de GitHub Enterprise Server y GHE.com.

  2. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Enterprise settings.

  3. En la parte superior de la página, haga clic en GitHub Connect.

  4. En "GitHub Connect aún no está habilitado", haga clic en Habilitar GitHub Connect . Al hacer clic en Habilitar GitHub Connect, aceptas Términos de GitHub para productos y funciones adicionales.

  5. A la derecha de la cuenta empresarial a la que quieres conectarte, haz clic en Conectar.

  6. Elija qué características individuales de GitHub Connect desea habilitar. Consulta Acerca de GitHub Connect.

Volver a habilitar las conexiones a GitHub.com

Si necesita volver a habilitar GitHub Connect para GitHub.com, debe volver a configurar la configuración.

  1. SSH en tu instancia de GitHub Enterprise Server Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Reemplace HOSTNAME por el nombre de host de la instancia, o el nombre de host o la dirección IP de un nodo. Para más información, consulta Acceder al shell administrativo (SSH).

    Shell
    ssh -p 122 admin@HOSTNAME

  2. Ejecute el siguiente comando:

    Shell
    ghe-config app.github.github-connect-ghe-com-enabled false

  3. Para aplicar la configuración, ejecuta el siguiente comando.

    Nota:

    Durante una ejecución de configuración, los servicios en tu instancia de GitHub Enterprise Server pueden reiniciarse, lo que puede provocar un breve tiempo de inactividad para los usuarios.

    Shell
    ghe-config-apply

  4. Habilite GitHub Connect en GitHub.com. Consulta Habilitación de GitHub Connect para GitHub.com.