View a markdown version of this page

Actualizar una acción fuente GitHub (a través de la aplicación OAuth) a una acción fuente GitHub (a través de GitHub la aplicación) - AWS CodePipeline

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.

Actualizar una acción fuente GitHub (a través de la aplicación OAuth) a una acción fuente GitHub (a través de GitHub la aplicación)

En AWS CodePipeline, hay dos versiones compatibles de la acción GitHub fuente:

  • Recomendado: La acción GitHub (a través de GitHub la aplicación) utiliza la autenticación GitHub basada en la aplicación respaldada por un recurso. CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server y acciones GitLab.com GitLab autogestionadas Instala una aplicación de AWS CodeStar Connections en tu GitHub organización para que puedas gestionar el acceso a ella. GitHub

  • No se recomienda: la acción GitHub (a través de la aplicación OAuth) usa tokens de OAuth para autenticarse GitHub y usa un webhook independiente para detectar los cambios. Este ya no es el método recomendado.

nota

Las conexiones no están disponibles en las regiones Asia Pacífico (Hong Kong), Asia Pacífico (Hyderabad), Asia Pacífico (Yakarta), Asia Pacífico (Melbourne), Asia Pacífico (Osaka), África (Ciudad del Cabo), Oriente Medio (Bahréin), Oriente Medio (Emiratos Árabes Unidos), Europa (España), Europa (Zúrich), Israel (Tel Aviv) o AWS GovCloud (US-West). Para hacer referencia a otras acciones disponibles, consulte Integraciones de productos y servicios con CodePipeline. Para ver consideraciones sobre esta acción en la región de Europa (Milán), consulte la nota que aparece en CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server y acciones GitLab.com GitLab autogestionadas.

Utilizar la acción (mediante la GitHub aplicación) en lugar de la acción GitHub (mediante la GitHub aplicación OAuth) presenta algunas ventajas importantes:

  • Con las conexiones, ya CodePipeline no se necesitan apps de OAuth ni tokens de acceso personal para acceder a tu repositorio. Cuando creas una conexión, instalas una GitHub aplicación que administra la autenticación en tu GitHub repositorio y otorga permisos a nivel de organización. Debe autorizar los tokens de OAuth como usuario para acceder al repositorio. Para obtener más información sobre el OAuth-based GitHub acceso en contraposición al App-based GitHub acceso, consultehttps://docs.github.com/en/developers/apps/differences-between-github-apps-and-oauth-apps.

  • Cuando gestionas GitHub (mediante la GitHub aplicación) las acciones en la CLI o CloudFormation, ya no tendrás que guardar tu token de acceso personal como secreto en Secrets Manager. Ya no tienes que hacer referencia de forma dinámica al secreto almacenado en la configuración de tu CodePipeline acción. En su lugar, se agrega el ARN de conexión a la configuración de la acción. Para ver una acción de configuración de ejemplo, consulte CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server y acciones GitLab.com GitLab autogestionadas.

  • Cuando creas un recurso de conexión para usarlo con tu acción GitHub (a través de la GitHub aplicación) CodePipeline, puedes usar el mismo recurso de conexión para asociar otros servicios compatibles, como CodeGuru Reviewer, a tu repositorio.

  • En GitHub (mediante GitHub la aplicación), puedes clonar repositorios para acceder a los metadatos de git en CodeBuild acciones posteriores, mientras que en GitHub (mediante la aplicación OAuth) solo puedes descargar la fuente.

  • Un administrador instala la aplicación en los repositorios de su organización. Ya no tiene que hacer un seguimiento de los tokens de OAuth que dependen de la persona que creó el token.

Todas las aplicaciones instaladas en una organización tienen acceso al mismo conjunto de repositorios. Para cambiar quién puede acceder a cada repositorio, modifique la política de IAM para cada conexión. Para ver un ejemplo, consulte Ejemplo: Una política de ámbito reducido para utilizar conexiones con un repositorio especificado.

Puedes seguir los pasos de este tema para eliminar tu acción fuente GitHub (mediante la aplicación OAuth) y añadir una acción fuente GitHub (mediante la GitHub aplicación) desde la consola. CodePipeline

