Configurar el acceso de Amplify a repositorios de GitHub - AWS Amplify Hospedaje
Instalar y autorizar la aplicación de Amplify GitHub en una nueva implementaciónMigrar una aplicación de OAuth existente a la aplicación de Amplify GitHubConfigurar la aplicación de Amplify GitHub para implementaciones AWS CloudFormation, CLI y SDKConfigurar vistas previas web con la aplicación de Amplify GitHub

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.

Configurar el acceso de Amplify a repositorios de GitHub

Amplify ahora usa la característica de la aplicación de GitHub para autorizar el acceso de solo lectura de Amplify a los repositorios de GitHub. Con la aplicación de Amplify GitHub, los permisos están más ajustados, lo que te permite conceder acceso a Amplify solo a los repositorios que especifiques. Para obtener más información sobre las aplicaciones de GitHub, consulte Acerca de las aplicaciones de GitHub en el sitio web de GitHub.

Cuando conecta una nueva aplicación almacenada en un repositorio de GitHub, Amplify usa la aplicación de GitHub de forma predeterminada para acceder al repositorio. Sin embargo, las aplicaciones de Amplify existentes que ya haya conectado a repositorios de GitHub accederán mediante OAuth. La CI/CD seguirá funcionando en estas aplicaciones, pero le recomendamos encarecidamente que las migre para usar la nueva aplicación de Amplify GitHub.

Cuando implementa una nueva aplicación o migra una aplicación existente mediante la consola de Amplify, se le redirigirá automáticamente a la ubicación de instalación de la aplicación de Amplify GitHub. Para acceder manualmente a la página de instalación de la aplicación, abra un navegador web y acceda a la aplicación según su región. Use el formato https://github.com/apps/aws-amplify-REGION y sustituya REGIÓN por la región en la que implementará su aplicación de Amplify. Por ejemplo, para instalar la aplicación de Amplify GitHub en la región Oeste de EE. UU. (Oregón), acceda a https://github.com/apps/aws-amplify-us-west-2.

Instalar y autorizar la aplicación de Amplify GitHub en una nueva implementación

Cuando implemente una nueva aplicación en Amplify a partir de código existente en un repositorio de GitHub, siga estas instrucciones para instalar y autorizar la aplicación de GitHub.

Para instalar y autorizar la aplicación de Amplify GitHub

  1. Inicie sesión en AWS Management Console y abra la consola de Amplify.

  2. En la página Todas las aplicaciones, elija Nueva aplicación y, a continuación, Alojar aplicación web.

  3. En la página Comenzar con Amplify Hosting, elija GitHub y, a continuación, elija Continuar.

  4. Si es la primera vez que conecta un repositorio de GitHub, se abrirá una nueva página de GitHub.com en su navegador solicitando permiso para autorizar el acceso de AWS Amplify a su cuenta de GitHub. Elija Autorizar.

  5. A continuación, deberá instalar la aplicación de Amplify GitHub en su cuenta de GitHub. Se abrirá una página de GitHub.com solicitando permiso para instalar y autorizar AWS Amplify en su cuenta de GitHub.

  6. Seleccione la cuenta de GitHub donde desea instalar la aplicación de Amplify GitHub.

  7. Realice una de las siguientes acciones siguientes:

    • Para aplicar la instalación a todos los repositorios, elija Todos los repositorios.

    • Para limitar la instalación solo a repositorios específicos, elija Solo los repositorios seleccionados. Asegúrese de incluir el repositorio de la aplicación que está migrando en los repositorios que seleccione.

  8. Elija Instalar y autorizar.

  9. Se le redirigirá a la página Añadir ramificación de repositorio de su aplicación en la consola de Amplify.

  10. En la lista de Repositorios actualizados recientemente, seleccione el nombre del repositorio que desea conectar.

  11. En la lista de Ramificaciones, seleccione el nombre de la ramificación del repositorio que desea conectar.

  12. Elija Siguiente.

  13. En la página Configurar los ajustes de compilación, elija Siguiente.

  14. En la página Revisar, elija Guardar e implementar.

Migrar una aplicación de OAuth existente a la aplicación de Amplify GitHub

Las aplicaciones de Amplify existentes conectadas previamente a repositorios de GitHub emplean OAuth para acceder a los repositorios. Le recomendamos firmemente que migre estas aplicaciones para usar la aplicación de Amplify GitHub.

Siga estas instrucciones para migrar una aplicación y eliminar el correspondiente webhook de OAuth de su cuenta de GitHub. Tenga en cuenta que el procedimiento de migración varía en función de si la aplicación de Amplify GitHub está ya instalada. Después de migrar su primera aplicación e instalar y autorizar la aplicación de GitHub, solo necesitará actualizar los permisos del repositorio para las siguientes migraciones de aplicaciones.

