Configuration de l'accès Amplify aux GitHub référentiels - AWS Amplify Hébergement
Installation et autorisation de l' GitHub application Amplify pour un nouveau déploiementMigration d'uneOAuth application existante vers l' GitHub application AmplifyConfiguration de l' GitHub application Amplify pour lesAWS CloudFormation déploiements, la CLI et le SDKConfiguration des aperçus Web avec l' GitHub application Amplify

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 Amplify aux GitHub référentiels

Amplify utilise désormais la fonctionnalité GitHub Apps pour autoriser Amplify à accéder en lecture seule aux GitHub référentiels. Avec l' GitHub application Amplify, les autorisations sont plus précises, 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 sur le GitHub site Web.

Lorsque vous connectez une nouvelle application stockée dans un GitHub référentiel, Amplify utilise par défaut l' GitHub application pour accéder au référentiel. Toutefois, les applications Amplify existantes que vous avez précédemment connectées à partir GitHub de dépôts utilisent 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 GitHub application Amplify.

Lorsque vous déployez une nouvelle application ou migrez une application existante à l'aide de la console Amplify, vous êtes automatiquement dirigé vers l'emplacement d'installation de l' GitHub application Amplify. 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 formathttps://github.com/apps/aws-amplify-REGION en remplaçant REGION 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 USA Ouest (Oregon), accédez à https://github.com/apps/aws-amplify-us-west -2.

Installation et autorisation de l' GitHub application 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' GitHub application.

Pour installer et autoriser l' GitHub application Amplify

  1. Connectez-vous à la console AmplifyAWS Management Console et ouvrez la console Amplify.

  2. Sur la page Toutes les applications, choisissez Nouvelle application, puis Héberger l'application Web.

  3. Sur la page Commencer à utiliser Amplify Hosting, choisissez GitHub, puis choisissez Continuer.

  4. S'il s'agit de la première connexion à un GitHub référentiel, une nouvelle page s'ouvre dans votre navigateur sur GitHub .com, demandant l'autorisation d'autoriser l'AWS Amplifyaccès à votre GitHub compte. Choisissez Authorize (Autoriser).

  5. Ensuite, vous devez installer l' GitHub application Amplify sur votre GitHub compte. Une page s'ouvre sur GitHub.com demandant l'autorisation d'installer etAWS Amplify d'autoriser votre GitHub compte.

  6. Sélectionnez le GitHub compte sur lesquels vous souhaitez installer l' GitHub application Amplify.

  7. 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 référentiel de l'application que vous migrez dans les référentiels que vous sélectionnez.

  8. Choisissez Installer et autoriser.

  9. Vous êtes redirigé vers la page Ajouter une branche de référentiel pour votre application dans la console Amplify.

  10. Dans la liste des référentiels récemment mis à jour, sélectionnez le nom du référentiel auquel vous souhaitez vous connecter.

  11. Dans la liste Branche, sélectionnez le nom de la branche du référentiel à connecter.

  12. Choisissez Next (Suivant).

  13. Sur la page Configurer les paramètres de génération, choisissez Suivant.

  14. Sur la page Révision, choisissez Enregistrer et déployer.

Migration d'uneOAuth application existante vers l' GitHub application Amplify

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 procéder à la migration de ces applications pour utiliser l' GitHubapplication Amplify.

Suivez les instructions suivantes pour migrer une application et supprimer le webhook OAuth correspondant dans votre GitHub compte. Notez que la procédure de migration varie selon que l' GitHub application 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 OAuth vers l' GitHub application

  1. Connectez-vous à la console AmplifyAWS Management Console et ouvrez la console Amplify.

  2. Choisissez l'application que vous souhaitez procéder à la migration.

  3. Sur la page d'informations de l'application, recherchez le message bleu Migrer vers notre GitHub application et choisissez Démarrer la migration.

  4. Sur la page Installer et autoriser GitHub l'application, choisissez Configurer GitHub l'application.

  5. Une nouvelle page s'ouvre dans votre navigateur sur GitHub .com, demandant l'autorisation d'accéderAWS Amplify à votre GitHub compte. Choisissez Authorize (Autoriser).

  6. Sélectionnez le GitHub compte sur lesquels vous souhaitez installer l' GitHub application Amplify.

  7. 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 référentiel de l'application que vous migrez dans les référentiels que vous sélectionnez.

  8. Choisissez Installer et autoriser.

  9. Vous êtes redirigé vers la page Installer et autoriser GitHub l'application de votre application dans la console Amplify. Si GitHub l'autorisation réussit, vous voyez un message de réussite. Choisissez Next.

  10. Sur la page Installation complète, choisissez Installation complète. Cette étape supprime votre webhook existant, en crée un nouveau et termine la migration.

