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 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 u 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
Registro 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
Inicie sesión en la consola AWS de administración
Navegue hasta la consola del AWS DevOps agente
Vaya a la pestaña Capacidades
En la sección Pipeline, haga clic en Agregar
Seleccione GitHubde 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.
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
Se te redirigirá a GitHub para instalar la GitHub aplicación AWS DevOps Agent.
Seleccione en qué cuenta u organización desea instalar la aplicación.
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 utiliza 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.
El navegador se redirigirá a la página «Crear GitHub aplicación» de la instancia de GitHub Enterprise Server.
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.
Se te redirigirá de nuevo al AWS DevOps Agente, que intercambia el código del manifiesto por las credenciales de la aplicación.
Paso 4: Selecciona los repositorios y completa la instalación
Verás la página de instalación y autorización de la GitHub aplicación.
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
Haz clic en Instalar y autorizar.
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:
En la consola de AWS DevOps agentes, selecciona tu espacio de agente
Ve a la pestaña Capacidades
En la sección Pipeline, haga clic en Agregar
Seleccione GitHubde la lista de proveedores disponibles
Seleccione el subconjunto de repositorios correspondiente a este espacio de agentes
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 a tus repositorios: puedes revisar los permisos específicos durante la instalación de GitHub la aplicación
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.
GitHub Actualizaciones de permisos de aplicaciones
AWS DevOps El agente puede solicitar actualizaciones de permisos después de instalar la GitHub aplicación para admitir nuevas funciones. Cuando esto sucede:
Recibirá una notificación de parte de usted en GitHub relación con la solicitud de actualización del permiso.
Revisa los detalles de la actualización para saber qué permisos nuevos se están solicitando.
Acepte la solicitud para conceder los permisos actualizados.
No es necesario realizar cambios en su servicio o aplicación. Una vez que acepte los permisos actualizados, el siguiente token de acceso a la instalación que solicite el AWS DevOps agente GitHub incluirá automáticamente los nuevos permisos.
nota
Hasta que acepte una actualización de permisos, el AWS DevOps agente seguirá funcionando con los permisos concedidos anteriormente. Las nuevas capacidades que dependan de los permisos actualizados no estarán disponibles hasta que usted apruebe la solicitud.
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.
