View a markdown version of this page

Cree una conexión a una plataforma GitLab autogestionada - Consola de Developer Tools
Crea una conexión GitLab autogestionada (consola)Cree una conexión a un sistema GitLab autogestionado (CLI)

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 una plataforma GitLab autogestionada

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

Puede usar el Consola de administración de AWS o el AWS Command Line Interface (AWS CLI) para crear una conexión y un host GitLab autogestionado.

nota

Al autorizar esta aplicación de conexión de forma 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 con un sistema GitLab autogestionado, debes crear un host para usarlo como 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:

  • Ya debe haber creado 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

    Puedes crear conexiones a un repositorio en el que tengas la función de propietario y GitLab, a continuación, la conexión se puede usar con recursos como CodePipeline. En el caso de los repositorios en grupos, no es necesario que sea el propietario del grupo.

  • Ya debes haber creado un token de acceso GitLab personal (PAT) con el api alcance. Si el modo de administración está habilitado en su GitLab instancia, la PAT también debe incluir el admin_mode alcance. Para obtener más información, consulta los tokens de acceso personales y los alcances de los tokens de acceso en el GitLab sitio web. Debe ser administrador para crear y utilizar el 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.

nota

En el caso de las organizaciones que utilizan GitHub Enterprise Server o GitLab son autogestionadas, no es necesario dejar de tener un host disponible. Creas un host nuevo para cada conexión de tu organización y debes asegurarte de introducir la misma información en los campos de red (ID de VPC, ID de subred e ID de grupo de seguridad) del host. Para obtener más información, consulte Configuración de conexión y host para proveedores instalados y organizaciones de apoyo.

Crea una conexión GitLab autogestionada (consola)

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

A partir del 1 de julio de 2024, la consola creará conexiones con codeconnections el ARN del recurso. Los recursos con ambos prefijos de servicio seguirán mostrándose en la consola.

nota

Se crea un host para una única instalación GitLab autogestionada y, a continuación, se pueden gestionar una o más conexiones GitLab autogestionadas a ese host.

Paso 1: Crear el host

  1. Inicie sesión en y Consola de administración de AWS, 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 GitLab autogestionado.

  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.

    nota

    En el caso de las organizaciones que utilizan GitHub Enterprise Server o GitLab son autogestionadas, no es necesario dejar pasar un host disponible. Creas un host nuevo para cada conexión de tu organización y debes asegurarte de introducir la misma información en los campos de red (ID de VPC, ID de subred e ID de grupo de seguridad) del host. Para obtener más información, consulte Configuración de conexión y host para proveedores instalados y organizaciones de apoyo.

    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.

    Captura de pantalla de la consola en la que se muestran los detalles de un host GitLab autogestionado con el host en estado Pendiente.
Paso 2: Configurar su host pendiente

  1. Elija Configurar host.

  2. Aparece una host_name página de configuración. En Proporcione un token de acceso personal, indique el api alcance de su GitLab PAT. Si el modo de administración está habilitado en tu GitLab instancia, la PAT también debe incluir el admin_mode alcance. Para obtener más información, consulta los alcances de los tokens de acceso en el GitLab sitio web.

    nota

    Solo un administrador puede crear y usar el PAT.

    Captura de pantalla de la consola en la que se muestra la entrada del token de acceso GitLab personal para el nuevo host

  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.

    Captura de pantalla de la consola que muestra el estado disponible para el nuevo host
Paso 3: Crear una conexión

  1. Inicie sesión en y Consola de administración de AWS, 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. Elija Crear conexión.

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

    Captura de pantalla de la consola que muestra la opción de conexión seleccionada para la GitLab autogestión.

  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 Conectarse a un sistema GitLab autogestionado. 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, inicie sesión con sus credenciales y, a continuación, seleccione Iniciar sesión.

  9. Aparece una página de autorización con un mensaje en el que se solicita la autorización para que la conexión acceda a su 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 Nombre de la conexión.

  11. Seleccione Conectarse a un sistema GitLab autogestionado.

    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.

Cree una conexión a un sistema GitLab autogestionado (CLI)

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

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

Paso 1: Para crear un host GitLab autogestionado (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 Consola de administración de AWS y abra la consola de herramientas para desarrolladores 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 signo --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 Consola de administración de AWS y abra la consola de herramientas para desarrolladores 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.