Creación de un alojamiento

Puede usar AWS Management Console 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.

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 y Solución de problemas de la configuración de una VPC para el alojamiento.

Para usar la consola para crear un host y una conexión a GitHub Enterprise Server, consulteCree su conexión a GitHub Enterprise Server (consola). La consola crea un alojamiento para usted.

Si desea utilizar la consola para crear un host y una conexión GitLab autogestionada, consulteCree una conexión a una red GitLab autogestionada. 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.

• 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 acerca de cómo trabajar con las VPC y las subredes, consulte Tamaño de la subred y la VPC para una dirección IPv4 en la Guía del usuario 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 o ID de subred: 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.

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

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.

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

Actualmente, si utilizas la consola para crear una conexión, solo se crearán recursos dentro codestar-connections del ARN del recurso. Para crear un recurso que tendrá el prefijo de codeconnections servicio en el ARN, utilice la CLI, el SDK o el CFN. Los recursos con ambos prefijos de servicio seguirán mostrándose en la consola. La creación de recursos de consola estará disponible a partir del 1 de julio de 2024.

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.

Para usar la consola para crear un host y una conexión a GitHub Enterprise Server, consulteCree su conexión a GitHub Enterprise Server (consola). La consola crea un alojamiento para usted.

Si desea utilizar la consola para crear un host y una conexión GitLab autogestionada, consulteCree una conexión a una red GitLab autogestionada. 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, consulteCree su conexión a GitHub Enterprise Server (consola). La consola crea un alojamiento para usted.

Si desea utilizar la consola para crear un host y una conexión GitLab autogestionada, consulteCree una conexión a una red GitLab autogestionada. La consola crea un alojamiento para usted.