

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.

# Creación de un alojamiento
<a name="connections-host-create"></a>

Puede usar Consola de administración de AWS o AWS Command Line Interface (AWS CLI) para crear una conexión a un repositorio de código de terceros que esté instalado en su infraestructura. Por ejemplo, puede tener GitHub Enterprise Server ejecutándose como una máquina virtual en una instancia de Amazon EC2. Antes de crear una conexión a GitHub Enterprise Server, debe crear un host para usarlo en la conexión.

Para obtener información general sobre el flujo de trabajo de creación de hosts para proveedores instalados, consulte [Flujo de trabajo para crear o actualizar un host](welcome-hosts-workflow.md).

Antes de empezar:
+ (Opcional) Si desea crear su host con una VPC, debe haber creado ya una red o una nube virtual privada (VPC).
+ Debe haber creado la instancia y, si planea conectarse a su VPC, debe haber lanzado su host en la VPC.
**nota**  
Cada VPC solo se puede asociar a un host a la vez.

Si lo desea, puede configurar su host con una VPC. Para obtener más información acerca de la configuración de la VPC y la red para su recurso de host, consulte los requisitos previos de la VPC en [(Opcional) Requisitos previos: configuración de red o Amazon VPC para la conexión](#connections-create-host-prereq) y [Solución de problemas de la configuración de una VPC para el alojamiento](troubleshooting-connections.md#troubleshooting-connections-host-vpc).

Para usar la consola para crear un host y una conexión a GitHub Enterprise Server, consulte[Cree su conexión a GitHub Enterprise Server (consola)](connections-create-gheserver-console.md#connections-create-gheserver-connection). La consola crea un alojamiento para usted.

Si desea utilizar la consola para crear un host y una conexión GitLab autogestionada, consulte[Cree una conexión a una red GitLab autogestionada](connections-create-gitlab-managed.md). La consola crea un alojamiento para usted.

## (Opcional) Requisitos previos: configuración de red o Amazon VPC para la conexión
<a name="connections-create-host-prereq"></a>

Si su infraestructura está configurada con una conexión de red, puede omitir esta sección.

Si solo se puede acceder a su host en una VPC, siga estos requisitos de la VPC antes de continuar.

### Requisitos de la VPC
<a name="connections-create-host-prereq-vpc"></a>

Si lo desea, puede elegir crear su host con una VPC. A continuación se encuentran los requisitos generales de la VPC, los cuales dependen de la VPC que haya configurado para la instalación.
+ Puede configurar una VPC *pública* con subredes públicas y privadas. Si no tiene subredes ni bloques de CIDR preferidos, puede utilizar la VPC predeterminada para su cuenta de Cuenta de AWS .
+ 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, debe proporcionar el certificado TLS para su recurso de host.
+ Cuando Connections crea tu host, se crea automáticamente el punto final de la VPC (PrivateLink) para los webhooks. Para obtener más información, consulte [AWS CodeConnections y puntos finales de VPC de interfaz ()AWS PrivateLink](vpc-interface-endpoints.md).
+ Configuración del grupo de seguridad:
  + Los grupos de seguridad utilizados durante la creación del host necesitan reglas de entrada y salida que permitan que la interfaz de red se conecte a la instancia de Enterprise Server GitHub 
  + Los grupos de seguridad conectados a la instancia de GitHub Enterprise Server (que no forman parte de la configuración del host) necesitan acceso entrante y saliente desde las interfaces de red creadas por las conexiones.
+ Las subredes de la VPC deben residir en diferentes zonas de disponibilidad de su región. Las zonas de disponibilidad son ubicaciones diferentes que están aisladas en caso de que se produzca un error en otras zonas de disponibilidad. Cada subred debe residir enteramente en una zona de disponibilidad y no puede abarcar otras zonas.

Para obtener más información sobre cómo trabajar con subredes VPCs y subredes, consulte el [tamaño de las VPC y las subredes en la Guía IPv4 del usuario](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-sizing-ipv4) de *Amazon* VPC.

**Información de la VPC que se proporciona para la configuración del alojamiento**

Cuando crea el recurso de alojamiento para las conexiones en el siguiente paso, debe proporcionar lo siguiente: 
+ ID de **VPC: el ID** de la VPC del servidor en el que está instalada la instancia de GitHub Enterprise Server o de una VPC que tiene acceso a la instancia de GitHub Enterprise Server instalada a través de VPN o Direct Connect.
+ **ID de subred o IDs:** el ID de la subred del servidor en el 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.
+ **Grupo o grupos de seguridad:** el grupo de seguridad del servidor en el 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.
+ **punto de enlace:** tenga listo el punto de enlace del servidor y continúe con el siguiente paso.

Para obtener más información, incluida la solución de problemas de conexiones de alojamiento o de la VPC, consulte [Solución de problemas de la configuración de una VPC para el alojamiento](troubleshooting-connections.md#troubleshooting-connections-host-vpc).

### Requisitos del permiso
<a name="connections-create-host-prereq-permissions"></a>

Como parte del proceso de creación del host, AWS CodeConnections crea recursos de red en su nombre para facilitar la conectividad de la VPC. Esto incluye una interfaz de red AWS CodeConnections para consultar los datos del host y un punto final de VPC o *PrivateLink*para que el anfitrión envíe los datos de los eventos a través de webhooks a las conexiones. Para poder crear estos recursos de red, asegúrese de que el rol que ha utilizado para crear el host tenga los siguientes permisos:

```
ec2:CreateNetworkInterface
ec2:CreateTags
ec2:DescribeDhcpOptions
ec2:DescribeNetworkInterfaces
ec2:DescribeSubnets
ec2:DeleteNetworkInterface
ec2:DescribeVpcs
ec2:CreateVpcEndpoint
ec2:DeleteVpcEndpoints
ec2:DescribeVpcEndpoints
```

Para obtener más información acerca de la solución de problemas de permisos o conexiones de alojamiento en una VPC, consulte [Solución de problemas de la configuración de una VPC para el alojamiento](troubleshooting-connections.md#troubleshooting-connections-host-vpc).

Para obtener más información acerca del punto de enlace de la VPC de webhook, consulte [AWS CodeConnections y puntos finales de VPC de interfaz ()AWS PrivateLink](vpc-interface-endpoints.md).

**Topics**
+ [(Opcional) Requisitos previos: configuración de red o Amazon VPC para la conexión](#connections-create-host-prereq)
+ [Creación de un alojamiento para una conexión (consola)](#connections-host-create-console)
+ [Creación de un host para una conexión (CLI)](#connections-host-create-cli)

## Creación de un alojamiento para una conexión (consola)
<a name="connections-host-create-console"></a>

En el caso de las conexiones para instalaciones, como las de GitHub Enterprise Server o las GitLab autogestionadas, se utiliza un host para representar el punto final de la infraestructura en la que está instalado el proveedor externo.

**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.

Para obtener información acerca de las consideraciones de la configuración de un alojamiento en una VPC, consulte [Cree una conexión a una red GitLab autogestionada](connections-create-gitlab-managed.md).

Para usar la consola para crear un host y una conexión a GitHub Enterprise Server, consulte[Cree su conexión a GitHub Enterprise Server (consola)](connections-create-gheserver-console.md#connections-create-gheserver-connection). La consola crea un alojamiento para usted.

Si desea utilizar la consola para crear un host y una conexión GitLab autogestionada, consulte[Cree una conexión a una red GitLab autogestionada](connections-create-gitlab-managed.md). La consola crea un alojamiento para usted.

**nota**  
Solo se crea un host una vez por servidor GitHub empresarial o GitLab cuenta autogestionada. Todas las conexiones a un servidor GitHub empresarial específico o a una cuenta GitLab autogestionada utilizarán el mismo host.

## Creación de un host para una conexión (CLI)
<a name="connections-host-create-cli"></a>

Puede usar el AWS Command Line Interface (AWS CLI) para crear un host para las conexiones instaladas. 

**nota**  
Solo puede crear un host una vez por cuenta de GitHub Enterprise Server. Todas las conexiones a una cuenta específica de GitHub Enterprise Server utilizarán el mismo host.

Se utiliza un alojamiento para representar el punto de enlace de la infraestructura donde está instalado el proveedor de terceros. Para crear un alojamiento con la CLI, utilice el comando **create-host**. Una vez que termine de crear el alojamiento, este estará en estado **Pendiente**. Luego, *configure* el alojamiento para que su estado cambie a **Disponible**. Una vez que el alojamiento esté disponible, complete los pasos para crear una conexión.

**importante**  
Un host creado a través de AWS CLI está en `Pending` estado de forma predeterminada. Después de crear un alojamiento con la CLI, utilice la consola para configurar el alojamiento de manera que su estado cambie a `Available`.

Para usar la consola para crear un host y una conexión a GitHub Enterprise Server, consulte[Cree su conexión a GitHub Enterprise Server (consola)](connections-create-gheserver-console.md#connections-create-gheserver-connection). La consola crea un alojamiento para usted.

Si desea utilizar la consola para crear un host y una conexión GitLab autogestionada, consulte[Cree una conexión a una red GitLab autogestionada](connections-create-gitlab-managed.md). La consola crea un alojamiento para usted.