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 eventos de implementación 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 Agent Spaces individuales.
AWS DevOps Instancias compatibles con Agent GitHub.com (SaaS), GitHub Enterprise Cloud con residencia de datos (*.ghe.com) e instancias de GitHub Enterprise Server (autohospedadas).
Puedes registrarte de dos GitHub maneras. El registro de la aplicación instala la GitHub aplicación AWS DevOps Agent en su cuenta u organización. La GitHub aplicación admite webhooks y permisos detallados, y la recomendamos para la mayoría de los casos de uso. El token de acceso personal se autentica con un token de tu cuenta. GitHub Utilízalo para el acceso individual cuando no necesites funciones basadas en webhooks. Para obtener más información, consulta Registrarse GitHub con un token de acceso personal.
Requisitos previos
Antes de conectarte GitHub, confirma que cumples los siguientes requisitos previos:
Tiene acceso a la consola de administración del AWS DevOps agente.
Tiene una cuenta GitHub de usuario u organización con permisos de administrador.
Para el registro de aplicaciones, tienes autorización para instalar GitHub aplicaciones en tu cuenta u organización.
Para registrar un token de acceso personal, dispones de un token de acceso personal con los permisos descritos en Crear un token de acceso personal.
En el GitHub caso de Enterprise Server, confirme también lo siguiente:
Tiene una instancia de GitHub Enterprise Server (versión 3.x o posterior) a la que se puede acceder mediante HTTPS.
Tienes la URL HTTPS de tu instancia de GitHub Enterprise Server (por ejemplo,
https://github.example.com).(Opcional) Tienes una conexión privada si tu instancia de GitHub Enterprise Server no es de acceso público.
En el GitHub caso de Enterprise Cloud con residencia de datos, confirma también lo siguiente:
Tienes una organización de GitHub Enterprise Cloud con la residencia de datos habilitada y alojada en tu
*.ghe.comsubdominio dedicado.Tienes permisos de administrador de la organización, incluido el permiso para crear e instalar GitHub aplicaciones.
Tienes la URL HTTPS de tu instancia de residencia de datos (por ejemplo,
https://octocorp.ghe.com).
Registrarse GitHub (a nivel de cuenta)
GitHub se registra a nivel de AWS cuenta y se comparte entre todos los espacios de agente de esa cuenta. Cada registro corresponde a un GitHub usuario, una organización o una instancia de GitHub Enterprise Server.
Paso 1: Diríjase a los proveedores de canalizaciones
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 Canalización, elige Agregar
Selecciona 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 Registrar una GitHub cuenta u organización, en Tipo de conexión, elija cómo se conecta el AWS DevOps agente a GitHub:
Registro de la aplicación (recomendado): instale la GitHub aplicación AWS DevOps Agent en su cuenta u organización. La GitHub aplicación admite webhooks y permisos detallados. Continúa con el paso 3.
Token de acceso personal: autentica con un token de acceso personal de tu GitHub cuenta. Esta opción proporciona acceso individual y no admite webhooks. Omita los pasos restantes de esta sección y consulte Registrarse GitHub con un token de acceso personal.
Paso 3: Configurar el registro de la GitHub aplicación
Selecciona si te estás conectando como usuario u organización:
Usuario: tu 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 seleccionas Organización, introduce el nombre de la GitHub organización. El nombre debe coincidir exactamente con el nombre de tu GitHub organización, ya que debes autorizar e instalar la aplicación en esa organización siguiendo estos pasos.
Selecciona los permisos de la GitHub aplicación para tu GitHub aplicación. El nivel de permiso determina las acciones que la GitHub aplicación puede realizar en tu repositorio:
Lectura y escritura (predeterminado): la GitHub aplicación solicita permisos de lectura y escritura. Esto habilita todas las funciones. DevOps El agente puede publicar comentarios de solicitudes de extracción en línea, proponer soluciones y activar flujos de trabajo.
Solo lectura: la GitHub aplicación solo solicita permisos de lectura. DevOps El agente puede ver el código y las solicitudes de extracción, pero no puede publicar comentarios, proponer correcciones ni activar flujos de trabajo.
Método de verificación
En Método de verificación, elige cómo el AWS DevOps agente confirma que la GitHub aplicación está instalada en la cuenta u organización que especificaste:
Browser-based devolución de llamada (predeterminado): cuando seleccionas Enviar, el AWS DevOps agente te redirige GitHub a para que autorices la GitHub aplicación y, si es necesario, la instales. Continúe con el paso 4.
Verifique con un token de acceso personal: introduzca un token de acceso personal. AWS DevOps El agente usa el token una vez para confirmar que la GitHub aplicación está instalada en la cuenta u organización que especificaste y, a continuación, lo descarta. El token no se almacena. El registro finaliza cuando seleccionas Enviar, sin redireccionar a GitHub.
Usa Verify con un token de acceso personal cuando la GitHub aplicación ya esté instalada. Por ejemplo, úsalo cuando conectes la misma organización desde otra AWS cuenta o región. Si la GitHub aplicación aún no está instalada, regístrate primero con Browser-based callback.
El token de verificación necesita los siguientes permisos:
En el caso de una organización, el propietario del token debe ser el propietario de una organización. El token también necesita el permiso de lectura de la organización. Para un token clásico, usa el
read:orgvisor. Para obtener un token más detallado, usa el permiso Administración: Read-only organización.En el caso de una cuenta personal, el token no necesita alcances adicionales.
nota
La verificación con un token de acceso personal solo está disponible para GitHub.com. Para GitHub Enterprise Server y GitHub Enterprise Cloud con residencia de datos, utilice la función Browser-based callback.
Si te estás conectando a una instancia de GitHub Enterprise Server, elige Usar GitHub Enterprise e introduce la URL HTTPS de tu 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 permitir que el AWS DevOps Agente acceda a su instancia de forma segura. Para obtener más información, consulte Conexión a herramientas alojadas de forma privada.
nota
No incluya /api/v3 ninguna ruta final en la URL; introduzca solo la URL base.
En el caso de la nube GitHub empresarial con residencia de datos, elija Usar GitHub empresa e introduzca la URL HTTPS de su instancia de residencia de datos (por ejemplo,https://octocorp.ghe.com).
Paso 4: Configurar la GitHub aplicación
Seleccione Enviar para iniciar el proceso de configuración de la aplicación. Los pasos siguientes varían en función de si te GitHub.com conectas a GitHub Enterprise Server o GitHub Enterprise Cloud con residencia de datos.
Si seleccionaste Verificar con un token de acceso personal en el paso 3, el registro se completará sin necesidad de redireccionar. Omita los pasos 4 y 5.
Para GitHub.com
GitHub lo redirige para iniciar sesión y autorizar al AWS DevOps Agente.
Revisa la solicitud de autorización y autoriza al AWS DevOps Agente.
Tras la autorización, el AWS DevOps agente completa el registro. Si la GitHub aplicación aún no está instalada en la cuenta u organización que especificó, vaya a la página de instalación (consulte el paso 5). Si la aplicación ya está instalada, el registro finaliza sin volver a instalarla.
Tras la instalación, el AWS DevOps agente recibe los eventos de los repositorios conectados, incluidos los eventos de implementación.
nota
Debe autorizar e instalar la aplicación en el mismo usuario u organización que especificó durante el registro. Si autorizas o instalas en una cuenta u organización diferente, el registro fallará y tendrás que reiniciar el proceso seleccionando la cuenta u organización correcta.
nota
AWS DevOps El agente usa una GitHub aplicación diferente para cada nivel de permiso (lectura y escritura y solo lectura), y cada aplicación se autoriza de forma independiente. GitHub recuerda una autorización hasta que la revoques en Configuración > Aplicaciones > GitHub Aplicaciones autorizadas. Si anteriormente autorizaste la aplicación con este nivel de permisos, es GitHub posible que omitas la pantalla de autorización. Si cambias el nivel de permiso, te GitHub pedirá que autorices la aplicación correspondiente la primera vez.
Para GitHub Enterprise Server y GitHub Enterprise Cloud con residencia de datos
GitHub Tanto Enterprise Server como GitHub Enterprise Cloud con residencia de datos utilizan el flujo GitHub App Manifest, que configura automáticamente una nueva GitHub aplicación en la instancia. Durante la configuración, el navegador se redirige dos veces: una vez a la instancia y otra al AWS DevOps agente.
AWS DevOps El agente redirige el navegador a la página de creación de GitHub aplicaciones de la instancia GitHub empresarial.
El nombre de la aplicación está precargado. Cambia el nombre si es necesario y, a continuación, selecciona Crear GitHub aplicación.
Cuando el AWS DevOps agente vuelve a redirigir el navegador, intercambia el código de manifiesto por las credenciales de la aplicación.
Paso 5: Seleccione los repositorios y complete la instalación
Omita este paso si la GitHub aplicación ya está instalada en su cuenta u organización.
Aparece la página de instalación y autorización de la GitHub aplicación.
Selecciona los repositorios a los que quieres permitir el acceso de la aplicación:
Todos los repositorios: otorga acceso a todos los repositorios actuales y futuros
Solo selecciona repositorios: elige repositorios específicos de tu cuenta u organización
Elija Instalar y autorizar.
Se te redirigirá de nuevo a la consola del AWS DevOps agente, donde GitHub aparecerá como registrado a nivel de cuenta.
Registrarse GitHub con un token de acceso personal
El registro de un token de acceso personal se conecta GitHub sin necesidad de instalar la GitHub aplicación AWS DevOps Agent. AWS DevOps El agente almacena el token y lo usa para autenticar las solicitudes de GitHub API en su nombre. Usa esta opción cuando no puedas instalar una GitHub aplicación o cuando solo necesites acceder a un repositorio individual sin funciones basadas en webhooks.
El registro de un token de acceso personal admite GitHub.com GitHub Enterprise Server y GitHub Enterprise Cloud con residencia de datos. Para una instancia de GitHub Enterprise Server que no sea de acceso público, puedes usar una conexión privada.
Tenga en cuenta las siguientes limitaciones antes de elegir esta opción:
Sin webhooks: GitHub no envía eventos de webhooks a un registro de token de acceso personal. AWS DevOps El agente no recibe eventos en tiempo real, como notificaciones de solicitud de extracción, push o despliegue. Las revisiones automatizadas del código de preparación para la publicación y las pruebas de verificación automatizadas no se activan en los repositorios conectados mediante el registro de un token de acceso personal. Aún puedes solicitar la revisión del código de preparación para su lanzamiento a través del chat del DevOps agente o mediante integraciones con agentes de codificación. Para obtener más información, consulte Revisiones del código de preparación para el lanzamiento. Si necesitas eventos en tiempo real, utiliza el registro de aplicaciones.
El acceso al repositorio sigue al token: cuando asignas el registro a una organización, el AWS DevOps agente muestra los repositorios de esa organización a los que puede acceder el token. Cuando conectas la cuenta personal del propietario del token, el AWS DevOps agente muestra solo los repositorios que posee el propietario del token. El agente solo puede realizar las operaciones que permite el token.
Sin actualización del token: no puede actualizar el token de un GitHub registro existente. Para reemplazar un token caducado o rotado, anula el registro y vuelve a registrarlo con el GitHub nuevo token. A continuación, vuelve a conectar los repositorios a tus espacios de agente.
Crear un token de acceso personal
Crea el token GitHub antes de registrarte. Puedes usar un token clásico o uno detallado.
Para un token clásico, selecciona los siguientes alcances:
repo— Necesario para leer el contenido y los metadatos del repositorioread:org— Es obligatorio cuando se asigna el registro a una organización. AWS DevOps El agente lo usa para confirmar que el propietario del token es un miembro activo de la organización.
Para obtener un token detallado, configure lo siguiente:
Si asignas el registro a una organización, establece como propietario del recurso a esa organización. Seleccione los repositorios a los que puede acceder el AWS DevOps agente.
En Permisos del repositorio, conceda Contenido: Read-only y Metadatos: Read-only.
En Permisos de organización, otorga a los miembros: Read-only cuando asignes el registro a una organización.
Establece una fecha de caducidad que se ajuste a tu política de seguridad. AWS DevOps El agente no puede renovar el token. Antes de que caduque el token, cree uno nuevo, anule el GitHub registro y vuelva a registrarlo.
Registrarse con un token de acceso personal
Complete el paso 1: diríjase a los proveedores de tuberías.
En la pantalla Registrar una GitHub cuenta u organización, en Tipo de conexión, elige el token de acceso personal.
En Token de acceso personal, introduce tu token.
(Opcional) Configure los siguientes campos:
GitHub organización: introduzca el nombre de la organización a la que va dirigido el registro. El propietario del token debe ser un miembro activo de la organización. Deje este campo en blanco para conectar la GitHub cuenta personal del propietario del token. Este campo es obligatorio al introducir una URL de residencia de datos en una nube GitHub empresarial.
GitHub URL empresarial: introduzca la URL raíz HTTPS de su instancia GitHub empresarial (por ejemplo,
https://github.example.comohttps://octocorp.ghe.com). Esto se aplica a GitHub Enterprise Server y GitHub Enterprise Cloud con residencia de datos. Deje este campo en blanco para conectarse GitHub.com. No incluya/api/v3ninguna ruta final.Conexión privada: si su instancia de GitHub Enterprise Server no es de acceso público, seleccione una conexión privada. Para obtener más información, consulte Conexión a herramientas alojadas de forma privada.
Elige Enviar. AWS DevOps El agente valida el token con el propietario del token GitHub y confirma su identidad. Cuando ingresas a una organización, también confirma que el propietario del token es un miembro activo de esa organización.
Una vez completado el registro, GitHub aparece como registrado a nivel de cuenta. Conecte los repositorios a sus espacios de agente tal y como se describe en Conectar repositorios a un espacio de agente.
Solución de problemas con el registro de tokens de acceso personal
Si se produce un error al registrarse con un token de acceso personal, compare el mensaje de error con el de la lista siguiente.
Invalid GitHub personal access token— El token no es válido o ha caducado. Crea un nuevo token e inténtalo de nuevo.GitHub personal access token does not have sufficient permissions— Añada elrepoalcance a un token clásico o conceda acceso de lectura a los repositorios que pretenda usar con un token detallado.The GitHub token's user is not a member of organization "<name>"— Verifica el nombre de la organización. Confirme que el token tiene elread:orgalcance (clásico) o el acceso de lectura de los miembros de la organización (detallado).membership in organization "<name>" is "<state>", not active— El propietario del token tiene pendiente una invitación a la organización. Acepta la invitación e inténtalo de nuevo.Failed to reach GitHub— Compruebe la URL GitHub empresarial y la configuración de su red. Para obtener información sobre una conexión privada, consulteSolución de problemas de conexiones privadas.A GitHub service for "<owner>" is already registered with this account— La AWS cuenta ya tiene un registro para esta GitHub cuenta u organización. Usa el registro existente o anula primero el registro.
Los siguientes errores se aplican a Verify con un token de acceso personal:
The DevOps Agent GitHub App is not installed on the requested organization or account— Regístrese primero con Browser-based callback para instalar la GitHub aplicación y, a continuación, vuelva a intentarlo.You do not have permission to install or access the DevOps Agent GitHub App on this organization— Usa una GitHub cuenta con permisos de propietario (administrador) en la organización.GitHub App verification is only supported for github.com— En el GitHub caso de Enterprise Server y GitHub Enterprise Cloud con residencia de datos, utilice la función Browser-based callback.
Conexión de 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 del AWS DevOps agente, seleccione su espacio de agente
Vaya a la pestaña Capacidades
En la sección Canalización, elige Agregar
Selecciona GitHub de la lista de proveedores disponibles
Seleccione el GitHub registro que contiene los repositorios que desea usar
Seleccione el subconjunto de repositorios relevante para este espacio de agentes
Elija Agregar para completar la conexión
Puede conectar diferentes conjuntos de repositorios a diferentes espacios de agente en función de las necesidades de su organización. Un único espacio de agente puede usar repositorios de varios registros. Para agregar repositorios de otro registro, repita estos pasos.
Configuración de la revisión de código y las pruebas automatizadas
Al seleccionar los repositorios en la etapa de GitHub 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 repositorios que activan automáticamente las funciones de prueba automática Revisiones del código de preparación para el lanzamiento y automática.
nota
Los activadores automáticos dependen de los eventos de webhook de la aplicación. GitHub En el caso de los repositorios conectados mediante el registro de un token de acceso personal, no se realizan revisiones ni pruebas automatizadas. En su lugar, solicita una revisión del código de preparación para la publicación a través del chat con el DevOps agente o mediante integraciones con los agentes de codificación.
La configuración de revisión del código y pruebas automatizadas incluye:
Capacidades: elija funciones de revisión de código y pruebas automatizadas para cada repositorio. La sección proporciona dos configuraciones por repositorio:
Activar automáticamente la revisión de cambios: cuando está habilitada para un repositorio, 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 extracción. Los resultados de la revisión aparecen como comentarios en línea en la solicitud de extracción. Esta opción está habilitada de forma predeterminada para todos los repositorios conectados.
Pruebas de verificación automatizadas: cuando está habilitada para un repositorio, 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 repositorios conectados.
Lista de repositorios: muestra todos los repositorios que seleccionó durante el paso de conexión. Usa el campo de búsqueda para filtrar los repositorios por nombre. Cada repositorio 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 repositorios 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:
Tras conectar tus repositorios, dirígete a la sección Revisión del código y pruebas automatizadas en la configuración de GitHub integración.
En cada repositorio, habilita o deshabilita la función de activación automática de la revisión de cambios en función de si quieres que se revisen automáticamente las solicitudes de extracción.
Para cada repositorio, 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.
De manera opcional, selecciona una función de IAM en el menú desplegable de funciones en tiempo de ejecución que asumirá el DevOps agente cuando ejecute las funciones automatizadas en los repositorios seleccionados.
Seleccione Guardar para aplicar la configuración.
Una vez configurada, cualquier nueva solicitud de extracción en un repositorio 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.
Configuración avanzada: filtros de activación
De forma predeterminada, un repositorio con la función Activar automáticamente la revisión de cambios ejecuta una revisión del código de disponibilidad para el lanzamiento en cada evento de solicitud de incorporación de cambios aplicable, en cualquier sucursal de destino. Usa la configuración avanzada para añadir filtros de activación que controlen exactamente cuándo se ejecutan las revisiones automatizadas en cada repositorio.
Cada filtro es un grupo de filtros que combina dos condiciones:
Ramas de destino (obligatorio): uno o más nombres o patrones de rama, introducidos como expresiones regulares (por ejemplo,
mainorelease/.*). La revisión solo se activa cuando la rama objetivo (base) de la solicitud de extracción coincide con uno de estos patrones.Eventos desencadenantes (opcional): los eventos de la solicitud de extracción que activan una revisión: la solicitud de extracción está lista para su revisión o la solicitud de extracción está redactada. Déjalo vacío para que coincida con todos los eventos aplicables.
Dentro de un grupo de filtros, todas las condiciones deben coincidir (AND). Puedes añadir varios grupos de filtros y se activará una revisión cuando algún grupo coincida (OR).
Para configurar los filtros de activación:
Abra la sección de configuración avanzada en el flujo de conexión. (Para cambiar los filtros de una conexión existente, seleccione la conexión en la sección Canalización, elija Editar y, a continuación, abra Configuración avanzada).
Busque el repositorio que desea configurar y seleccione la pestaña Revisión de cambios.
Elige Agregar grupo de filtros y, a continuación, define las condiciones del grupo:
En Sucursales de destino, introduce el nombre o patrón de una sucursal y presiona Entrar o elige Agregar. Repite el procedimiento para añadir más patrones.
(Opcional) En Activar eventos, selecciona Solicitud de extracción lista para su revisión, Solicitud de extracción redactada o ambas. Déjalo vacío para que coincida con todos los eventos.
(Opcional) Vuelva a elegir Agregar grupo de filtros para expresar condiciones alternativas.
Seleccione Guardar para aplicar la configuración.
Puede definir hasta 5 grupos de filtros por repositorio, con hasta 20 patrones por grupo. Cada patrón debe ser una expresión regular válida de hasta 256 caracteres. Si no añades ningún grupo de filtros, las revisiones se activan en todos los eventos aplicables a todas las sucursales de destino.
Comprensión de la GitHub aplicación
La GitHub aplicación AWS DevOps Agent:
Solicita el acceso a tus repositorios; puedes revisar los permisos específicos durante la instalación de GitHub la aplicación
Recibe los eventos de implementación 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 y GitHub Enterprise Cloud con residencia de datos, el AWS DevOps agente crea automáticamente la GitHub aplicación en su instancia durante el registro. Puedes gestionar el acceso al repositorio de la aplicación o desinstalarla en Configuración > Aplicaciones > GitHub Aplicaciones instaladas. Para eliminar por completo la definición de la aplicación, ve a Configuración > Configuración para desarrolladores > 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 suceda:
Recibirás una notificación de GitHub sobre la solicitud de actualización del permiso.
Revisa los detalles de la actualización para saber qué nuevos permisos se solicitan.
Seleccione Aceptar nuevos permisos para conceder los permisos actualizados.
No se requieren cambios en su servicio o aplicación. Tras aceptar 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 la actualización de los permisos, el AWS DevOps Agente seguirá funcionando con los permisos concedidos anteriormente. Las nuevas funciones que dependan de los permisos actualizados no estarán disponibles hasta que apruebe la solicitud. La aplicación conservará sus permisos actuales si decides no aceptar los nuevos permisos.
Permisos de solicitados
La siguiente tabla describe cada permiso que solicita la GitHub aplicación del AWS DevOps agente y por qué es necesario.
Si seleccionó la opción de solo lectura durante el registro, la GitHub aplicación solo solicita el acceso de nivel de lectura para cada permiso de la tabla siguiente. Con los permisos de solo lectura, la GitHub aplicación no puede realizar las acciones de nivel de escritura que figuran en la columna Propósito.
| Permiso | Nivel de acceso | Finalidad |
|---|---|---|
| Verificaciones | Leer y escribir | Tras revisar el estado de preparación del código para su publicación, revisa los resultados a medida que se van comprobando las solicitudes de cambios, lo que permite que el estado de la revisión aparezca directamente en la GitHub interfaz de usuario. |
| Flujos de trabajo | Lee y escribe | Lee las definiciones de los flujos de trabajo y activa los flujos de trabajo de GitHub Actions para probar las versiones en CI/CD tus procesos. |
| Acciones | Lee y escribe | Supervise la ejecución del flujo de trabajo de GitHub Actions y acceda a los registros de ejecución durante las investigaciones de incidentes y las pruebas de lanzamiento. |
| Contenido | Lee y escribe | Lea el código fuente del repositorio para revisar el código, analizar y mapear las dependencias. El acceso de escritura permite al agente proponer soluciones para los problemas identificados. |
| Solicitudes de extracción | Lee y escribe | Lee los detalles de las solicitudes de extracción para activar las revisiones de código automatizadas. El acceso por escritura permite publicar comentarios de revisión en línea con los hallazgos y las soluciones recomendadas. |
| Administración de la organización | Lectura | Lea la lista de aplicaciones instaladas en la organización de destino para comprobar que la GitHub aplicación del AWS DevOps agente esté instalada. |
Administrar GitHub las conexiones
Actualización del acceso al repositorio: para cambiar los repositorios a los que puede acceder la GitHub aplicación, ve a la configuración de tu GitHub cuenta u organización. Para GitHub Enterprise Server o GitHub Enterprise Cloud con residencia de datos, ve a la configuración de tu instancia. A continuación, navegue hasta GitHub las aplicaciones instaladas y modifique la configuración de la aplicación del AWS DevOps agente.
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 Canalización.
Sustitución de un token de acceso personal: no puedes actualizar el token de un registro existente GitHub . Para reemplazar un token, anule el registro en la página de proveedores de capacidades. A continuación, GitHub vuelva a registrarse con el nuevo token y vuelva a conectar los repositorios a sus espacios de agente. Revoca el token antiguo en tu configuración. GitHub
Eliminar la GitHub conexión: para desconectarse GitHub de un espacio de agente, elija la conexión en la sección Canalización y, a continuación, seleccione Eliminar. Para eliminar el GitHub registro de tu cuenta, dirígete a la página de proveedores de capacidades, localiza tu registro en la GitHub sección y selecciona Anular registro.
Para eliminar por completo la GitHub integración, haga lo siguiente:
Para desinstalar la GitHub aplicación, ve a la configuración de tu GitHub cuenta u organización.
Para volver a conectarse, vuelva a registrarse GitHub en la consola del AWS DevOps agente.
En el caso de GitHub Enterprise Server y GitHub Enterprise Cloud con residencia de datos, el AWS DevOps agente crea la GitHub aplicación en su instancia durante el registro. Para limpiar la aplicación por completo, realiza las dos siguientes acciones:
Desinstala la aplicación: ve a Configuración > Aplicaciones > GitHub Aplicaciones instaladas, selecciona Configurar en la aplicación y, a continuación, desinstálala.
Eliminar la aplicación: ve a Configuración > Configuración de desarrollador > GitHub Aplicaciones, elige la aplicación, ve a la pestaña Avanzadas y elige Eliminar GitHub aplicación. Advertencia: la eliminación de la GitHub aplicación es permanente y no se puede deshacer. Para crear una aplicación nueva, vuelva a registrarse GitHub en la consola del AWS DevOps agente.