Para migrar una aplicación de OAuth a la aplicación de GitHub

  1. Inicie sesión en AWS Management Console y abra la consola de Amplify.

  2. Elija la aplicación que desea migrar.

  3. En la página de información de la aplicación, busque el mensaje azul Migrar a la aplicación de GitHub y elija Iniciar migración.

  4. En la página Instalar y autorizar la aplicación de GitHub, elija Configurar la aplicación de GitHub.

  5. Se abrirá una nueva página de GitHub.com en su navegador solicitando permiso para autorizar AWS Amplify en su cuenta de GitHub. Seleccione Autorizar.

  6. Seleccione la cuenta de GitHub donde desea instalar la aplicación de Amplify GitHub.

  7. Realice una de las siguientes acciones siguientes:

    • Para aplicar la instalación a todos los repositorios, elija Todos los repositorios.

    • Para limitar la instalación solo a repositorios específicos, elija Solo los repositorios seleccionados. Asegúrese de incluir el repositorio de la aplicación que desea migrar en los repositorios que seleccione.

  8. Elija Instalar y autorizar.

  9. Se le redirigirá a la página Instalar y autorizar la aplicación de GitHub de su aplicación en la consola de Amplify. Si la autorización de GitHub se ha realizado correctamente, aparecerá un mensaje de confirmación. Elija Siguiente.

  10. En la página Completar instalación, elija Completar instalación. Este paso eliminará el webhook existente, creará uno nuevo y finalizará la migración.

Configurar la aplicación de Amplify GitHub para implementaciones AWS CloudFormation, CLI y SDK

Las aplicaciones de Amplify existentes conectadas previamente a repositorios de GitHub emplean OAuth para acceder a los repositorios. Pueden ser aplicaciones que haya implementado mediante la interfaz de la línea de comandos(CLI) de Amplify, AWS CloudFormation o SDK. Le recomendamos firmemente que migre estas aplicaciones para usar la nueva aplicación de Amplify GitHub. La migración debe llevarse a cabo en la consola Amplify de la AWS Management Console. Para obtener instrucciones, consulte Migrar una aplicación de OAuth existente a la aplicación de Amplify GitHub.

Puede usar AWS CloudFormation, la CLI de Amplify y los SDK para implementar una nueva aplicación de Amplify que acceda a los repositorios mediante la aplicación de GitHub. Para llevar a cabo este proceso, deberá instalar previamente la aplicación de Amplify GitHub en su cuenta de GitHub. Después, tendrá que generar un token de acceso personal en su cuenta de GitHub. Por último, deberá implementar la aplicación y especificar el token de acceso personal.

Instale la aplicación de Amplify GitHub en su cuenta

  1. Abra un navegador web y acceda a la ubicación de instalación de la aplicación de Amplify GitHub para la región de AWS en la que desea implementar su aplicación.

    Use el formato https://github.com/apps/aws-amplify-REGION/installations/new, sustituyendo REGIÓN por la región seleccionada. Por ejemplo, si va a instalar la aplicación en la región Oeste de EE. UU. (Oregón), especifique https://github.com/apps/aws-amplify-us-west-2/installations/new.

  2. Seleccione la cuenta de GitHub donde desea instalar la aplicación de Amplify GitHub.

  3. Realice una de las siguientes acciones siguientes:

    • Para aplicar la instalación a todos los repositorios, elija Todos los repositorios.

    • Para limitar la instalación solo a repositorios específicos, elija Solo los repositorios seleccionados. Asegúrese de incluir el repositorio de la aplicación que está migrando en los repositorios que seleccione.

  4. Elija Instalar.

Genere un token de acceso personal en su cuenta de GitHub

  1. Inicie sesión en su cuenta de GitHub.

  2. En la esquina superior derecha, busque su foto de perfil y elija Configuración en el menú.

  3. En el menú de navegación izquierdo, elija Configuración del desarrollador.

  4. En la página Aplicaciones de GitHub, en el menú de navegación de la izquierda, elija Tokens de acceso personal.

  5. En la página Tokens de acceso personal, elija Generar nuevo token.

  6. En la página Nuevo token de acceso personal, en Nota, introduzca un nombre descriptivo para el token.

  7. En la sección Seleccionar ámbitos, seleccione admin:repo_hook.

  8. Elija Generar token.

  9. Copie y guarde el token de acceso personal. Deberá proporcionarlo cuando implemente una aplicación de Amplify con CLI, AWS CloudFormation o SDK.

Tras instalar la aplicación de Amplify GitHub en su cuenta de GitHub y generar un token de acceso personal, podrá implementar una nueva aplicación con la CLI de Amplify, AWS CloudFormation o SDK. En el campo accessToken, introduzca el token de acceso personal que creó en el procedimiento anterior. Para obtener más información, consulte Crear aplicación en la referencia de la API de Amplify y AWS::Amplify::App en la Guía del usuario de AWS CloudFormation.

El siguiente comando de CLI implementa una nueva aplicación de Amplify que emplea la aplicación de GitHub para acceder al repositorio. Sustituya myapp-using-githubapp, https://github.com/Myaccount/react-app y MY_TOKEN con su información.

aws amplify create-app --name myapp-using-githubapp --repository https://github.com/Myaccount/react-app --access-token MY_TOKEN

Configurar vistas previas web con la aplicación de Amplify GitHub

Una vista previa web implementa todas las solicitudes de extracción (PR) realizadas en su repositorio de GitHub en una URL de vista previa única. Ahora, las vistas previas usan la aplicación de Amplify GitHub para acceder a su repositorio de GitHub. Para obtener más instrucciones sobre cómo instalar y autorizar la aplicación de GitHub para las vistas previas web, consulte Habilite las vistas previas web.