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.
# Configuración del acceso de Amplify a los repositorios GitHub
Amplify ahora usa la función GitHub Aplicaciones para autorizar a Amplify el acceso de solo lectura a los repositorios. GitHub Con la GitHub aplicación Amplify, 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 GitHub las aplicaciones, consulte [Acerca GitHub ](https://docs.github.com/en/developers/apps/getting-started-with-apps/about-apps#about-github-apps) de las aplicaciones en el sitio web. GitHub
Cuando conectas una nueva aplicación almacenada en un GitHub repositorio, Amplify usa GitHub la aplicación de forma predeterminada para acceder al repositorio. Sin embargo, las aplicaciones de Amplify existentes a las que se conectó anteriormente desde los GitHub repositorios se utilizan para OAuth acceder. CI/CD seguirá funcionando para estas aplicaciones, pero le recomendamos encarecidamente que las migre para usar la nueva aplicación Amplify GitHub .
Al implementar una nueva aplicación o migrar una aplicación existente mediante la consola Amplify, se le redirige automáticamente a la ubicación de instalación de la aplicación 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. Usa el formato `https://github.com/apps/aws-amplify-{{REGION}}` y {{REGION}} sustitúyelo por la región en la que implementarás tu aplicación Amplify. Por ejemplo, para instalar la GitHub aplicación Amplify en la región EE.UU. Oeste (Oregón), vaya a https://github.com/apps/ aws-amplify-us-west -2.
**Topics**
+ [Instalación y autorización de la aplicación GitHub Amplify para una nueva implementación](#setting-up-github-app)
+ [Migración de una OAuth aplicación existente a la aplicación Amplify GitHub](#migrating-to-github-app-auth)
+ [Configuración de la GitHub aplicación Amplify para las implementaciones de CloudFormation CLI y SDK](#setting-up-github-app-cloudformation)
+ [Configuración de vistas previas web con la aplicación Amplify GitHub](#setting-up-github-app-pr-previews)
## Instalación y autorización de la aplicación GitHub Amplify para una nueva implementación
Cuando implementes una nueva aplicación en Amplify a partir del código existente en un GitHub repositorio, sigue las siguientes instrucciones para instalar y autorizar la aplicación. GitHub
**Para instalar y autorizar la aplicación Amplify GitHub**
1. Inicia sesión en la consola de [Amplify Consola de administración de AWS](https://console.aws.amazon.com/amplify/) y ábrela.
1. En la página **Todas las aplicaciones**, elija **Nueva aplicación** y, a continuación, **Alojar aplicación web**.
1. **En la página **Comenzar con Amplify Hosting**, selecciona y, a continuación **GitHub**, selecciona Continuar.**
1. Si es la primera vez que se conecta a un GitHub repositorio, se abrirá una nueva página en su navegador en GitHub .com en la que se solicitará permiso para iniciar sesión AWS Amplify en su GitHub cuenta. Seleccione **Autorizar**.
1. A continuación, debe instalar la GitHub aplicación Amplify en su GitHub cuenta. Se abre una página en GitHub.com en la que se solicita permiso para instalar y autorizar AWS Amplify en tu cuenta. GitHub
1. Selecciona la GitHub cuenta en la que deseas instalar la aplicación Amplify GitHub .
1. Realice una de las siguientes acciones:
+ 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.
1. Elija **Instalar y autorizar**.
1. Se le redirigirá a la página **Añadir ramificación de repositorio** de su aplicación en la consola de Amplify.
1. En la lista de **Repositorios actualizados recientemente**, seleccione el nombre del repositorio que desea conectar.
1. En la lista de **Ramificaciones**, seleccione el nombre de la ramificación del repositorio que desea conectar.
1. Elija **Siguiente**.
1. En la página **Configurar los ajustes de compilación**, elija **Siguiente**.
1. En la página **Revisar**, elija **Guardar e implementar**.
## Migración de una OAuth aplicación existente a la aplicación Amplify GitHub
Las aplicaciones de Amplify existentes a las que previamente se conectó desde los repositorios se utilizan OAuth para acceder a GitHub los repositorios. Le recomendamos encarecidamente que migre estas aplicaciones para usar la aplicación Amplify GitHub.
Siga las siguientes instrucciones para migrar una aplicación y eliminar el OAuth webhook correspondiente en su GitHub cuenta. Tenga en cuenta que el procedimiento de migración varía en función de si la aplicación GitHub Amplify ya está instalada. Tras migrar la primera aplicación e instalarla y autorizarla, solo tendrá que actualizar los permisos del repositorio para las siguientes migraciones de aplicaciones. GitHub
**Para migrar una aplicación de OAuth a la GitHub aplicación**
1. Inicia sesión en la consola de [Amplify Consola de administración de AWS](https://console.aws.amazon.com/amplify/) y ábrela.
1. Elija la aplicación que desea migrar.
1. En la página de información de la aplicación, busca el mensaje azul **Migrar a nuestra GitHub aplicación** y selecciona **Iniciar la migración**.
1. En la página **Instalar y autorizar GitHub la aplicación**, selecciona **Configurar GitHub la aplicación**.
1. Se abre una nueva página en tu navegador, en GitHub .com, en la que se solicita permiso para autorizar AWS Amplify el acceso a tu GitHub cuenta. Seleccione **Autorizar**.
1. Selecciona la GitHub cuenta en la que deseas instalar la aplicación Amplify GitHub .
1. Realice una de las siguientes acciones:
+ 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.
1. Elija **Instalar y autorizar**.
1. Se le redirigirá a la página **Instalar y autorizar GitHub la aplicación** de su aplicación en la consola Amplify. Si GitHub la autorización se ha realizado correctamente, aparecerá un mensaje de confirmación. Elija **Siguiente**.
1. 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.
## Configuración de la GitHub aplicación Amplify para las implementaciones de CloudFormation CLI y SDK
Las aplicaciones de Amplify existentes a las que previamente se conectó desde los repositorios se utilizan OAuth para acceder a GitHub los repositorios. Esto puede incluir aplicaciones que haya implementado mediante la Interfaz de línea de comandos (CLI) de Amplify o la. CloudFormation SDKs Le recomendamos encarecidamente que migre estas aplicaciones para usar la nueva aplicación Amplify GitHub . La migración debe llevarse a cabo en la consola Amplify de la Consola de administración de AWS. Para obtener instrucciones, consulte [Migración de una OAuth aplicación existente a la aplicación Amplify GitHub](#migrating-to-github-app-auth).
Puede utilizar CloudFormation la CLI de Amplify y la SDKs para implementar una nueva aplicación Amplify que utilice la GitHub aplicación para acceder al repositorio. Este proceso requiere que primero instales la GitHub aplicación Amplify en tu GitHub cuenta. A continuación, deberá generar un token de acceso personal en su GitHub cuenta. Por último, deberá implementar la aplicación y especificar el token de acceso personal.
**Instala la GitHub aplicación Amplify en tu cuenta**
1. Abre un navegador web y navega hasta la ubicación de instalación de la GitHub aplicación Amplify en la AWS región en la que vas a implementar la aplicación.
Utilice el formato y `https://github.com/apps/aws-amplify-{{REGION}}/installations/new` {{REGION}} sustitúyalo por su propia entrada. 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`.
1. Selecciona la GitHub cuenta en la que quieres instalar la aplicación Amplify GitHub .
1. Realice una de las siguientes acciones:
+ 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.
1. Elija **Instalar**.
**Genera un token de acceso personal en tu cuenta GitHub**
1. Inicia sesión en tu GitHub cuenta.
1. En la esquina superior derecha, busque su foto de perfil y elija **Configuración** en el menú.
1. En el menú de navegación izquierdo, elija **Configuración del desarrollador**.
1. En la página de **GitHub aplicaciones**, en el menú de navegación de la izquierda, selecciona **Tokens de acceso personal**.
1. En la página **Tokens de acceso personal**, elija **Generar nuevo token**.
1. En la página **Nuevo token de acceso personal**, en **Nota**, introduzca un nombre descriptivo para el token.
1. En la sección **Seleccionar ámbitos**, seleccione **admin:repo\_hook**.
1. Elija **Generar token**.
1. Copie y guarde el token de acceso personal. Deberá proporcionarla cuando implemente una aplicación Amplify con la CLI o CloudFormation la. SDKs
Una vez que la GitHub aplicación Amplify esté instalada en su GitHub cuenta y haya generado un token de acceso personal, puede implementar una nueva aplicación con la CLI de Amplify o la. CloudFormation SDKs En el campo `accessToken`, introduzca el token de acceso personal que creó en el procedimiento anterior. Para obtener más información, consulte [CreateApp](https://docs.aws.amazon.com/amplify/latest/APIReference/API_CreateApp.html#API_CreateApp_RequestSyntax)la *referencia de la API Amplify* y [AWS::Amplify::App](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-app.html)la Guía del *AWS CloudFormation usuario*.
El siguiente comando CLI implementa una nueva aplicación Amplify que usa la aplicación para acceder GitHub al repositorio. Reemplace {{myapp-using-githubapp}} {{https://github.com/Myaccount/react-app}} y {{MY\_TOKEN}} con su propia información.
```
aws amplify create-app --name {{myapp-using-githubapp}} --repository {{https://github.com/Myaccount/react-app}} --access-token {{MY_TOKEN}}
```
## Configuración de vistas previas web con la aplicación Amplify GitHub
Una vista previa web despliega todas las solicitudes de extracción (PR) realizadas en tu GitHub repositorio en una URL de vista previa única. Las vistas previas ahora utilizan la GitHub aplicación Amplify para acceder a su GitHub repositorio. Para obtener instrucciones sobre cómo instalar y autorizar la GitHub aplicación para las vistas previas web, consulte. [Habilitar las vistas previas web de solicitudes de extracción](pr-previews.md#enable-web-previews)