Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Configuration de l'accès d'Amplify aux référentiels GitHub
Amplify utilise désormais la fonctionnalité GitHub Apps pour autoriser Amplify à accéder en lecture seule aux référentiels. GitHub Avec l' GitHub application Amplify, les autorisations sont mieux affinées, ce qui vous permet d'accorder à Amplify l'accès uniquement aux référentiels que vous spécifiez. Pour en savoir plus sur les GitHub applications, consultez la section [À propos GitHub des applications](https://docs.github.com/en/developers/apps/getting-started-with-apps/about-apps#about-github-apps) sur le GitHub site Web.
Lorsque vous connectez une nouvelle application stockée dans un GitHub dépôt, Amplify utilise par défaut GitHub l'application pour accéder au dépôt. Cependant, les applications Amplify existantes que vous avez précédemment connectées depuis des GitHub dépôts sont utilisées OAuth pour y accéder. CI/CD continuera de fonctionner pour ces applications, mais nous vous recommandons vivement de les migrer pour utiliser la nouvelle application Amplify GitHub .
Lorsque vous déployez une nouvelle application ou que vous migrez une application existante à l'aide de la console Amplify, vous êtes automatiquement dirigé vers l'emplacement d'installation de l'application Amplify. GitHub Pour accéder manuellement à la page d'accueil d'installation de l'application, ouvrez un navigateur Web et accédez à l'application par région. Utilisez le format en `https://github.com/apps/aws-amplify-{{REGION}}` le {{REGION}} remplaçant par la région dans laquelle vous allez déployer votre application Amplify. Par exemple, pour installer l' GitHub application Amplify dans la région de l'ouest des États-Unis (Oregon), accédez à https://github.com/apps/ aws-amplify-us-west -2.
**Topics**
+ [Installation et autorisation de l'application GitHub Amplify pour un nouveau déploiement](#setting-up-github-app)
+ [Migration d'une OAuth application existante vers l'application Amplify GitHub](#migrating-to-github-app-auth)
+ [Configuration de l' GitHub application Amplify pour les déploiements, CloudFormation CLI et SDK](#setting-up-github-app-cloudformation)
+ [Configuration des aperçus Web avec l'application Amplify GitHub](#setting-up-github-app-pr-previews)
## Installation et autorisation de l'application GitHub Amplify pour un nouveau déploiement
Lorsque vous déployez une nouvelle application sur Amplify à partir du code existant dans un GitHub dépôt, suivez les instructions suivantes pour installer et autoriser l'application. GitHub
**Pour installer et autoriser l'application Amplify GitHub**
1. Connectez-vous à la console [Amplify AWS Management Console](https://console.aws.amazon.com/amplify/) et ouvrez-la.
1. Sur la page **Toutes les applications**, choisissez **Nouvelle application**, puis **Héberger l'application Web**.
1. **Sur la page **Commencer avec Amplify Hosting**, choisissez **GitHub**, puis choisissez Continuer.**
1. Si c'est la première fois que vous connectez un GitHub dépôt, une nouvelle page s'ouvre dans votre navigateur sur GitHub .com, demandant l'autorisation d'autoriser l' AWS Amplify accès à votre GitHub compte. Choisissez **Authorize** (Autoriser).
1. Ensuite, vous devez installer l' GitHub application Amplify sur votre GitHub compte. Une page s'ouvre sur GitHub.com demandant l'autorisation d'installation et d'autorisation AWS Amplify sur votre GitHub compte.
1. Sélectionnez le GitHub compte sur lequel vous souhaitez installer l'application Amplify GitHub .
1. Effectuez l’une des actions suivantes :
+ Pour appliquer l'installation à tous les référentiels, choisissez **Tous les référentiels**.
+ Pour limiter l'installation aux référentiels spécifiques que vous sélectionnez, choisissez Ne **sélectionner que les référentiels**. Assurez-vous d'inclure le dépôt de l'application que vous migrez dans les dépôts que vous sélectionnez.
1. Choisissez **Installer et autoriser**.
1. Vous êtes redirigé vers la page **Ajouter une branche de référentiel** pour votre application dans la console Amplify.
1. Dans la liste des **référentiels récemment mis à jour**, sélectionnez le nom du référentiel à connecter.
1. Dans la liste **Branche**, sélectionnez le nom de la branche du référentiel à connecter.
1. Choisissez **Suivant**.
1. Sur la page **Configurer les paramètres de build**, choisissez **Next**.
1. Sur la page **Révision**, choisissez **Enregistrer et déployer**.
## Migration d'une OAuth application existante vers l'application Amplify GitHub
Les applications Amplify existantes que vous avez précédemment connectées à partir de GitHub référentiels utilisent OAuth pour accéder aux référentiels. Nous vous recommandons vivement de migrer ces applications pour utiliser l'application Amplify GitHub.
Suivez les instructions ci-dessous pour migrer une application et supprimer le OAuth webhook correspondant dans votre GitHub compte. Notez que la procédure de migration varie selon que l'application GitHub Amplify est déjà installée ou non. Après avoir migré votre première application, installé et autorisé l' GitHub application, il vous suffit de mettre à jour les autorisations du référentiel pour les migrations d'applications suivantes.
**Pour migrer une application depuis l'application OAuth vers l' GitHub application**
1. Connectez-vous à la console [Amplify AWS Management Console](https://console.aws.amazon.com/amplify/) et ouvrez-la.
1. Choisissez l'application que vous souhaitez migrer.
1. Sur la page d'informations de l'application, repérez le message bleu **Migrer vers notre GitHub application** et choisissez **Démarrer la migration**.
1. Sur la page **Installer et autoriser GitHub l'application**, choisissez **Configurer GitHub l'application**.
1. Une nouvelle page s'ouvre dans votre navigateur sur GitHub .com, demandant l'autorisation d'autoriser l' AWS Amplify accès à votre GitHub compte. Choisissez **Authorize** (Autoriser).
1. Sélectionnez le GitHub compte sur lequel vous souhaitez installer l'application Amplify GitHub .
1. Effectuez l’une des actions suivantes :
+ Pour appliquer l'installation à tous les référentiels, choisissez **Tous les référentiels**.
+ Pour limiter l'installation aux référentiels spécifiques que vous sélectionnez, choisissez Ne **sélectionner que les référentiels**. Assurez-vous d'inclure le dépôt de l'application que vous migrez dans les référentiels que vous sélectionnez.
1. Choisissez **Installer et autoriser**.
1. Vous êtes redirigé vers la page **Installer et autoriser GitHub l'application** pour votre application dans la console Amplify. Si GitHub l'autorisation est réussie, vous verrez un message de réussite. Choisissez **Next**.
1. Sur la page **Installation complète**, choisissez **Terminer l'installation**. Cette étape supprime votre webhook existant, en crée un nouveau et termine la migration.
## Configuration de l' GitHub application Amplify pour les déploiements, CloudFormation CLI et SDK
Les applications Amplify existantes que vous avez précédemment connectées à partir de GitHub référentiels utilisent OAuth pour accéder aux référentiels. Cela peut inclure les applications que vous avez déployées à l'aide de l'interface de ligne de commande (CLI) Amplify CloudFormation, ou du. SDKs Nous vous recommandons vivement de migrer ces applications pour utiliser la nouvelle application Amplify GitHub . La migration doit être effectuée dans la console Amplify dans le. AWS Management Console Pour obtenir des instructions, veuillez consulter [Migration d'une OAuth application existante vers l'application Amplify GitHub](#migrating-to-github-app-auth).
Vous pouvez utiliser CloudFormation la CLI Amplify et le SDKs pour déployer une nouvelle application Amplify qui utilise l'application pour accéder au dépôt GitHub . Ce processus nécessite que vous installiez d'abord l' GitHub application Amplify sur votre GitHub compte. Ensuite, vous devrez générer un jeton d'accès personnel dans votre GitHub compte. Enfin, déployez l'application et spécifiez le jeton d'accès personnel.
**Installez l' GitHub application Amplify sur votre compte**
1. Ouvrez un navigateur Web et accédez à l'emplacement d'installation de l' GitHubapplication Amplify dans la AWS région où vous allez déployer votre application.
Utilisez le format `https://github.com/apps/aws-amplify-{{REGION}}/installations/new` en le {{REGION}} remplaçant par votre propre entrée. Par exemple, si vous installez votre application dans la région de l'ouest des États-Unis (Oregon), spécifiez`https://github.com/apps/aws-amplify-us-west-2/installations/new`.
1. Sélectionnez le GitHub compte sur lequel vous souhaitez installer l'application Amplify GitHub .
1. Effectuez l’une des actions suivantes :
+ Pour appliquer l'installation à tous les référentiels, choisissez **Tous les référentiels**.
+ Pour limiter l'installation aux référentiels spécifiques que vous sélectionnez, choisissez Ne **sélectionner que les référentiels**. Assurez-vous d'inclure le dépôt de l'application que vous migrez dans les dépôts que vous sélectionnez.
1. Choisissez **Installer**.
**Générez un jeton d'accès personnel dans votre GitHub compte**
1. Connectez-vous à votre GitHub compte.
1. Dans le coin supérieur droit, localisez votre photo de profil et choisissez **Paramètres** dans le menu.
1. Dans le menu de navigation de gauche, choisissez **Paramètres du développeur**.
1. Sur la page **GitHub Applications**, dans le menu de navigation de gauche, choisissez **Jetons d'accès personnels**.
1. Sur la page des **jetons d'accès personnels**, choisissez **Générer un nouveau jeton**.
1. Sur la page **Nouveau jeton d'accès personnel**, dans **Note**, entrez un nom descriptif pour le jeton.
1. Dans la section **Select scopes**, sélectionnez **admin:repo\_hook**.
1. Choisissez **Generate token (Générer le jeton)**.
1. Copiez et enregistrez le jeton d'accès personnel. Vous devrez le fournir lorsque vous déployez une application Amplify avec la CLI CloudFormation, ou le. SDKs
Une fois que l' GitHub application Amplify est installée sur votre GitHub compte et que vous avez généré un jeton d'accès personnel, vous pouvez déployer une nouvelle application avec la CLI Amplify, CloudFormation ou le. SDKs Utilisez le `accessToken` champ pour spécifier le jeton d'accès personnel que vous avez créé lors de la procédure précédente. Pour plus d'informations, consultez [CreateApp](https://docs.aws.amazon.com/amplify/latest/APIReference/API_CreateApp.html#API_CreateApp_RequestSyntax)la *référence de l'API Amplify* et le guide [AWS::Amplify::App](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-app.html)de l'*AWS CloudFormation utilisateur*.
La commande CLI suivante déploie une nouvelle application Amplify qui utilise l'application pour GitHub accéder au référentiel. Remplacez {{myapp-using-githubapp}}{{https://github.com/Myaccount/react-app}}, et {{MY\_TOKEN}} par vos propres informations.
```
aws amplify create-app --name {{myapp-using-githubapp}} --repository {{https://github.com/Myaccount/react-app}} --access-token {{MY_TOKEN}}
```
## Configuration des aperçus Web avec l'application Amplify GitHub
Un aperçu Web déploie chaque pull request (PR) envoyée à votre GitHub référentiel vers une URL de prévisualisation unique. Les aperçus utilisent désormais l'application GitHub Amplify pour accéder à GitHub votre dépôt. Pour obtenir des instructions sur l'installation et l'autorisation de l' GitHub application pour les aperçus Web, consultez. [Activer les aperçus Web pour les pull requests](pr-previews.md#enable-web-previews)