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 GitLab
<a name="connections-create-gitlab"></a>

Puedes usar el Consola de administración de AWS o el AWS Command Line Interface (AWS CLI) para crear una conexión a un repositorio alojado en gitlab.com.

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

Antes de empezar:
+ Debe haber creado ya una cuenta con. GitLab
**nota**  
Las conexiones solo dan acceso a la cuenta que se utilizó para crear y autorizar la conexión. 
**nota**  
Puede crear conexiones en las que tenga el rol de **propietario** y GitLab, a continuación, la conexión se puede utilizar con el repositorio con recursos como CodePipeline: En el caso de los repositorios en grupos, no es necesario que sea el propietario del grupo.

**Topics**
+ [Cree una conexión a GitLab (consola)](#connections-create-gitlab-console)
+ [Crear una conexión a GitLab (CLI)](#connections-create-gitlab-cli)

## Cree una conexión a GitLab (consola)
<a name="connections-create-gitlab-console"></a>

Puede usar la consola para crear una conexión. 

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

**Paso 1: Crear una conexión**

1. Inicie sesión en la consola de Herramientas para AWS desarrolladores y Consola de administración de AWS, a continuación, abra la consola en[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).

1. Elija **Configuración** y, a continuación, elija **Conexiones**. Elija **Crear conexión**.

1. Para crear una conexión a un GitLab repositorio, en **Seleccione un proveedor**, elija **GitLab**. En **Nombre de la conexión**, introduzca el nombre de la conexión que desea crear. Selecciona **Conectar a GitLab**.  
![\[Captura de pantalla de la consola que muestra la opción de conexión seleccionada para GitLab.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/connections-create-gitlab.png)

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

1. 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**.  
![\[Captura de pantalla que muestra el mensaje para autorizar la conexión de tu GitLab cuenta.\]](http://docs.aws.amazon.com/es_es/dtconsole/latest/userguide/images/gitlab-authorization.png)

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

1. Selecciona **Conectar a GitLab**.

   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 GitLab (CLI)
<a name="connections-create-gitlab-cli"></a>

Puede usar AWS Command Line Interface (AWS CLI) para crear una conexión. 

Para ello, utilice el comando **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 estado`AVAILABLE`.

**Para crear una conexión a GitLab**

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 `--provider-type` y `--connection-name` para la conexión. En este ejemplo, el nombre del proveedor de terceros es `GitLab` y el nombre especificado para la conexión es `MyConnection`.

   ```
   aws codeconnections create-connection --provider-type GitLab --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-4d5d-8878-dfcab0bc441f"
   }
   ```

1. Utilice la consola para completar la conexión. Para obtener más información, consulte [Actualización de una conexión pendiente](connections-update.md).