View a markdown version of this page

Conectando GitLab - AWS DevOps Agente
Registrarse GitLab (a nivel de cuenta)Conectar proyectos a un espacio de agentesConfiguración de la revisión de código y las pruebas automatizadasAdministrar GitLab las conexiones

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

GitLab la integración permite al AWS DevOps agente supervisar las implementaciones desde GitLab Pipelines para informar sobre las causas durante la respuesta a un incidente. 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 a Agent Spaces individuales.

Registrarse GitLab (a nivel de cuenta)

GitLab se registra a nivel de AWS cuenta y se comparte entre todos los espacios de agente de esa cuenta. Cada registro se vincula a un GitLab usuario o un GitLab grupo.

Paso 1: Diríjase a los proveedores de canalizaciones

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

  2. Navegue hasta la consola del AWS DevOps agente

  3. Vaya a la página de proveedores de capacidades (a la que se puede acceder desde la barra de navegación lateral)

  4. Busque GitLab en la sección de proveedores disponibles, en Pipeline, y elija Registrarse

Paso 2: Configurar la GitLab conexión

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

Tipo de conexión: selecciona si te conectas como persona o como grupo:

  • Personal (predeterminado): tu cuenta de GitLab usuario individual con un nombre de usuario y un perfil

  • Grupo: en GitLab, usas grupos para administrar uno o más proyectos relacionados al mismo tiempo

GitLab tipo de instancia: elige el tipo de GitLab instancia al que te estás conectando:

  • GitLab.com(predeterminado): el GitLab servicio público

  • Autohospedado y de acceso público GitLab: marca la casilla Usar un punto de enlace 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

  2. Navega hasta la configuración de usuario y selecciona los tokens de acceso

  3. Crea 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 de registro

    • api— Necesario para acceder a la API de lectura y escritura

    • self_rotate- Necesario para la rotación de fichas. Actualmente, el AWS DevOps agente no admite esta función, pero la admitirá más adelante. La adición ahora evita la necesidad de crear un nuevo token en el futuro.

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

  5. Copia el token generado

  6. Vuelva a la consola del AWS DevOps agente

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

Paso 3: Complete el registro

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

Seleccione Siguiente para revisar la configuración y, a continuación, seleccione Enviar para completar el proceso GitLab de registro. El sistema validará tu token de acceso y establecerá la conexión.

Conectar proyectos a un espacio de agentes

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

  1. En la consola de AWS DevOps agentes, seleccione su espacio de agente

  2. Vaya a la pestaña Capacidades

  3. En la sección Canalización, elige Agregar

  4. Selecciona GitLab de la lista de proveedores disponibles

  5. Seleccione el GitLab registro que contiene los proyectos que desea utilizar

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

  7. Seleccione Save.

AWS DevOps El agente supervisa estos proyectos para ver si se despliegan desde GitLab Pipelines y sirve de base para las investigaciones causales. Un único espacio de agente puede usar proyectos de varios registros. Para agregar proyectos de otro registro, repita estos pasos.

Configuración de la revisión de código y las pruebas automatizadas

Cuando seleccionas proyectos en la etapa de GitLab conexión, se agregan automáticamente a la sección Revisión del código y pruebas automatizadas. En esta sección se configuran los proyectos que activan automáticamente las funciones de prueba automática Revisiones del código de preparación para el lanzamiento y automática.

La configuración de revisión de código y pruebas automatizadas incluye:

  • Capacidades: elija las funciones de revisión de código y pruebas automatizadas para cada proyecto. La sección proporciona dos configuraciones por proyecto:

    • Activar automáticamente la revisión de cambios: cuando está habilitada para un proyecto, el DevOps agente ejecuta automáticamente una Revisiones del código de preparación para el lanzamiento 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 está habilitada para un proyecto, el DevOps agente crea, ejecuta y prueba los cambios de código en un entorno de verificación administrado 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. Está habilitada de forma predeterminada para todos los proyectos conectados.

  • Lista de proyectos: muestra todos los proyectos que seleccionó durante la etapa de conexión. Usa 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 ejecución (opcional): elija la función de IAM que asuma el DevOps agente para ejecutar las funciones automatizadas en los proyectos seleccionados. Esta función se usa 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 un rol diferente al de tu rol de agente principal.

Para configurar las revisiones automatizadas:

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

  2. Para cada proyecto, habilita o deshabilita la función de activación automática de la revisión de cambios en función de si quieres que las solicitudes de fusión se revisen automáticamente.

  3. Para cada proyecto, habilita o deshabilita la capacidad de realizar pruebas de verificación automatizadas en función de si quieres que las pruebas de verificación automatizadas se realicen en un entorno de verificación administrado.

  4. Si lo desea, seleccione un rol de IAM en el menú desplegable del rol en tiempo de ejecución que asumirá el DevOps agente cuando ejecute las capacidades automatizadas en los proyectos seleccionados.

  5. Seleccione Guardar para aplicar la configuración.

Una vez configurada, cualquier nueva solicitud de fusión en 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 su 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, consulteRevisiones del código de preparación para el lanzamiento.

Administrar GitLab las conexiones

  • Actualización del token de acceso: si tu token de acceso caduca o necesita actualizarse, puedes cambiarlo sin anular el registro. En la página de proveedores de capacidades, selecciona tu GitLab registro, elige Actualizar en el menú Acciones e introduce el nuevo token. Sus asociaciones de Agent Space y sus conexiones con los proyectos se conservan.

  • 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 Canalización.

  • Eliminar la GitLab conexión: para desconectar GitLab los proyectos de un espacio de agentes, seleccione la conexión en la sección Canalización y elija Eliminar. Para eliminar el GitLab registro por completo, elimínelo primero de todos los espacios de agente y, a continuación, elimine el registro a nivel de cuenta.