Cree una conexión a una red GitLab autogestionada

Puede crear conexiones para GitLab Enterprise Edition o GitLab Community Edition con una instalación autogestionada.

Puede usar AWS Management Console o AWS Command Line Interface (AWS CLI) para crear una conexión y hospedarla de forma GitLab autogestionada.

nota

Al autorizar esta aplicación de conexión como GitLab autogestionada, concedes a nuestro servicio permisos para procesar tus datos y puedes revocar los permisos en cualquier momento desinstalando la aplicación.

Antes de crear una conexión GitLab autogestionada, debe crear un host para utilizarlo en la conexión, tal y como se detalla en estos pasos. 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.

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.

Antes de empezar

• Debe haber creado ya una cuenta GitLab y disponer de GitLab Enterprise Edition o GitLab Community Edition con una instalación autogestionada. Para obtener más información, consulte https://docs.gitlab.com/ee/subscriptions/self_managed/.

  nota

  Las conexiones solo dan acceso a la cuenta que se utilizó para crear y autorizar la conexión.

  nota

  Puede crear conexiones a un repositorio en el que tenga el rol de propietario y GitLab, a continuación, utilizar la conexión con recursos como CodePipeline: En el caso de los repositorios en grupos, no es necesario que sea el propietario del grupo.

• Debe haber creado ya un token de acceso GitLab personal (PAT) únicamente con el siguiente permiso limitado: api. Para obtener más información, consulte https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html. Debe ser administrador para crear y usar la PAT.

  nota

  Su PAT se utiliza para autorizar el host y las conexiones no la almacenan ni lo utilizan de ningún otro modo. Para configurar un host, puede crear un PAT temporal y, después de configurar el host, puede eliminarlo.

Cree una conexión a una consola GitLab autogestionada

Siga estos pasos para crear un host y una conexión GitLab autogestionada en la consola. Para obtener información acerca de las consideraciones de la configuración de un host en una VPC, consulte (Opcional) Requisitos previos: configuración de red o Amazon VPC para la conexión.

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.

nota

Cree un host para una única instalación GitLab autogestionada y, a continuación, podrá administrar una o más conexiones GitLab autogestionadas a ese host.

Paso 1: Crear el host

1. Inicie sesión en y AWS Management Console, a continuación, abra la consola de Herramientas para AWS desarrolladores en. https://console.aws.amazon.com/codesuite/settings/connections

2. En la pestaña Hosts (Alojamientos), elija Create host (Crear alojamiento).

3. En Host name (Nombre del alojamiento), ingrese el nombre que desea utilizar para el alojamiento.

4. En Seleccione un proveedor, elija GitLabautogestionado.

5. En URL, ingrese el punto de enlace de la infraestructura donde está instalado el proveedor.

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

7. (Opcional) Si ha lanzado su host en una Amazon VPC y desea conectarse a su VPC, elija 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á instalado su host o una VPC con acceso a la instancia a través de VPN o Direct Connect.

   2. Si tiene una VPC privada configurada y ha configurado su host 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.

8. Elija Create host (Crear alojamiento).

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

   

Paso 2: Configurar su host pendiente

1. Elija Configurar host.

2. Aparece la página Configurar host_name. En Proporcionar un token de acceso personal, proporcione a su GitLab PAT únicamente el siguiente permiso limitado:. api

   nota

   Solo un administrador puede crear y usar la PAT.

   

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

   

Paso 3: Crear una conexión

1. Inicie sesión en y AWS Management Console, a continuación, abra la consola de Herramientas para AWS desarrolladores enhttps://console.aws.amazon.com/codesuite/settings/connections.

2. Elija Configuración y, a continuación, elija Conexiones. Seleccione Crear conexión.

3. Para crear una conexión a un GitLab repositorio, en Seleccione un proveedor, elija GitLab autogestionado. En Nombre de la conexión, introduzca el nombre de la conexión que desea crear.

   

4. En URL, ingrese el punto de conexión para el servidor.

5. Si lanzó su servidor 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á instalado su host o una VPC con acceso al host a través de VPN o Direct Connect.

   2. 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 donde está instalado su host o una subred con acceso al host instalado a través de VPN o Direct Connect.

   3. En Security group IDs (ID del grupo de seguridad), elija Add (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á instalado su host o un grupo de seguridad con acceso a su host instalado a través de VPN o Direct Connect.

   4. Si tiene una VPC privada configurada y ha configurado su host 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 debe ser la clave pública del certificado.

6. Elige Conectar para GitLab autogestionarse. 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.

7. Elija Update pending connection (Actualizar conexión pendiente).

8. Cuando aparezca la página de inicio de GitLab sesión, inicia sesión con tus credenciales y, a continuación, selecciona Iniciar sesión.

9. Aparece una página de autorización con un mensaje en la que se solicita la autorización de la conexión para acceder a tu GitLab cuenta.

   Seleccione Autorizar.

10. El navegador vuelve a la página de la consola de conexiones. En Crear GitLab conexión, la nueva conexión se muestra en el nombre de la conexión.

11. Elige Conectar para GitLab autogestionarse.

    Cuando la conexión se haya creado correctamente, se mostrará el banner de realización correcta. Los detalles de la conexión se muestran en la página Ajustes de conexión.

Crear una conexión a la red GitLab autogestionada (CLI)

Puede usar el AWS Command Line Interface (AWS CLI) para crear un host y una conexión de forma GitLab autogestionada.

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 AWS CloudFormation, utilice la consola para editar la conexión y establecer su estadoAVAILABLE.

Paso 1: Crear un host para GitLab autogestión (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 GitLabSelfManaged y el punto de conexión es my-instance.dev.

   aws codeconnections create-host --name MyHost --provider-type GitLabSelfManaged --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.

2. Utilice la consola para completar la configuración del host y mover el host a un que el estado del alojamiento cambie a estado Available en el siguiente paso.

Paso 2: Configurar un host pendiente en la consola

1. Inicie sesión en la consola de Herramientas para desarrolladores AWS Management Console y ábrala enhttps://console.aws.amazon.com/codesuite/settings/connections.

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

Paso 3: Para crear una conexión GitLab autogestionada (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"
   }

2. Utilice la consola para configurar la conexión pendiente en el siguiente paso.

Paso 4: Para completar una conexión GitLab autogestionada en la consola

1. Inicie sesión en la consola de herramientas para desarrolladores AWS Management Console y ábrala enhttps://console.aws.amazon.com/codesuite/settings/connections.

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