Seleccione sus preferencias de cookies

Usamos cookies esenciales y herramientas similares que son necesarias para proporcionar nuestro sitio y nuestros servicios. Usamos cookies de rendimiento para recopilar estadísticas anónimas para que podamos entender cómo los clientes usan nuestro sitio y hacer mejoras. Las cookies esenciales no se pueden desactivar, pero puede hacer clic en “Personalizar” o “Rechazar” para rechazar las cookies de rendimiento.

Si está de acuerdo, AWS y los terceros aprobados también utilizarán cookies para proporcionar características útiles del sitio, recordar sus preferencias y mostrar contenido relevante, incluida publicidad relevante. Para aceptar o rechazar todas las cookies no esenciales, haga clic en “Aceptar” o “Rechazar”. Para elegir opciones más detalladas, haga clic en “Personalizar”.

Preferencias
Contacte con nosotros
Comentarios
AWS Documentation
Cree una cuenta AWS

GitHub Conexiones de aplicaciones para GitHub un servidor GitHub empresarial

PDF
RSS
Modo de enfoque
GitHub Conexiones de aplicaciones para GitHub un servidor GitHub empresarial - AWS CodeBuild
Paso 1: Crear una conexión a la GitHub aplicación (consola)Paso 2: Otorgue acceso al rol de IAM del CodeBuild proyecto para usar la conexiónPaso 3: CodeBuild Configúralo para usar la nueva conexiónSolución de problemas de la GitHub aplicación

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.

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.

Puede usar GitHub la aplicación para conectarse con CodeBuild. GitHub Las conexiones de aplicaciones son compatibles a través de AWS CodeConnections.

El acceso del proveedor de origen te permite activar una compilación suscribiéndote al GitHub eventos de webhook uso CreateWebhooko al uso Tutorial: Configurar un ejecutor CodeBuild de Actions alojado GitHub en CodeBuild.

nota

CodeConnections está disponible en menos regiones que. CodeBuild Puede utilizar conexiones entre regiones en CodeBuild. Las conexiones creadas en regiones de suscripción no se pueden usar en otras regiones. Para obtener más información, consulte Puntos de conexión y cuotas de AWS CodeConnections.

Paso 1: Crear una conexión a la GitHub aplicación (consola)

Sigue estos pasos para usar la CodeBuild consola y añadir una conexión a tu proyecto GitHub.

Para crear una conexión a GitHub
nota

En lugar de crear o usar una conexión existente en tu cuenta, puedes usar una conexión compartida desde otra AWS cuenta. Para obtener más información, consulta Compartir conexiones con AWS cuentas.

Paso 2: Otorgue acceso al rol de IAM del CodeBuild proyecto para usar la conexión

Puedes conceder acceso a la función de IAM del CodeBuild proyecto para usar los GitHub tokens que vende tu conexión.

Para conceder acceso a la función de CodeBuild IAM del proyecto

  1. Cree un rol de IAM para su CodeBuild proyecto siguiendo las instrucciones CodeBuild Permiten interactuar con otros servicios AWS para su CodeBuild proyecto.

  2. Siguiendo las instrucciones, añada la siguiente política de IAM a su rol en el CodeBuild proyecto para conceder el acceso a la conexión.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "codeconnections:GetConnectionToken",
        "codeconnections:GetConnection"
      ],
      "Resource": [
        <connection-arn>
      ]
    }
  ]
}

Paso 3: CodeBuild Configúralo para usar la nueva conexión

Puede configurar una conexión como credencial de cuenta y usarla en un proyecto.

AWS Management Console
Para configurar una conexión como una credencial a nivel de cuenta en el AWS Management Console

  1. En Proveedor de origen, elija GitHub.

  2. En Credencial, realice una de las siguientes acciones:

    • Elija Credencial de origen predeterminada para aplicar la credencial de origen predeterminada de su cuenta a todos los proyectos.

      1. Si no está conectado a GitHub, elija Administrar la credencial de origen predeterminada.

      2. En Tipo de credencial, selecciona GitHub Aplicación.

      3. En Conexión, elija usar una conexión existente o cree una nueva.

    • Elija Credencial de origen personalizada a fin de usar una credencial de este tipo para anular la configuración predeterminada de su cuenta.

      1. En Tipo de credencial, elija GitHub Aplicación.

      2. En Conexión, elija usar una conexión existente o cree una nueva.

AWS CLI
Para configurar una conexión como una credencial a nivel de cuenta en AWS CLI

  • Abra un terminal (Linux, macOS o Unix) o un símbolo del sistema (Windows). Utilice el AWS CLI para ejecutar el import-source-credentials comando, especificando el --auth-type--server-type, y --token para la conexión.

    Utilice el siguiente comando :

    aws codebuild import-source-credentials --auth-type CODECONNECTIONS --server-type GITHUB --token <connection-arn>
anchoranchor
Para configurar una conexión como una credencial a nivel de cuenta en el AWS Management Console

  1. En Proveedor de origen, elija GitHub.

  2. En Credencial, realice una de las siguientes acciones:

    • Elija Credencial de origen predeterminada para aplicar la credencial de origen predeterminada de su cuenta a todos los proyectos.

      1. Si no está conectado a GitHub, elija Administrar la credencial de origen predeterminada.

      2. En Tipo de credencial, selecciona GitHub Aplicación.

      3. En Conexión, elija usar una conexión existente o cree una nueva.

    • Elija Credencial de origen personalizada a fin de usar una credencial de este tipo para anular la configuración predeterminada de su cuenta.

      1. En Tipo de credencial, elija GitHub Aplicación.

      2. En Conexión, elija usar una conexión existente o cree una nueva.