Configuration de l' GitHub application Amplify pour lesAWS CloudFormation déploiements, la CLI et le 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 des applications que vous avez déployées à l'aide de l'interface de ligne de commande (CLI) Amplify ou des kits SDK.AWS CloudFormation Nous vous recommandons vivement de procéder à la migration de ces applications pour utiliser la nouvelle GitHub application Amplify. La migration doit être effectuée dans la console Amplify duAWS Management Console. Pour des instructions, consultez Migration d'uneOAuth application existante vers l' GitHub application Amplify.

Vous pouvez utiliserAWS CloudFormation l'interface de ligne de commande Amplify et les SDK pour déployer une nouvelle application Amplify qui utilise l' GitHub application pour accéder aux dépôts. Ce processus nécessite que vous installiez d'abord l' GitHub application Amplify GitHub sur votre compte. Ensuite, vous devrez générer un jeton d'accès personnel sur 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 laAWS région où vous allez déployer votre application.

    Utilisez le formathttps://github.com/apps/aws-amplify-REGION/installations/new en remplaçant REGION par votre propre saisie. Par exemple, si vous installez votre application dans la région USA Ouest (Oregon), spécifiezhttps://github.com/apps/aws-amplify-us-west-2/installations/new.

  2. Sélectionnez le GitHub compte sur lesquels vous souhaitez installer l' GitHub application Amplify.

  3. 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 référentiel de l'application que vous migrez dans les référentiels que vous sélectionnez.

  4. Choisissez Installer.

Générez un jeton d'accès personnel sur votre GitHub compte

  1. Connectez-vous à votre GitHub compte.

  2. Dans le coin supérieur droit, localisez votre photo de profil et choisissez Paramètres dans le menu.

  3. Dans le menu de navigation de gauche, sélectionnez Developer settings (Paramètres du développeur).

  4. Sur la page GitHub Applications, dans le menu de navigation de gauche, choisissez Jetons d'accès personnels.

  5. Sur la page des jetons d'accès personnels, choisissez Générer un nouveau jeton.

  6. Sur la page Nouveau jeton d'accès personnel, dans le champ Note, entrez un nom descriptif pour le jeton.

  7. Dans la section Sélectionner les étendues, sélectionnez admin:repo_hook.

  8. Choisissez Generate token (Générer le jeton).

  9. Copiez et enregistrez le jeton d'accès personnel. Vous devrez le fournir lorsque vous déployez une application Amplify à l'aide de la CLI ou des SDK.AWS CloudFormation

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 à l'aide de l'interface de ligne de commande Amplify ou des SDK.AWS CloudFormation Utilisez leaccessToken champ pour spécifier le jeton d'accès personnel que vous avez créé dans la procédure précédente. Pour plus d'informations, consultez CreateAppla référence de l'API Amplify et AWS::Amplify::Apple guide deAWS CloudFormation l'utilisateur.

La commande CLI suivante déploie une nouvelle application Amplify qui utilise l' GitHub application pour accéder au référentiel. Remplacez myapp-using-githubapphttps://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' GitHub application Amplify

Un aperçu Web déploie chaque pull request (PR) envoyée à votre GitHub référentiel vers une URL d'aperçu unique. Les aperçus utilisent désormais l' GitHub application Amplify pour accéder à votre GitHub référentiel. Pour obtenir des instructions sur l'installation et l'autorisation de l' GitHub application pour les aperçus Web, consultezActiver les aperçus Web.