Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Cree una conexión a GitHub Enterprise Server
Las conexiones se utilizan para asociar AWS los recursos a un repositorio de terceros. Puede usar Consola de administración de AWS o AWS Command Line Interface (AWS CLI) para crear una conexión a GitHub Enterprise Server.
Las conexiones solo proporcionan acceso a los repositorios propiedad de la cuenta de GitHub Enterprise Server que se utiliza durante la creación de la conexión para autorizar la instalación de la GitHub aplicación.
Antes de empezar:
+ Debe tener ya una instancia de GitHub Enterprise Server y un repositorio en ella.
+ Debe ser administrador de la instancia de GitHub Enterprise Server para poder crear GitHub aplicaciones y crear un recurso de host, como se muestra en esta sección.
**importante**
Cuando configuras tu host para GitHub Enterprise Server, se crea automáticamente un punto de enlace de VPC para los datos de eventos de webhooks. Si creaste tu host antes del 24 de noviembre de 2020 y quieres usar los puntos de enlace de PrivateLink webhook de VPC, primero debes [eliminar](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html) tu host y, después, [crear](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html) uno nuevo.
**nota**
En el caso de las organizaciones que GitHub utilizan Enterprise Server o que se gestionan de GitLab forma autogestionada, no se pasa por un host disponible. Debe crear un host nuevo para cada conexión de su organización y asegurarse de introducir la misma información en los campos de red (ID de VPC, subred IDs y grupo de seguridad IDs) del host. Para obtener más información, consulte [Configuración de conexión y host para proveedores instalados y organizaciones de apoyo](troubleshooting-connections.md#troubleshooting-organization-host).
**Topics**
+ [Cree una conexión a GitHub Enterprise Server (consola)](connections-create-gheserver-console.md)
+ [Crear una conexión a GitHub Enterprise Server (CLI)](connections-create-gheserver-cli.md)
# Cree una conexión a GitHub Enterprise Server (consola)
Para crear una conexión con GitHub Enterprise Server, debe proporcionar información sobre dónde está instalado su GitHub Enterprise Server y autorizar la creación de la conexión con sus credenciales de GitHub Enterprise.
**nota**
A partir del 1 de julio de 2024, la consola crea conexiones con `codeconnections` el ARN del recurso. Los recursos con ambos prefijos de servicio seguirán mostrándose en la consola.
**Topics**
+ [Cree su conexión a GitHub Enterprise Server (consola)](#connections-create-gheserver-connection)
## Cree su conexión a GitHub Enterprise Server (consola)
Para crear una conexión a GitHub Enterprise Server, tenga preparadas la URL del servidor y las credenciales GitHub empresariales.
**Creación de un host**
1. Inicie sesión en y abra la Consola de administración de AWS consola de herramientas para AWS desarrolladores en[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. En la pestaña **Hosts** (Alojamientos), elija **Create host** (Crear alojamiento).
1. En **Host name** (Nombre del alojamiento), ingrese el nombre que desea utilizar para el alojamiento.
1. En **Seleccionar un proveedor**, elija una de las siguientes opciones:
+ **GitHub Servidor empresarial**
+ **GitLab autogestionado**
1. En **URL**, ingrese el punto de enlace de la infraestructura donde está instalado el proveedor.
1. Si su servidor está configurado en una Amazon VPC y desea conectarse a su VPC, elija **Use a VPC** (Utilizar una VPC). En caso contrario, elija **No VPC**.
1. Si lanzó su instancia en una Amazon VPC y desea conectarse a su VPC, elija **Use a VPC** (Utilizar una VPC) y complete lo siguiente.
1. En **VPC ID** (ID de la VPC), elija el ID de su VPC. Asegúrese de elegir la VPC para la infraestructura donde está instalada su instancia o una VPC con acceso a la instancia a través de VPN o Direct Connect.
1. Si tiene una VPC privada configurada y ha configurado su instancia para realizar la validación de TLS mediante una entidad de certificación no pública, introduzca el ID de su certificado en **Certificado TLS**. El valor del certificado TLS es la clave pública del certificado.
1. Elija **Create host** (Crear alojamiento).
1. Una vez que se muestra la página de detalles del alojamiento, el estado del alojamiento cambia a medida que se crea el alojamiento.
**nota**
Si la configuración del alojamiento incluye una configuración de VPC, espere varios minutos para el aprovisionamiento de los componentes de red del alojamiento.
Espere a que el alojamiento alcance un estado **Pendiente** y, luego, complete la configuración. Para obtener más información, consulte [Configuración de un alojamiento pendiente](connections-host-setup.md).
![\[Captura de pantalla de la consola que muestra los detalles del alojamiento con el alojamiento en estado Pendiente.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-create-host-pending.png)
**Paso 2: Cree su conexión a GitHub Enterprise Server (consola)**
1. Inicie sesión en la consola de Herramientas para desarrolladores Consola de administración de AWS y ábrala en[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Elija **Settings > Connections** (Configuración > Conexiones) y, luego, elija **Create connection** (Crear conexión).
1. Para crear una conexión a un repositorio de GitHub Enterprise Server instalado, elija **GitHub Enterprise Server**.
**Conectarse a GitHub Enterprise Server**
1. En **Connection name** (Nombre de la conexión), ingrese el nombre para la conexión.
![\[Captura de pantalla de la consola que muestra la página de creación de la configuración del alojamiento sin VPC.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-create-ghes-screen.png)
1. En **URL**, ingrese el punto de enlace para el servidor.
**nota**
Si la URL proporcionada ya se ha utilizado para configurar un servidor GitHub empresarial para una conexión, se le pedirá que elija el ARN del recurso de host que se creó anteriormente para ese punto final.
1. (Opcional) Si ha lanzado su servidor en una Amazon VPC y desea conectarse a su VPC, elija **Utilizar una VPC** y complete lo siguiente.
**nota**
En el caso de las organizaciones con GitHub Enterprise Server o GitLab autogestionadas, no hay que dejar pasar un host disponible. Debe crear un host nuevo para cada conexión de su organización y asegurarse de introducir la misma información en los campos de red (ID de VPC, subred IDs y grupo de seguridad IDs) del host. Para obtener más información, consulte [Configuración de conexión y host para proveedores instalados y organizaciones de apoyo](troubleshooting-connections.md#troubleshooting-organization-host).
1. En **VPC ID** (ID de la VPC), elija el ID de su VPC. Asegúrese de elegir la VPC para la infraestructura en la que está instalada la instancia de GitHub Enterprise Server o una VPC con acceso a la instancia de GitHub Enterprise Server a través de VPN o Direct Connect.
1. En **Subnet ID** (ID de la subred), elija **Add** (Agregar). En el campo, elija el ID de la subred que desea utilizar para el alojamiento. Puede elegir hasta 10 subredes.
Asegúrese de elegir la subred para la infraestructura en la que está instalada la instancia de GitHub Enterprise Server o una subred con acceso a la instancia de GitHub Enterprise Server instalada a través de VPN o Direct Connect.
1. **En **Grupo de seguridad IDs**, elija Agregar.** En el campo, elija el grupo de seguridad que desea utilizar para el alojamiento. Puede elegir hasta 10 grupos de seguridad.
Asegúrese de elegir el grupo de seguridad para la infraestructura en la que está instalada la instancia de GitHub Enterprise Server o un grupo de seguridad con acceso a la instancia de GitHub Enterprise Server instalada a través de VPN o Direct Connect.
1. Si tiene configurada una VPC privada y ha configurado su instancia de GitHub Enterprise Server para realizar la validación de TLS mediante una entidad de certificación no pública, introduzca su ID de certificado en el **certificado TLS**. El valor del certificado TLS debe ser la clave pública del certificado.
![\[Captura de pantalla de la consola que muestra la página de creación de conexiones a GitHub Enterprise Server para las opciones de VPC.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-create-ghes-screen-vpc.png)
1. Elija **Connect to GitHub Enterprise Server**. La conexión creada se muestra con un estado **Pendiente**. Se crea un recurso de alojamiento para la conexión con la información del servidor que usted proporcionó. Se utiliza la URL para el nombre del alojamiento.
1. Elija **Update pending connection** (Actualizar conexión pendiente).
![\[Captura de pantalla de la consola que muestra la página de conexión pendiente de GitHub Enterprise Server.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-create-ghes-pending.png)
1. Si se te solicita, en la página de inicio de sesión de GitHub Enterprise, inicia sesión con tus credenciales de GitHub Enterprise.
1. En la página **Crear GitHub aplicación**, elige un nombre para la aplicación.
![\[Captura de pantalla de la consola que muestra la página de creación de aplicaciones.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-create-ghes-app-name.png)
1. En la página de GitHub autorización, selecciona **Autorizar**.
![\[Captura de pantalla de la consola que muestra la página de autorización de aplicaciones.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-create-ghes-app-authorize.png)
1. En la página de instalación de aplicaciones, se muestra un mensaje que indica que la aplicación Connector está lista para instalarse. Si tiene varias organizaciones, es posible que deba elegir la organización en la que desea instalar la aplicación.
Elija la configuración del repositorio donde desea instalar la aplicación. Elija **Instalar**.
![\[Captura de pantalla de la consola que muestra la página de autorización de aplicaciones.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-create-ghes-app-install.png)
1. La página de conexión muestra la conexión creada en un estado **Disponible**.
# Crear una conexión a GitHub Enterprise Server (CLI)
Puede usar AWS Command Line Interface (AWS CLI) para crear una conexión.
Para ello, utilice los comandos **create-host** y **create-connection**.
**importante**
Una conexión creada a través del AWS CLI o AWS CloudFormation está en `PENDING` estado de forma predeterminada. Después de crear una conexión con la CLI o CloudFormation, utilice la consola para editar la conexión y establecer su estado`AVAILABLE`.
**Paso 1: Crear un host para GitHub Enterprise Server (CLI)**
1. Abra un terminal (Linux, macOS o Unix) o un símbolo del sistema (Windows). Utilice el AWS CLI para ejecutar el **create-host** comando, especificando el `--name``--provider-type`, y `--provider-endpoint` para la conexión. En este ejemplo, el nombre del proveedor de terceros es `GitHubEnterpriseServer` y el punto de conexión es `my-instance.dev`.
```
aws codeconnections create-host --name MyHost --provider-type GitHubEnterpriseServer --provider-endpoint "https://my-instance.dev"
```
Si se ejecuta correctamente, este comando devuelve la información del nombre de recurso de Amazon (ARN) del alojamiento, que será similar a lo siguiente.
```
{
"HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
}
```
Después de este paso, el alojamiento se encuentra en estado `PENDING`.
1. Utilice la consola para completar la configuración del alojamiento y que el estado del alojamiento cambie a `Available`. Para obtener más información, consulte [Configuración de un alojamiento pendiente](connections-host-setup.md).
**Paso 2: Configurar un host pendiente en la consola**
1. Inicie sesión en la consola de Herramientas para desarrolladores Consola de administración de AWS y ábrala en[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Utilice la consola para completar la configuración del alojamiento y que el estado del alojamiento cambie a `Available`. Consulte [Configuración de un alojamiento pendiente](connections-host-setup.md).
**Paso 3: Para crear una conexión para GitHub Enterprise Server (CLI)**
1. Abra un terminal (Linux, macOS o Unix) o un símbolo del sistema (Windows). Utilice el AWS CLI para ejecutar el **create-connection** comando, especificando el `--host-arn` y `--connection-name` para la conexión.
```
aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection
```
Si se ejecuta correctamente, este comando devuelve la información del ARN de la conexión, que será similar a lo siguiente.
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad"
}
```
1. Utilice la consola para configurar la conexión pendiente. Para obtener más información, consulte [Actualización de una conexión pendiente](connections-update.md).
**Paso 4: Para completar una conexión para GitHub Enterprise Server en la consola**
1. Inicie sesión en la consola de Herramientas para desarrolladores Consola de administración de AWS y ábrala en[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Use la consola para configurar la conexión pendiente y mover la conexión a un estado `Available`. Para obtener más información, consulte [Actualización de una conexión pendiente](connections-update.md).