También puedes configurar varios tokens para tus CodeBuild proyectos. Para obtener más información, consulte Configuración de varios tokens como credenciales de origen.

Solución de problemas con la GitHub aplicación

La siguiente información puede ayudarle a solucionar problemas comunes con la GitHub aplicación.

Instale el AWS conector para la GitHub aplicación en una región no deseada

Problema: instalaste el AWS conector GitHub desde GitHub Marketplace, pero la conexión se creó en una región no deseada. Si intentas volver a configurar la aplicación en el GitHub sitio web, no funcionará porque la aplicación ya está instalada en tu GitHub cuenta.

Causa posible: la aplicación ya está instalada en tu GitHub cuenta, por lo que solo puedes volver a configurar los permisos de la aplicación.

Solución recomendada: Puede crear una conexión con el ID de instalación en la región deseada.

  1. Abre la CodeConnections consola en los https://console.aws.amazon.com/codesuite/ajustes o conexiones y navega hasta la región deseada con el selector de regiones de la barra de navegación de la AWS consola.

  2. Siga las instrucciones de la Guía del usuario de las herramientas para desarrolladores para crear una conexión a. GitHub

    nota

    Como ya ha instalado el AWS conector para la GitHub aplicación, puede elegirlo en lugar de instalar una aplicación nueva.

La conexión de la GitHub aplicación no tiene acceso a los repositorios

Problema: un AWS servicio que utiliza la conexión, como CodeBuild o CodePipeline, informa que no tiene acceso al repositorio o que el repositorio no existe. Estos son algunos de los posibles mensajes de error:

  • Authentication required for primary source.

  • Unable to create webhook at this time. Please try again later.

  • Failed to create webhook. GitHub API limit reached. Please try again later.

Causa posible: es posible que hayas estado usando la GitHub aplicación y no hayas concedido el alcance de los permisos del webhook.

Solución recomendada: para conceder el alcance del permiso requerido, sigue las instrucciones de Cómo ir a la GitHub aplicación que quieras revisar o modificar para configurar la aplicación instalada. En la sección de permisos, verá que la aplicación no tiene permisos de webhook y que hay una opción para revisar los permisos recién solicitados. Revise y acepte los nuevos permisos. Para obtener más información, consulte Aprobar los permisos actualizados para una aplicación. GitHub

Causa posible: La conexión funcionaba según lo esperado, pero de repente no tiene acceso a los repositorios.

Posible solución: comience por revisar sus autorizaciones y sus instalaciones y, a continuación, compruebe que la GitHub aplicación esté autorizada e instalada. Si la instalación de la GitHub aplicación está suspendida, debe anular la suspensión. Si la GitHub aplicación no está autorizada para una conexión UAT (token de acceso de usuario) o no está instalada para una conexión IAT (token de acceso a la instalación), la conexión existente ya no se podrá utilizar y tendrá que crear una nueva conexión. Tenga en cuenta que volver a instalar la GitHub aplicación no restablecerá la conexión anterior que estaba asociada a la instalación anterior.

Solución posible: si la conexión es una conexión UAT, asegúrese de que la conexión no se utilice simultáneamente, por ejemplo, en varias ejecuciones CodeBuild simultáneas de compilación. Esto se debe a que invalida GitHub inmediatamente un UAT emitido anteriormente si la conexión actualiza un token que está caducando. Si necesitas usar una conexión UAT para varias CodeBuild compilaciones simultáneas, puedes crear varias conexiones y usar cada conexión de forma independiente.

Posible solución: si la conexión UAT no se ha utilizado en los últimos 6 meses, la conexión quedará invalidada por. GitHub Para solucionarlo, cree una conexión nueva.

Causa posible: Puede que haya estado usando una conexión de token de acceso de usuario sin instalar la aplicación.

Solución recomendada: aunque para crear una conexión UAT no es necesario asociarla a una instalación de la GitHub aplicación, es necesaria una instalación para poder acceder al repositorio. Sigue las instrucciones para revisar las instalaciones y asegurarte de que la GitHub aplicación esté instalada. Si no está instalada, diríjase a la GitHub página de la aplicación para instalarla. Para obtener más información sobre el acceso de los tokens del tipo mencionado, consulte Acerca de los tokens de acceso de usuario.

A la función de IAM del AWS servicio le faltan los permisos de IAM necesarios.

Problema: Aparece alguno de los siguientes mensajes de error:

  • Access denied to connection <connection-arn>

  • Failed to get access token from <connection-arn>

Solución recomendada: normalmente se utiliza una conexión con un AWS servicio, como CodePipeline o. CodeBuild Cuando asignas al AWS servicio una función de IAM, el AWS servicio puede usar el permiso de la función para actuar en tu nombre. Asegúrese de que el rol de IAM tiene los permisos necesarios. Para obtener más información sobre el permiso de IAM necesario, consulte Otorgar acceso al rol de IAM CodeBuild del proyecto para usar la conexión y la administración de identidad y acceso para AWS CodeStar las notificaciones y CodeConnections en la Guía del usuario de la consola Developer Tools.

En esta página

PrivacidadTérminos del sitioPreferencias de cookies
© 2025, Amazon Web Services, Inc o sus afiliados. Todos los derechos reservados.