Habilitación de GitHub Connect para GHE.com

Puedes acceder a las características y flujos de trabajo adicionales de tu instancia de GitHub Enterprise Server si habilitas GitHub Connect. Consulte "Acerca de GitHub Connect".

En GHE.com, las características de GitHub Connect no incluyen ninguna funcionalidad que dependa de recursos en GitHub.com.

¿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 realizar 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: Necesitas acceso administrativo tanto a una cuenta de empresa en GHE.com como a una instancia de GitHub Enterprise Server.
Requisito de versión: Tu instancia GitHub Enterprise Server debe ejecutar GitHub Enterprise Server 3.12 o posterior.
Configuración de proxy: Si utilizas un servidor proxy, permite la conectividad a los siguientes GHE.com nombres de host (sustituye SUBDOMAIN por el subdominio de tu empresa).
- SUBDOMAIN.ghe.com
- api.SUBDOMAIN.ghe.com
- uploads.SUBDOMAIN.ghe.com
Consulte "Configuración de un servidor proxy web de salida".

Paso 1: Habilitar la conexión a GHE.com

De manera predeterminada, GitHub Connect conecta GitHub Enterprise Server a GitHub.com. Debes habilitar tu instancia para que se conecte al subdominio de la empresa de GHE.com.

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

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 obtener más información, vea «Acceder al shell administrativo (SSH)».
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Para permitir que la instancia se conecte a GHE.com para GitHub Connect, ejecuta el siguiente comando. Sustituye SUBDOMAIN por el subdominio de tu 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"

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

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

Note

Durante la ejecución de una configuración, los servicios de tu instancia de GitHub Enterprise Server pueden reiniciarse, y esto puede provocar un breve tiempo de inactividad para los usuarios.
Shell
```
ghe-config-apply
```
```
ghe-config-apply
```

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

Paso 2: Habilitar GitHub Connect

Para habilitar GitHub Connect, debes 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 de tu instancia de GitHub Enterprise Server.

Inicia sesión en tu instancia de GitHub Enterprise Server y GHE.com.
En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Configuración de empresa.
En la barra lateral de la cuenta empresarial, haz clic en GitHub Connect .
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".
A la derecha de la cuenta empresarial a la que quieres conectarte, haz clic en Conectar.
Elige qué características individuales de GitHub Connect deseas habilitar. Consulte "Acerca de GitHub Connect".

Nueva habilitación de las conexiones a GitHub.com

Si tienes que volver a habilitar GitHub Connect para GitHub.com, tienes que reconfigurar la configuración.

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 obtener más información, vea «Acceder al shell administrativo (SSH)».
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Ejecute el siguiente comando: