Actualizar una acción de origen de la GitHub versión 1 a una acción de origen de la GitHub versión 2 - AWS CodePipeline
Paso 1: Sustituye la GitHub acción de la versión 1Paso 2: Crea una conexión a GitHubPaso 3: Guarda la acción GitHub de origen

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 de origen de la GitHub versión 1 a una acción de origen de la GitHub versión 2

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

nota

Las conexiones no están disponibles en las regiones de 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 (EE. UU. Oeste). 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, GitLab .com y acciones GitLab autogestionadas.

Utilizar la acción de la GitHub versión 2 en lugar de la acción de la GitHub versión 1 presenta algunas ventajas importantes:

  • Con las conexiones, ya CodePipeline no se necesitan aplicaciones 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 permite los permisos a nivel de la organización. Debe autorizar los tokens de OAuth como usuario para acceder al repositorio. Para obtener más información sobre el GitHub acceso basado en OAuth en comparación con el acceso basado en aplicaciones GitHub , consulte. https://docs.github.com/en/developers/apps/differences-between-github-apps-and-oauth-apps

  • Cuando gestionas las acciones de la GitHub versión 2 en la CLI o CloudFormation, ya no tienes que almacenar tu token de acceso personal como secreto en Secrets Manager. Ya no tiene que hacer referencia de forma dinámica al secreto almacenado en la configuración de sus CodePipeline acciones. 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, GitLab .com y acciones GitLab autogestionadas.

  • Al crear un recurso de conexión para usarlo con la acción de la GitHub versión 2 CodePipeline, puede usar el mismo recurso de conexión para asociar otros servicios compatibles, como CodeGuru Reviewer, a su repositorio.

  • En la versión 2 de Github, puedes clonar repositorios para acceder a los metadatos de git en CodeBuild acciones posteriores, mientras que en la versión 1 de Github solo puedes descargar el código 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 la acción fuente de la GitHub versión 1 y añadir una acción fuente de la GitHub versión 2 desde la CodePipeline consola.

Paso 1: Sustituye la GitHub acción de la versión 1

Usa la página de edición de la canalización para reemplazar la GitHub acción de la versión 1 por una GitHub acción de la versión 2.

Para reemplazar la GitHub acción de la versión 1

  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 (versión 2).

  4. Realice una de las siguientes acciones siguientes:

    • En Conexión, si aún no ha creado una conexión con su proveedor, elija Conectar a GitHub. Continúe con el paso 2: cree 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: Crea una conexión a GitHub

Una vez que haya decidido crear la conexión, aparecerá la GitHub página Conectar a.

Para crear una conexión a GitHub

  1. En la configuración de la GitHub conexión, el nombre de la conexión se muestra en Nombre de la conexión.

    En GitHub Aplicaciones, selecciona la instalación de una aplicación o selecciona 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 ha instalado la GitHub aplicación, selecciónela y omita 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 Conectar a, se muestra el ID de conexión de la nueva instalación. Elija Conectar.

Paso 3: Guarda 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 default. La acción accede a los archivos del GitHub repositorio y almacena los artefactos en un archivo ZIP en el almacén de artefactos de Pipeline.

    • 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 CodeBuild posteriores.

      Si elige esta opción, tendrá que actualizar los permisos de su función de servicio de CodeBuild proyectos, tal y como se muestra en Añade CodeBuild GitClone permisos para las conexiones a Bitbucket, Enterprise Server o .com GitHub GitHub GitLab la siguiente. Para ver un tutorial que muestra cómo utilizar la opción Clonación completa, consulte Tutorial: Utilice un clon completo 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.