Paso 1: Sustituye tu acción (a través de la aplicación OAuth) GitHub

Usa la página de edición del pipeline para reemplazar tu acción (a través de la aplicación OAuth) por una GitHub acción GitHub (a través GitHub de la aplicación).

Para reemplazar tu acción (a través de la aplicación OAuth) GitHub
  1. Inicia sesión en la CodePipeline consola.

  2. Seleccione su canalización y, a continuación, elija Editar. Elija Editar etapa en la etapa de fuente. Aparece un mensaje en el que se recomienda actualizar la acción.

  3. En Action provider, selecciona GitHub (a través de GitHub la aplicación).

  4. Realice una de las siguientes acciones:

    • En Conexión, si aún no has creado una conexión con tu proveedor, selecciona Conectar a GitHub. Continúe con el paso 2: crear una conexión a GitHub.

    • En Conexión, si ya ha creado una conexión con su proveedor, seleccione la conexión. Continúe con el Paso 3: Guardar la acción de origen para la conexión.

Paso 2: Crear una conexión a GitHub

Tras elegir crear la conexión, se muestra la GitHub página Conectarse a.

Para crear una conexión a GitHub
  1. En la configuración de GitHub conexión, el nombre de la conexión aparece en Nombre de la conexión.

    En GitHub Aplicaciones, elige la instalación de una aplicación o elige Instalar una nueva aplicación para crear una.

    nota

    Se instala una aplicación para todas las conexiones a un proveedor en particular. Si ya has instalado la GitHub aplicación, elígela y omite este paso.

  2. Si GitHub aparece la página de autorización, inicie sesión con sus credenciales y, a continuación, elija continuar.

  3. En la página de instalación de la aplicación, aparece un mensaje que indica que la AWS CodeStar aplicación está intentando conectarse a tu GitHub cuenta.

    nota

    Solo instalas la aplicación una vez para cada GitHub cuenta. Si instaló la aplicación previamente, puede elegir Configurar para dirigirse a una página de modificación para la instalación de la aplicación o puede utilizar el botón Atrás para volver a la consola.

  4. En la página Instalar AWS CodeStar, seleccione Instalar.

  5. En la GitHub página Conectarse a, se muestra el identificador de conexión de la nueva instalación. Elija Conectar.

Paso 3: Guarde la acción GitHub de origen

Complete las actualizaciones en la página Editar acción para guardar la nueva acción fuente.

Para guardar la acción GitHub de origen
  1. En Repositorio, introduzca el nombre del repositorio de terceros. En Ramificación, introduzca la ramificación en la que desea que la canalización detecte los cambios de origen.

    nota

    En Repositorio, escriba owner-name/repository-name como se muestra en este ejemplo:

    my-account/my-repository
  2. En Formato del artefacto de salida, debe elegir el formato de los artefactos.

    • Para almacenar los artefactos de salida de la GitHub acción mediante el método predeterminado, elija CodePipeline predeterminado. La acción accede a los archivos desde el GitHub repositorio y almacena los artefactos en un archivo ZIP en el almacén de artefactos de la canalización.

    • Para almacenar un archivo JSON que contiene una referencia URL al repositorio de manera que las acciones posteriores puedan ejecutar comandos Git directamente, elija Clonación completa. Esta opción solo la pueden utilizar las acciones posteriores de CodeBuild .

      Si eliges esta opción, tendrás que actualizar los permisos de tu rol de servicio del CodeBuild proyecto, tal y como se muestra en. Añade CodeBuild GitClone permisos para las conexiones a Bitbucket, Enterprise Server o GitHub GitHub GitLab.com Para ver un tutorial que muestra cómo utilizar la opción Clonación completa, consulte Tutorial: Usa la clonación completa con una fuente de GitHub canalización.

  3. En Artefactos de salida, puede conservar el nombre del artefacto de salida para esta acción, por ejemplo SourceArtifact. Seleccione Listo para cerrar la página Editar acción.

  4. Seleccione Listo para cerrar la página de edición de etapa. Seleccione Guardar para cerrar la página de edición de la canalización.