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?
When you enable GitHub Connect, you configure a connection between tu instancia de GitHub Enterprise Server and an enterprise account on GitHub Enterprise Cloud. La conexión usa HTTPS a través de los puertos 443 o 80 y está protegido por TLS.
Enabling GitHub Connect creates a GitHub App owned by the enterprise account on GitHub Enterprise Cloud. GitHub Enterprise Server uses the GitHub App's credentials to make requests to GitHub Enterprise Cloud.
GitHub Enterprise Server stores credentials from the GitHub App. The following credentials will be replicated to all nodes in a high availability or cluster environment, and stored in any backups, including snapshots created by GitHub Enterprise Server Backup Utilities.
- An authentication token, which is valid for one hour
- A private key, which is used to generate a new authentication token
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:
Shell ghe-config app.github.github-connect-ghe-com-enabled false
ghe-config app.github.github-connect-ghe-com-enabled false
-
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
-
Habilita GitHub Connect en GitHub.com. Consulte "Enabling GitHub Connect for GitHub.com".