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. Cada registro enlaza con un GitLab usuario o un GitLab grupo.

### Paso 1: Dirígete a los proveedores de canalización
<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** (accesible desde el panel de navegación lateral)

1. Busque **GitLab**en la sección Proveedores **disponibles** en **Pipeline** y seleccione **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**: selecciona si te conectas como persona o 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 rotar 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.

Selecciona **Siguiente** para revisar la configuración y, a continuación, selecciona **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**, elija **Agregar**

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

1. Seleccione el GitLab registro que contiene los proyectos que desee utilizar

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

1. Seleccione **Save**.

AWS DevOps Agent supervisa estos proyectos en busca de despliegues desde GitLab Pipelines para fundamentar las investigaciones causales. Un único espacio de agente puede utilizar proyectos de varios registros. Para añadir proyectos de otro registro, repita estos pasos.

## Configuración de la revisión del código y las pruebas automatizadas
<a name="configuring-code-review-and-automated-testing"></a>

Al seleccionar proyectos en el paso de GitLab conexión, se añaden automáticamente a la sección de **revisión de código y pruebas automatizadas**. Esta sección configura qué proyectos activan automáticamente una [Revisiones del código de preparación para el lanzamiento](release-management-release-readiness-code-review.md) y automatizan las capacidades de prueba.

La configuración de revisión de código y pruebas automatizadas incluye:
+ **Capacidades**: elija capacidades de revisión de código y pruebas automatizadas para cada proyecto. La sección proporciona dos ajustes por proyecto:
  + **Activación automática de la revisión de cambios**: cuando está activado para un proyecto, DevOps Agent ejecuta automáticamente una solicitud de fusión [Revisiones del código de preparación para el lanzamiento](release-management-release-readiness-code-review.md) cada vez que se abre o actualiza una solicitud de fusión. Los resultados de la revisión aparecen como comentarios en línea en la solicitud de fusión. Esta opción está habilitada de forma predeterminada para todos los proyectos conectados.
  + **Pruebas de verificación automatizadas**: cuando se habilita para un proyecto, DevOps Agent crea, ejecuta y prueba los cambios de código en un entorno de verificación gestionado durante las revisiones del código. Esto proporciona una validación funcional más allá del análisis estático. Para obtener más información, consulte [Pruebas de verificación automatizadas](release-management-release-readiness-code-review.md). Esta opción está habilitada de forma predeterminada para todos los proyectos conectados.
+ **Lista de proyectos**: muestra todos los proyectos que seleccionó durante el paso de conexión. Utilice el campo de búsqueda para filtrar los proyectos por nombre. Cada proyecto tiene casillas de verificación independientes para ambas capacidades.
+ **Función de tiempo de ejecución** (opcional): elija la función de IAM que asumirá el DevOps agente para ejecutar las funciones automatizadas en los proyectos seleccionados. Esta función se utiliza para acceder a los servicios internos necesarios durante las compilaciones, como los registros de paquetes privados y los sistemas de almacenamiento de artefactos. Te recomendamos que utilices una función diferente a la de agente principal.

Para configurar las revisiones automatizadas:

1. Tras conectar tus proyectos, dirígete a la sección **Revisión de código y pruebas automatizadas** en GitLab la configuración de integración.

1. Para cada proyecto, active o desactive la función de **revisión automática de cambios** en función de si desea que se revisen automáticamente las solicitudes de fusión.

1. Para cada proyecto, active o desactive la función de **pruebas de verificación automatizadas** en función de si desea [realizar pruebas de verificación automatizadas](release-management-release-readiness-code-review.md) en un entorno de verificación gestionado.

1. Si lo desea, seleccione una función de IAM de la lista desplegable de **funciones en tiempo de ejecución** que el DevOps agente asumirá al ejecutar las funciones automatizadas en los proyectos seleccionados.

1. Seleccione **Guardar** para aplicar la configuración.

Una vez configurada, cualquier nueva solicitud de fusión de un proyecto que tenga habilitada la **revisión automática de cambios activará** automáticamente una revisión del código de preparación para el lanzamiento. Si **las pruebas de verificación automatizadas** también están habilitadas, la revisión incluye la validación funcional en un entorno de verificación. Para obtener más información sobre las revisiones de código, consulte[Revisiones del código de preparación para el lanzamiento](release-management-release-readiness-code-review.md).

## Administrar GitLab las conexiones
<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 elija **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.