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.

# Conectando GitLab
<a name="connecting-to-cicd-pipelines-connecting-gitlab"></a>

GitLab La integración permite a AWS DevOps Agent monitorear los despliegues desde GitLab Pipelines para fundamentar las investigaciones causales durante la respuesta a los incidentes. Esta integración sigue un proceso de dos pasos: el registro a nivel de cuenta y, a continuación GitLab, la conexión de proyectos específicos con los espacios de agente individuales.

## Registro GitLab (a nivel de cuenta)
<a name="registering-gitlab-account-level"></a>

GitLab se registra a nivel de AWS cuenta y se comparte entre todos los espacios de agentes de esa cuenta. Los espacios de agente individuales pueden entonces elegir qué proyectos específicos se van a aplicar a su espacio de agente.

### Paso 1: Dirígete a los proveedores en proceso
<a name="step-1-navigate-to-pipeline-providers"></a>

1. Inicie sesión en la consola AWS de administración

1. Navegue hasta la consola del AWS DevOps agente

1. Vaya a la página de **proveedores de capacidades** (a la que se puede acceder desde el panel de navegación lateral)

1. Busque **GitLab**en la sección Proveedores **disponibles** en **Pipeline** y haga clic en **Registrarse**

### Paso 2: Configurar la GitLab conexión
<a name="step-2-configure-gitlab-connection"></a>

En la página GitLab de registro, configure lo siguiente:

**Tipo de conexión**: seleccione si se va a conectar como persona o como grupo:
+ **Personal** (predeterminada): tu cuenta de GitLab usuario individual con un nombre de usuario y un perfil
+ **Grupo**: en GitLab, los grupos se utilizan para gestionar uno o más proyectos relacionados al mismo tiempo

**GitLab tipo de instancia**: elige el tipo de GitLab instancia al que te vas a conectar:
+ **GitLab.com** (predeterminado): el GitLab servicio público
+ **Autohospedado y de acceso público GitLab**: marca la casilla **Usar punto de conexión GitLab autohospedado** y proporciona la URL de tu instancia GitLab 

**nota**  
**Actualmente, solo se admiten GitLab las instancias de acceso público.

**Token de acceso**: proporciona un token de acceso GitLab personal:

1. En otra pestaña del navegador, inicia sesión en tu GitLab cuenta

1. Ve a la configuración de usuario y selecciona **Tokens de acceso**

1. Cree un nuevo token de acceso personal con los siguientes permisos:
   + `read_repository`— Necesario para acceder al contenido del repositorio
   + `read_virtual_registry`— Necesario para acceder a la información del registro virtual
   + `read_registry`— Necesario para acceder a la información del registro
   + `api`— Necesario para el acceso a la API de lectura y escritura
   + `self_rotate`- Necesario para la rotación de fichas. El AWS DevOps agente no admite esta función actualmente, pero la admitirá más adelante. Añadir ahora evita la necesidad de crear un nuevo token en el futuro.

1. Establezca la caducidad del token en un máximo de 365 días a partir de la fecha actual

1. Copia el token generado

1. Regrese a la consola del AWS DevOps agente

1. Pegue el token en el campo «Token de acceso»

### Paso 3: Completar el registro
<a name="step-3-complete-registration"></a>

**Etiquetas (opcionales)**: añada AWS etiquetas al GitLab registro con fines organizativos.

Haga clic en **Siguiente** para revisar la configuración y, a continuación, en **Enviar** para completar el proceso GitLab de registro. El sistema validará su token de acceso y establecerá la conexión.

## Conectar proyectos a un espacio de agentes
<a name="connecting-projects-to-an-agent-space"></a>

Tras registrarte GitLab a nivel de cuenta, puedes conectar proyectos específicos a espacios de agentes individuales:

1. En la consola de AWS DevOps agentes, selecciona tu espacio de agente

1. Ve a la pestaña **Capacidades**

1. En la sección **Pipeline**, haga clic en **Agregar**

1. Seleccione **GitLab**de la lista de proveedores disponibles

1. Seleccione los GitLab proyectos relevantes para su espacio de agente

1. Haga clic en **Guardar**

AWS DevOps El agente supervisará estos proyectos en busca de despliegues desde GitLab Pipelines para fundamentar las investigaciones causales.

## Administrar las conexiones GitLab
<a name="managing-gitlab-connections"></a>
+ **Actualización del token** de acceso: si su token de acceso caduca o necesita actualizarse, puede actualizarlo en la consola del AWS DevOps agente modificando el GitLab registro a nivel de cuenta.
+ **Visualización de los proyectos conectados**: en la consola del AWS DevOps agente, seleccione su espacio de agente y vaya a la pestaña Capacidades para ver los proyectos conectados en la sección Pipeline.
+ **Eliminar la GitLab conexión**: para desconectar GitLab los proyectos de un espacio de agentes, seleccione la conexión en la sección Pipeline y haga clic en **Eliminar**. Para eliminar el GitLab registro por completo, elimínelo primero de todos los Agent Spaces y, a continuación, elimine el registro a nivel de cuenta.