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.
# Conexión a CI/CD tuberías
La integración de la canalización de CI/CD permite a AWS DevOps Agent monitorear las implementaciones y correlacionar los cambios de código con los incidentes operativos durante las investigaciones. Al conectar a sus CI/CD proveedores, el agente puede realizar un seguimiento de los eventos de despliegue y asociarlos con AWS recursos para ayudar a identificar las posibles causas fundamentales durante la respuesta a los incidentes.
AWS DevOps El agente permite la integración con CI/CD las plataformas más populares mediante un proceso de dos pasos:
1. **Registro a nivel de cuenta**: registre a su CI/CD proveedor una vez a nivel de cuenta AWS
1. **Conexión con Agent Space**: conecte proyectos o repositorios específicos a Agent Spaces individuales en función de las necesidades de su organización
Este enfoque le permite compartir los registros de CI/CD proveedores en varios espacios de agentes y, al mismo tiempo, mantener un control pormenorizado sobre los proyectos que supervisa cada espacio.
## Proveedores compatibles CI/CD
AWS DevOps El agente es compatible con las siguientes CI/CD plataformas:
+ **GitHub**— Conecta los repositorios desde [GitHub.com](http://GitHub.com) mediante la GitHub aplicación AWS DevOps Agent.
+ **GitLab**— Conecta proyectos desde [GitLab.com,](http://gitlab.com) GitLab instancias gestionadas o GitLab despliegues autohospedados de acceso público.
**Temas**
+ [Conectando GitHub](connecting-to-cicd-pipelines-connecting-github.md)
+ [Conectando GitLab](connecting-to-cicd-pipelines-connecting-gitlab.md)
# Conectando GitHub
GitHub La integración permite al AWS DevOps agente acceder a los repositorios de códigos y recibir los eventos de despliegue durante la investigación de incidentes. Esta integración sigue un proceso de dos pasos: el registro a nivel de cuenta y, a continuación GitHub, la conexión de repositorios específicos a los espacios de agente individuales.
AWS DevOps El agente es compatible con GitHub instancias .com (SaaS) y GitHub Enterprise Server (autohospedadas).
## Requisitos previos
Antes de conectarse GitHub, asegúrese de tener:
+ Acceso a la consola de administración del AWS DevOps agente
+ Una cuenta GitHub de usuario o una organización con permisos de administrador
+ Autorización para instalar GitHub aplicaciones en tu cuenta u organización
Para GitHub Enterprise Server, también necesitas:
+ Una instancia de GitHub Enterprise Server (versión 3.x o posterior) accesible a través de HTTPS
+ La URL HTTPS de su instancia de GitHub Enterprise Server (por ejemplo,`https://github.example.com`)
+ (Opcional) Una conexión privada, si su instancia de GitHub Enterprise Server no es de acceso público
## Registrarse GitHub (a nivel de cuenta)
GitHub se registra a nivel de AWS cuenta y se comparte entre todos los espacios de agentes de esa cuenta. Solo necesita registrarse GitHub una vez por AWS cuenta.
### Paso 1: Dirígete a los proveedores de gasoductos
1. Inicie sesión en la consola AWS de administración
1. Navegue hasta la consola del AWS DevOps agente
1. Vaya a la pestaña **Capacidades**
1. En la sección **Pipeline**, haga clic en **Agregar**
1. Seleccione **GitHub**de la lista de proveedores disponibles
Si GitHub aún no se ha registrado, se le pedirá que lo registre primero.
### Paso 2: elige el tipo de conexión
En la pantalla « GitHub Registrar cuenta/organización», selecciona si te conectas como usuario u organización:
+ **Usuario**: su GitHub cuenta personal con un nombre de usuario y un perfil
+ **Organización**: una GitHub cuenta compartida en la que varias personas pueden colaborar en varios proyectos a la vez
Si te estás conectando a una instancia de GitHub Enterprise Server, marca la casilla **Usar GitHub Enterprise Server** e introduce la URL HTTPS de la instancia (por ejemplo,`https://github.example.com`).
Si su instancia de GitHub Enterprise Server no es de acceso público, si lo desea, puede configurar una conexión privada para que el AWS DevOps agente pueda acceder a su instancia de forma segura. Para obtener más información, consulte [Conexión a herramientas alojadas de forma privada](configuring-capabilities-for-aws-devops-agent-connecting-to-privately-hosted-tools.md).
**nota**
**No incluyas `/api/v3` ni ninguna ruta final en la URL; introduce solo la URL base.
### Paso 3: Configura la aplicación GitHub
Haga clic en **Enviar** para iniciar el proceso de configuración de la aplicación. Los siguientes pasos varían en función de si se conecta a GitHub .com o GitHub Enterprise Server.
#### Para GitHub .com
1. Se te redirigirá a GitHub para instalar la GitHub aplicación AWS DevOps Agent.
1. Seleccione en qué cuenta u organización desea instalar la aplicación.
1. La aplicación permite al AWS DevOps agente recibir eventos de los repositorios conectados, incluidos los eventos de despliegue.
#### Para GitHub Enterprise Server
GitHub Enterprise Server usa un flujo de manifiesto de GitHub aplicaciones, que configura automáticamente una nueva GitHub aplicación en la instancia. Esto implica dos redireccionamientos a tu instancia de GitHub Enterprise Server.
1. El navegador se redirigirá a la página «Crear GitHub aplicación» de la instancia de GitHub Enterprise Server.
1. Verás el nombre de la aplicación rellenado previamente. No dudes en cambiar el nombre según sea necesario. Haz clic en **Crear GitHub aplicación**.
1. Se te redirigirá de nuevo a AWS DevOps Agent, que intercambia el código del manifiesto por las credenciales de la aplicación.
### Paso 4: Selecciona los repositorios y completa la instalación
1. Verás la página de **instalación y autorización** de la GitHub aplicación.
1. Selecciona a qué repositorios quieres permitir el acceso de la aplicación:
+ **Todos los repositorios**: otorga acceso a todos los repositorios actuales y futuros
+ **Selecciona solo repositorios**: elige repositorios específicos de tu cuenta u organización
1. Haz clic en **Instalar y autorizar**.
1. Se le redirigirá de nuevo a la consola del AWS DevOps agente, donde GitHub aparecerá como registrado a nivel de cuenta.
## Conectar los repositorios a un espacio de agentes
Tras registrarse GitHub a nivel de cuenta, puede conectar repositorios específicos a espacios de agente 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 **GitHub**de la lista de proveedores disponibles
1. Seleccione el subconjunto de repositorios correspondiente a este espacio de agentes
1. Haga clic en **Agregar** para completar la conexión
Puede conectar diferentes conjuntos de repositorios a diferentes espacios de agentes en función de las necesidades de su organización.
## Entender la aplicación GitHub
La GitHub aplicación AWS DevOps Agent:
+ Solicita acceso de solo lectura a tus repositorios
+ Recibe eventos de despliegue y otros eventos del repositorio
+ Permite al AWS DevOps agente correlacionar los cambios de código con los incidentes operativos
+ Se puede desinstalar en cualquier momento a través de su configuración GitHub
En el caso de GitHub Enterprise Server, la GitHub aplicación se crea automáticamente en la instancia durante el registro. Puede administrar el acceso al repositorio de la aplicación o desinstalarla **desde Configuración > Aplicaciones > GitHub Aplicaciones instaladas**. Para eliminar por completo la definición de la aplicación, ve a **Configuración > Configuración del desarrollador > GitHub Aplicaciones**.
## Administrar GitHub las conexiones
+ **Actualización del acceso a los repositorios**: para cambiar a qué repositorios puede acceder la GitHub aplicación, vaya a la configuración de su GitHub cuenta u organización (o a la configuración de la instancia de GitHub Enterprise Server), vaya a GitHub las aplicaciones instaladas y modifique la configuración de la aplicación AWS DevOps Agent.
+ **Visualización de los repositorios conectados**: en la consola del AWS DevOps agente, seleccione su espacio de agente y vaya a la pestaña Capacidades para ver los repositorios conectados en la sección Pipeline.
+ **Eliminar una GitHub conexión****: para desconectarse GitHub de un espacio de agentes, seleccione la conexión en la sección Pipeline y haga clic en Eliminar.** Para desinstalar la GitHub aplicación por completo, desinstálela de la configuración de su GitHub cuenta u organización. En el caso de GitHub Enterprise Server, dado que la GitHub aplicación se crea directamente en la instancia durante el registro, si lo desea, puede limpiarla por completo realizando las dos acciones siguientes:
+ **Desinstale la aplicación**: vaya a **Configuración > Aplicaciones > GitHub Aplicaciones instaladas**, haga clic en **Configurar** en la aplicación y, a continuación, desinstálela.
+ **Elimine la aplicación**: vaya a **Configuración > Configuración del desarrollador > GitHub Aplicaciones**, seleccione la aplicación, vaya a la pestaña **Opciones avanzadas** y elija **Eliminar GitHub aplicación**. **Advertencia:** la eliminación de la GitHub aplicación es permanente y no se puede deshacer. Si la elimina, tendrá que volver a registrar GitHub Enterprise Server desde el principio en la consola del AWS DevOps agente para crear una nueva aplicación.
# Conectando GitLab
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)
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
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
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
**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
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
+ **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.