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.
# Trabajo con alojamientos
Para crear una conexión a un tipo de proveedor instalado, como GitHub Enterprise Server, primero debe crear un host mediante Consola de administración de AWS. Un alojamiento es un recurso que se crea para representar la infraestructura donde está instalado el proveedor. Luego, se crea una conexión con ese alojamiento. Para obtener más información, consulte [Trabajar con conexiones](connections.md).
Por ejemplo, se crea un alojamiento para la conexión de modo que la aplicación de terceros para el proveedor se pueda registrar para representar la infraestructura. Se crea un alojamiento para un tipo de proveedor y, luego, todas las conexiones a ese tipo de proveedor utilizan ese alojamiento.
Cuando utiliza la consola para crear una conexión a un tipo de proveedor instalado, como GitHub Enterprise Server, la consola crea el recurso de host automáticamente.
**Topics**
+ [Creación de un alojamiento](connections-host-create.md)
+ [Configuración de un alojamiento pendiente](connections-host-setup.md)
+ [Enumeración de alojamientos](connections-host-list.md)
+ [Edición de un alojamiento](connections-host-edit.md)
+ [Eliminación de un alojamiento](connections-host-delete.md)
+ [Visualización de los detalles del alojamiento](connections-host-view.md)
# Creación de un alojamiento
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 para GitLab autogestionarse](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
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
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
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)
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 para GitLab autogestionarse](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 para GitLab autogestionarse](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)
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 para GitLab autogestionarse](connections-create-gitlab-managed.md). La consola crea un alojamiento para usted.
# Configuración de un alojamiento pendiente
Un host creado mediante AWS Command Line Interface (AWS CLI) o el SDK está en `Pending` estado de forma predeterminada. Después de crear una conexión con la consola o el SDK, utilice la consola para configurar el host y establecer su estado`Available`. AWS CLI
Debe haber creado un alojamiento. Para obtener más información, consulte [Create a host](connections-host-create.md) (Crear un alojamiento).
**Para configurar un alojamiento pendiente**
Una vez creado el alojamiento, se encuentra en un estado **Pendiente**. Para que el estado del alojamiento pase de **Pendiente** a **Disponible**, complete estos pasos. Este proceso realiza un apretón de manos con el proveedor externo para registrar la aplicación de AWS conexión en el host.
1. Cuando el anfitrión alcance el estado **Pendiente** en la consola de Herramientas para AWS desarrolladores, selecciona **Configurar host**.
1. Si va a crear un host para GitLab autogestionarlo, aparecerá una página de **configuración**. En **Proporcionar un token de acceso personal**, proporciona a tu GitLab PAT únicamente el siguiente permiso limitado: api.
1. En la página de inicio de sesión del proveedor instalado por un tercero, como la página de inicio de **GitHub Enterprise Server**, inicie sesión con las credenciales de su cuenta si se le solicita.
1. En la página de instalación de la **GitHub aplicación, en Nombre** de la aplicación, introduzca un nombre para la aplicación que desee instalar para su host. Selecciona **Crear GitHub aplicación**.
1. Una vez que el alojamiento se registró correctamente, aparece la página de detalles del alojamiento y muestra que el estado del alojamiento es **Disponible**.
![\[Captura de pantalla de la consola que muestra que la configuración del alojamiento está completa y en estado Disponible.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-create-host-register-complete.png)
1. Puede continuar con la creación de la conexión una vez que el alojamiento esté disponible. En el banner de realización correcta, elija **Create connection** (Crear conexión). Complete los pasos en [Creación de una conexión](connections-create-gheserver-console.md).
# Enumeración de alojamientos
Puede utilizar la consola de Developer Tools o el comando **list-connections** de AWS Command Line Interface (AWS CLI) para ver una lista con las conexiones de su cuenta.
## Enumeración de alojamientos (consola)
**Para enumerar alojamientos**
1. Abra la consola de herramientas para desarrolladores en [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Elija la pestaña **Hosts** (Alojamientos). Consulte el nombre, el estado y el ARN de los alojamientos.
## Enumeración de alojamientos (CLI)
Puede utilizarla AWS CLI para enumerar los hosts de las conexiones de proveedores externos instaladas.
Para ello, utilice el comando **list-hosts**.
**Para enumerar los hosts**
+ Abre una terminal (Linux, macOS o Unix) o una línea de comandos (Windows) y usa la AWS CLI para ejecutar el **list-hosts** comando.
```
aws codeconnections list-hosts
```
Este comando devuelve la siguiente salida.
```
{
"Hosts": [
{
"Name": "My-Host",
"HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605",
"ProviderType": "GitHubEnterpriseServer",
"ProviderEndpoint": "https://my-instance.test.dev",
"Status": "AVAILABLE"
}
]
}
```
# Edición de un alojamiento
Puede editar la configuración de un alojamiento en estado `Pending`. Puede editar el nombre del alojamiento, la dirección URL o la configuración de la VPC.
No puede utilizar la misma URL para más de un alojamiento.
**nota**
Para obtener información acerca de las consideraciones de la configuración de un alojamiento en una VPC, consulte [(Opcional) Requisitos previos: configuración de red o Amazon VPC para la conexión](connections-host-create.md#connections-create-host-prereq).
**Para editar un alojamiento**
1. Abra la consola de herramientas para desarrolladores en [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Elija **Settings > Connections** (Configuración > Conexiones).
1. Elija la pestaña **Hosts** (Alojamientos).
Se muestran los anfitriones asociados a tu AWS cuenta y creados en la AWS región seleccionada.
1. Para editar el nombre del alojamiento, ingrese un valor nuevo en **Name** (Nombre).
1. Para editar el punto de enlace del alojamiento, ingrese un valor nuevo en **URL**.
1. Para editar la configuración de la VPC del alojamiento, ingrese valores nuevos en **VPC ID** (ID de la VPC).
1. Elija **Edit host** (Editar alojamiento).
1. Se muestra la configuración actualizada. Elija **Set up Pending host** (Configurar alojamiento pendiente).
# Eliminación de un alojamiento
Puede utilizar la consola de herramientas para desarrolladores o el comando **delete-host** en la AWS Command Line Interface (AWS CLI) para eliminar un alojamiento.
**Topics**
+ [Eliminación de un alojamiento (consola)](#connections-host-delete-console)
+ [Eliminación de un alojamiento (CLI)](#connections-host-delete-cli)
## Eliminación de un alojamiento (consola)
**Para eliminar un alojamiento**
1. Abra la consola de herramientas para desarrolladores en [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Elija la pestaña **Hosts** (Alojamientos). En **Name** (Nombre), elija el nombre del alojamiento que desea eliminar.
1. Elija **Eliminar**.
1. Escriba **delete** en el campo para confirmar y elija **Eliminar**.
**importante**
Esta acción no se puede deshacer.
## Eliminación de un alojamiento (CLI)
Puede usar el AWS Command Line Interface (AWS CLI) para eliminar un host.
Para ello, utilice el comando **delete-host**.
**importante**
Para poder eliminar un alojamiento, debe eliminar todas las conexiones asociadas al alojamiento.
Después de ejecutar el comando, se elimina el alojamiento. No se muestra ningún cuadro de diálogo de confirmación.
**Para eliminar un alojamiento**
+ Abra un terminal (Linux, macOS o Unix) o un símbolo del sistema (Windows). Utilice el AWS CLI para ejecutar el **delete-host** comando y especifique el nombre de recurso de Amazon (ARN) del host que desea eliminar.
```
aws codeconnections delete-host --host-arn "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
```
Este comando no devuelve nada.
# Visualización de los detalles del alojamiento
Puede utilizar la consola de herramientas para desarrolladores o el comando **get-host** en la AWS Command Line Interface (AWS CLI) para ver los detalles de un alojamiento.
**Para ver los detalles del alojamiento (consola)**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de herramientas para desarrolladores 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 la pestaña **Hosts** (Alojamientos).
1. Elija el botón situado junto al alojamiento que desea ver y, luego, elija **View details** (Ver detalles).
1. Aparecerá la siguiente información del alojamiento:
+ Se mostrará el nombre del alojamiento.
+ Se mostrará el tipo de proveedor de la conexión.
+ Se mostrará el punto de enlace de la infraestructura donde está instalado el proveedor.
+ Se mostrará el estado de configuración del alojamiento. Un alojamiento listo para una conexión está en estado **Disponible**. Si el alojamiento se creó y la configuración no se completó, es posible que el alojamiento tenga un estado diferente.
Los siguientes estados están disponibles:
+ PENDING (PENDIENTE): el alojamiento completó la creación y está listo para iniciar la configuración mediante el registro de la aplicación del proveedor en el alojamiento.
+ AVAILABLE (DISPONIBLE): el alojamiento completó la creación y la configuración, y está disponible para utilizarse con conexiones.
+ ERROR: se produjo un error durante la creación o el registro del alojamiento.
+ VPC\$1CONFIG\$1VPC\$1INITIALIZING: se está creando la configuración de la VPC para el alojamiento.
+ VPC\$1CONFIG\$1VPC\$1FAILED\$1INITIALIZATION: la configuración de la VPC para el alojamiento encontró un error y falló.
+ VPC\$1CONFIG\$1VPC\$1AVAILABLE: la configuración de la VPC para el alojamiento completó la configuración y está disponible.
+ VPC\$1CONFIG\$1VPC\$1DELETING: se está eliminando la configuración de la VPC para el alojamiento.
![\[Captura de pantalla de la consola que muestra los detalles del alojamiento con el alojamiento en estado Disponible.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-view-host-screen.png)
1. Para eliminar el alojamiento, elija **Delete** (Eliminar).
1. Si el alojamiento está en estado **Pendiente**, elija **Set up host** (Configurar alojamiento) para completar la configuración. Para obtener más información, consulte [Configuración de un alojamiento pendiente](connections-host-setup.md).
**Para ver los detalles del alojamiento (CLI)**
+ Abra una terminal (Linux, macOS o Unix) o una línea de comandos (Windows) y utilícela AWS CLI para ejecutar el **get-host** comando, especificando el nombre de recurso de Amazon (ARN) del host del que desea ver los detalles.
```
aws codeconnections get-host --host-arn arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605
```
Este comando devuelve la siguiente salida.
```
{
"Name": "MyHost",
"Status": "AVAILABLE",
"ProviderType": "GitHubEnterpriseServer",
"ProviderEndpoint": "https://test-instance-1.dev/"
}
```