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.
# Flux de travail de déploiements de branches de fonctionnalités et flux de travail d'équipe
Amplify Hosting est conçu pour fonctionner avec les branches de fonctionnalités et GitFlow les flux de travail. Amplify utilise les branches Git pour créer un nouveau déploiement chaque fois que vous connectez une nouvelle branche dans votre dépôt. Après avoir connecté votre première branche, vous créez des branches de fonctionnalités supplémentaires.
**Pour ajouter une branche à une application**
1. Choisissez l'application à laquelle vous souhaitez ajouter une branche.
1. Choisissez **Paramètres de l'application**, puis **Paramètres de la succursale**.
1. Sur la page des **paramètres de la branche**, choisissez **Ajouter une branche**.
1. Sélectionnez une branche dans votre référentiel.
1. Choisissez **Ajouter une branche.**
1. Redéployez votre application.
Une fois que vous avez ajouté une branche, votre application dispose de deux déploiements disponibles sur les domaines par défaut d'Amplify, tels que *https://main.appid.amplifyapp.com*et. *https://dev.appid.amplifyapp.com* Cela peut être différent de team-to-team, mais c'est généralement la **branche principale** qui suit le code de publication et constitue votre branche de production. La **branche de développement** sert de branche d'intégration pour tester les nouvelles fonctionnalités. Cela permet aux bêta-testeurs de tester des fonctionnalités inédites lors du déploiement de la branche de développement, sans affecter les utilisateurs finaux de production participant au déploiement de la branche principale.
**Topics**
+ [Flux de travail d'équipe avec les applications Amplify Gen 2 intégrales](team-workflows-gen2.md)
+ [Flux de travail d'équipe avec les applications Amplify Gen 1 intégrales](team-workflows-with-amplify-cli-backend-environments.md)
+ [Déploiements de branches de fonctionnalités basés sur des modèles](pattern-based-feature-branch-deployments.md)
+ [Génération automatique de la configuration Amplify au moment de la construction (applications Gen 1 uniquement)](amplify-config-autogeneration.md)
+ [Constructions de backend conditionnelles (applications Gen 1 uniquement)](conditional-backends.md)
+ [Utiliser les backends Amplify dans toutes les applications (applications de première génération uniquement)](reuse-backends.md)
# Flux de travail d'équipe avec les applications Amplify Gen 2 intégrales
AWS Amplify Gen 2 introduit une expérience de développement basée sur le code, TypeScript basée sur le code, pour définir les backends. *Pour en savoir plus sur les flux de travail Fullstack avec les applications Amplify Gen 2, [voir Workflows Fullstack](https://docs.amplify.aws/nextjs/deploy-and-host/fullstack-branching/) dans la documentation Amplify.*
# Flux de travail d'équipe avec les applications Amplify Gen 1 intégrales
Le déploiement d'une branche de fonctionnalités comprend un **frontend** et un environnement principal **optionnel**. Le frontend est créé et déployé sur un réseau mondial de diffusion de contenu (CDN), tandis que le backend est déployé par Amplify Studio ou la CLI Amplify pour. AWS Pour savoir comment configurer ce scénario de déploiement, consultez[Création d'un backend pour une application](deploy-backend.md).
Amplify Hosting déploie en permanence des ressources dorsales telles que les fonctions GraphQL APIs et Lambda dans le cadre de vos déploiements de branches fonctionnelles. Vous pouvez utiliser les modèles de branchement suivants pour déployer votre backend et votre frontend avec Amplify Hosting.
## Flux de travail de branche de fonctionnalités
+ Créez des **environnements** de backend de **production, de test** et **de développement** avec Amplify Studio ou l'Amplify CLI.
+ Mappez **le backend** de production à la branche **principale**.
+ Mappez le backend de **test** à la branche de **développement**.
+ Les membres de l'équipe peuvent utiliser l'**environnement** de développement principal pour tester des branches de **fonctionnalités** individuelles.
![\[Un diagramme qui montre comment mapper les relations entre les environnements principaux et les branches frontales.\]](http://docs.aws.amazon.com/fr_fr/amplify/latest/userguide/images/FeatureBranchWorkflow.png)
1. Installez l'interface de ligne de commande Amplify pour lancer un nouveau projet Amplify.
```
npm install -g @aws-amplify/cli
```
1. Créez un environnement backend *prod* pour votre projet. Si vous n'avez pas de projet, créez-en un à l'aide d'outils bootstrap tels que create-react-app Gatsby.
```
create-react-app next-unicorn
cd next-unicorn
amplify init
? Do you want to use an existing environment? (Y/n): n
? Enter a name for the environment: prod
...
amplify push
```
1. Ajoutez des environnements backen de *test* et de *développement*.
```
amplify env add
? Do you want to use an existing environment? (Y/n): n
? Enter a name for the environment: test
...
amplify push
amplify env add
? Do you want to use an existing environment? (Y/n): n
? Enter a name for the environment: dev
...
amplify push
```
1. Envoyez le code vers le dépôt Git de votre choix (dans cet exemple, nous supposerons que vous avez envoyé le code vers le dépôt principal).
```
git commit -am 'Added dev, test, and prod environments'
git push origin main
```
1. Visitez Amplify dans le AWS Management Console pour voir votre environnement principal actuel. Naviguez d'un niveau supérieur depuis le fil d'Ariane pour afficher la liste de tous les environnements de backend créés dans l'onglet Environnements de **backend**.
![\[La console Amplify affiche les environnements principaux associés à une application Amplify.\]](http://docs.aws.amazon.com/fr_fr/amplify/latest/userguide/images/reuse-backend-5.png)
1. Accédez à l'onglet **Environnements frontaux** et connectez votre fournisseur de référentiel à votre branche *principale*.
1. Sur la page des paramètres de génération, sélectionnez un environnement principal existant pour configurer un déploiement continu avec la branche principale. Choisissez *prod* dans la liste et accordez le rôle de service à Amplify. Choisissez **Save and deploy** (Enregistrer et déployer). Une fois la compilation terminée, vous pourrez accéder au déploiement de la branche principale à l'adresse *https://main.appid.amplifyapp.com*.
![\[La page Configurer les paramètres de build avec une liste des backends existants.\]](http://docs.aws.amazon.com/fr_fr/amplify/latest/userguide/images/reuse-backend-2.png)
1. Connectez la branche de *développement* dans Amplify (supposons que le *développement* et la branche *principale* sont identiques à ce stade). Choisissez l'environnement backend *test*.
![\[La page Ajouter une branche de référentiel avec une branche et un environnement principal sélectionnés.\]](http://docs.aws.amazon.com/fr_fr/amplify/latest/userguide/images/reuse-backend-4.png)
1. Amplify est maintenant configuré. Vous pouvez commencer à travailler sur les nouvelles fonctionnalités d'une branche. Pour ajouter une fonctionnalité backend, utilisez l'environnement backend *dev* à partir de votre poste de travail local.
```
git checkout -b newinternet
amplify env checkout dev
amplify add api
...
amplify push
```
1. Une fois que vous avez fini de travailler sur cette fonctionnalité, validez le code et créez une demande d'extraction afin d'effectuer un examen en interne.
```
git commit -am 'Decentralized internet v0.1'
git push origin newinternet
```
1. Pour prévisualiser à quoi ressembleront les modifications, accédez à la console Amplify et connectez votre branche de fonctionnalités. Remarque : Si vous l'avez AWS CLI installé sur votre système (pas l'Amplify CLI), vous pouvez connecter une branche directement depuis votre terminal. Pour localiser l'ID de votre application, accédez à App Settings (Paramètres de l'application) > General (Général) > AppARN : *arn:aws:amplify:::apps/*.
```
aws amplify create-branch --app-id --branch-name
aws amplify start-job --app-id --branch-name --job-type RELEASE
```
1. Votre fonctionnalité sera accessible à l'adresse suivante *https://newinternet.appid.amplifyapp.com*pour la partager avec vos coéquipiers. Si tout semble correct, fusionnez la branche PR avec la branche de développement.
```
git checkout develop
git merge newinternet
git push
```
1. Cela lancera une version qui mettra à jour le backend ainsi que le frontend dans Amplify avec un déploiement de branche sur. *https://dev.appid.amplifyapp.com* Vous pouvez partager ce lien avec les intervenants internes afin qu'ils puissent examiner cette nouvelle fonctionnalité.
1. Supprimez votre branche de fonctionnalités de Git, Amplify et supprimez l'environnement principal du cloud (vous pouvez toujours en créer une nouvelle en exécutant « amplify env checkout prod » et « amplify env add »).
```
git push origin --delete newinternet
aws amplify delete-branch --app-id --branch-name
amplify env remove dev
```
## GitFlow flux de travail
GitFlow utilise deux branches pour enregistrer l'historique du projet. La branche *principale* suit uniquement le code de version, et la branche de *développement* est utilisée comme branche d'intégration pour les nouvelles fonctionnalités. GitFlow simplifie le développement parallèle en isolant les nouveaux développements des travaux achevés. Le nouveau développement (comme les fonctionnalités et les correctifs de bogues non urgents) s'effectue dans les *branches de fonctionnalités*. Lorsque le développeur juge que le code peut être publié, la *branche de fonctionnalités* est fusionnée dans la *branche de développement* pour l'intégration. Les seules validations vers la branche principale sont les fusions depuis les branches de *version* et les branches de *correctifs (pour corriger* les bogues d'urgence).
Le schéma ci-dessous montre une configuration recommandée avec GitFlow. Vous pouvez suivre le même processus, comme décrit dans la section ci-dessus sur les flux de travail des branches de fonctionnalités.
![\[Schéma illustrant une configuration recommandée avec GitFlow.\]](http://docs.aws.amazon.com/fr_fr/amplify/latest/userguide/images/GitflowWorkflow.png)
## Un sandbox pour chaque développeur
+ Chaque développeur d'une équipe crée un environnement de test (sandbox) dans le cloud qui est distinct de son ordinateur local. Cela permet aux développeurs de travailler indépendamment les uns des autres sans remplacer les modifications apportées par les autres membres de l'équipe.
+ Chaque branche d'Amplify possède son propre backend. Cela garantit qu'Amplify utilise le référentiel Git comme source fiable unique à partir de laquelle déployer les modifications, plutôt que de compter sur les développeurs de l'équipe pour transférer manuellement leur backend ou leur front-end en production depuis leurs ordinateurs locaux.
![\[Schéma illustrant un flux de travail sandbox par développeur.\]](http://docs.aws.amazon.com/fr_fr/amplify/latest/userguide/images/AmplifySandboxWorkflow.png)
1. Installez l'interface de ligne de commande Amplify pour lancer un nouveau projet Amplify.
```
npm install -g @aws-amplify/cli
```
1. Initialisez un environnement *principal Mary* pour votre projet. Si vous n'avez pas de projet, créez-en un à l'aide d'outils bootstrap tels que create-react-app Gatsby.
```
cd next-unicorn
amplify init
? Do you want to use an existing environment? (Y/n): n
? Enter a name for the environment: mary
...
amplify push
```
1. Envoyez le code vers le dépôt Git de votre choix (dans cet exemple, nous supposerons que vous avez envoyé le code au dépôt principal).
```
git commit -am 'Added mary sandbox'
git push origin main
```
1. Connectez votre repo > *main à Amplify*.
1. La console Amplify détectera les environnements principaux créés par la CLI Amplify. Choisissez *Créer un nouvel environnement dans* la liste déroulante et accordez le rôle de service à Amplify. Choisissez **Save and deploy** (Enregistrer et déployer). Une fois la construction terminée, vous obtiendrez un déploiement de branche principale disponible sur *https://main.appid.amplifyapp.com*avec un nouvel environnement principal lié à la branche.
1. *Connectez la branche de *développement* dans Amplify (supposons que le *développement* et la branche *principale* sont identiques à ce stade) et choisissez Create*
# Déploiements de branches de fonctionnalités basés sur des modèles
Les déploiements de branches basés sur des modèles vous permettent de déployer automatiquement des branches correspondant à un modèle spécifique dans Amplify. Les équipes produit qui utilisent des branches de fonctionnalités ou des GitFlow flux de travail pour leurs versions peuvent désormais définir des modèles tels **release\$1\$1** que le déploiement automatique de branches Git commençant par « release » vers une URL partageable.
1. Choisissez **Paramètres de l'application**, puis **Paramètres de la succursale**.
1. Sur la page des **paramètres de la branche**, choisissez **Modifier**.
1. Sélectionnez **Détection automatique des branches** pour connecter automatiquement les branches à Amplify qui correspondent à un ensemble de modèles.
1. Dans le champ **Détection automatique des branches - modèles**, entrez les modèles pour le déploiement automatique des branches.
+ **\$1**— Déploie toutes les branches de votre dépôt.
+ **release\$1**— Déploie toutes les branches commençant par le mot « release ».
+ **release\$1/**— Déploie toutes les branches correspondant au modèle « release/».
+ Spécifiez plusieurs modèles dans une liste séparée par des virgules. Par exemple, **release\$1, feature\$1**.
1. Configurez la protection automatique par mot de passe pour toutes les succursales créées automatiquement en sélectionnant **Contrôle d'accès par détection automatique des succursales**.
1. Pour les applications Gen 1 créées avec un backend Amplify, vous pouvez choisir de créer un nouvel environnement pour chaque branche connectée ou de pointer toutes les branches vers un backend existant.
1. Choisissez **Enregistrer**.
## Déploiements de branches de fonctionnalités basés sur des modèles pour une application connectée à un domaine personnalisé
Vous pouvez utiliser des déploiements de branches de fonctionnalités basés sur des modèles pour une application connectée à un domaine personnalisé Amazon Route 53.
+ Pour obtenir des instructions sur la configuration de déploiements de branches de fonctionnalités basés sur des modèles, voir [Configuration de sous-domaines automatiques pour un domaine personnalisé Amazon Route 53](to-set-up-automatic-subdomains-for-a-Route-53-custom-domain.md)
+ Pour obtenir des instructions sur la connexion d'une application Amplify à un domaine personnalisé géré dans Route 53, voir [Ajouter un domaine personnalisé géré par Amazon Route 53](to-add-a-custom-domain-managed-by-amazon-route-53.md)
+ Pour plus d'informations sur l'utilisation de Route 53, consultez [Qu'est-ce qu'Amazon Route 53 ?](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/Welcome.html)
# Génération automatique de la configuration Amplify au moment de la construction (applications Gen 1 uniquement)
**Note**
Les informations contenues dans cette section concernent uniquement les applications de première génération. *Si vous souhaitez déployer automatiquement les modifications d'infrastructure et de code d'application à partir des branches de fonctionnalités d'une application de deuxième génération, consultez la [section Déploiements de branches Fullstack](https://docs.amplify.aws/nextjs/deploy-and-host/fullstack-branching/branch-deployments/) dans la documentation Amplify*
Amplify prend en charge la génération automatique au moment de la génération du fichier de configuration `aws-exports.js` Amplify pour les applications de première génération. En désactivant les déploiements CI/CD complets, vous permettez à votre application de générer automatiquement le `aws-exports.js` fichier et de vous assurer qu'aucune mise à jour n'est apportée à votre backend au moment de la création.
**Pour générer automatiquement au `aws-exports.js` moment de la construction**
1. Connectez-vous à la console [Amplify AWS Management Console](https://console.aws.amazon.com/amplify/) et ouvrez-la.
1. Choisissez l'application à modifier.
1. Choisissez l'onglet **Environnements d'hébergement**.
1. Localisez la branche à modifier et choisissez **Modifier**.
![\[Emplacement du lien Modifier pour une branche dans la console Amplify.\]](http://docs.aws.amazon.com/fr_fr/amplify/latest/userguide/images/amplify_edit_backend_alternate.png)
1. Sur la page **Modifier le backend cible**, décochez **Activer les déploiements continus full-stack (CI/CD) pour désactiver le CI/CD full** stack pour ce backend.
![\[Emplacement de la case à cocher à désactiver CI/CD dans la console Amplify.\]](http://docs.aws.amazon.com/fr_fr/amplify/latest/userguide/images/amplify_turnoff_CICD.png)
1. Sélectionnez un rôle de service existant pour accorder à Amplify les autorisations dont il a besoin pour apporter des modifications au backend de votre application. Si vous devez créer un rôle de service, choisissez **Créer un nouveau rôle**. Pour plus d'informations sur la création d'un rôle de service, consultez la section [Ajouter un rôle de service avec des autorisations pour déployer des ressources de backend](amplify-service-role.md).
1. Choisissez **Enregistrer**. Amplify appliquera ces modifications lors de la prochaine création de l'application.
# Constructions de backend conditionnelles (applications Gen 1 uniquement)
**Note**
Les informations contenues dans cette section concernent uniquement les applications de première génération. Amplify Gen 2 introduit une expérience de développement TypeScript basée sur le code et axée sur le code. Par conséquent, cette fonctionnalité n'est pas nécessaire pour les backends de 2e génération.
Amplify prend en charge les builds de backend conditionnels sur toutes les branches d'une application Gen 1. Pour configurer les versions conditionnelles du backend, définissez la variable d'`AMPLIFY_DIFF_BACKEND`environnement sur`true`. L'activation des versions conditionnelles du backend aidera à accélérer les builds où les modifications ne sont apportées qu'au frontend.
Lorsque vous activez les versions de backend basées sur le diff, au début de chaque build, Amplify tente d'exécuter un diff sur le `amplify` dossier de votre référentiel. Si Amplify ne trouve aucune différence, il ignore l'étape de création du backend et ne met pas à jour vos ressources backend. Si votre projet ne contient aucun `amplify` dossier dans votre référentiel, Amplify ignore la valeur de la `AMPLIFY_DIFF_BACKEND` variable d'environnement. Pour obtenir des instructions sur la définition de la variable d'`AMPLIFY_DIFF_BACKEND`environnement, consultez[Configuration de versions de backend basées sur les différences pour une application de première génération](edit-build-settings.md#enable-diff-backend).
Si des commandes personnalisées sont actuellement spécifiées dans les paramètres de génération de votre phase de backend, les builds de backend conditionnels ne fonctionneront pas. Si vous souhaitez que ces commandes personnalisées s'exécutent, vous devez les déplacer vers la phase frontale de vos paramètres de génération dans le `amplify.yml` fichier de votre application. Pour plus d'informations sur la mise à jour du `amplify.yml` fichier, consultez[Référence de spécification de construction](yml-specification-syntax.md).
# Utiliser les backends Amplify dans toutes les applications (applications de première génération uniquement)
**Note**
Les informations contenues dans cette section concernent uniquement les applications de première génération. Si vous souhaitez partager les ressources du backend d'une application de deuxième génération, consultez la section [Partager les ressources entre les branches](https://docs.amplify.aws/nextjs/deploy-and-host/fullstack-branching/share-resources/) dans la documentation *Amplify*
Amplify vous permet de réutiliser les environnements backend existants dans toutes vos applications de première génération dans une région donnée. Vous pouvez le faire lorsque vous créez une nouvelle application, connectez une nouvelle branche à une application existante ou mettez à jour un frontend existant pour qu'il pointe vers un autre environnement principal.
## Réutiliser les backends lors de la création d'une nouvelle application
**Pour réutiliser un backend lors de la création d'une nouvelle application Amplify**
1. Connectez-vous à la console [Amplify AWS Management Console](https://console.aws.amazon.com/amplify/) et ouvrez-la.
1. Pour créer un nouveau backend à utiliser dans cet exemple, procédez comme suit :
1. Dans le volet de navigation, sélectionnez **Toutes les applications**.
1. Choisissez **Nouvelle application**, puis **Créez une application**.
1. Entrez un nom pour votre application, par exemple**Example-Amplify-App**.
1. Choisissez **Confirmer le déploiement**.
1. Pour connecter un frontend à votre nouveau backend, choisissez l'onglet **Environnements d'hébergement.**
1. Choisissez votre fournisseur Git, puis sélectionnez **Connect branch**.
1. Sur la page **Ajouter une branche de référentiel**, pour **Référentiels récemment mis à jour**, choisissez le nom de votre référentiel. Pour **Branch**, sélectionnez la branche de votre référentiel à connecter.
1. Sur la page **des paramètres** de compilation, effectuez les opérations suivantes :
1. Dans **Nom de l'application**, sélectionnez l'application à utiliser pour ajouter un environnement principal. Vous pouvez choisir l'application actuelle ou n'importe quelle autre application de la région actuelle.
1. Pour **Environnement**, sélectionnez le nom de l'environnement principal à ajouter. Vous pouvez utiliser un environnement existant ou en créer un nouveau.
1. Par défaut, la fonction full stack CI/CD est désactivée. La désactivation du CI/CD complet entraîne l'exécution de l'application en mode *pull* uniquement. Au moment de la création, Amplify générera automatiquement le `aws-exports.js` fichier uniquement, sans modifier votre environnement principal.
1. Sélectionnez un rôle de service existant pour accorder à Amplify les autorisations dont il a besoin pour apporter des modifications au backend de votre application. Si vous devez créer un rôle de service, choisissez **Créer un nouveau rôle**. Pour plus d'informations sur la création d'un rôle de service, consultez la section [Ajouter un rôle de service avec des autorisations pour déployer des ressources de backend](amplify-service-role.md).
1. Choisissez **Suivant**.
1. Choisissez **Save and deploy** (Enregistrer et déployer).
## Réutiliser les backends lors de la connexion d'une branche à une application existante
**Pour réutiliser un backend lors de la connexion d'une branche à une application Amplify existante**
1. Connectez-vous à la console [Amplify AWS Management Console](https://console.aws.amazon.com/amplify/) et ouvrez-la.
1. Choisissez l'application à laquelle connecter une nouvelle succursale.
1. Dans le volet de navigation, choisissez **Paramètres de l'application**, **Général**.
1. Dans la section **Branches**, choisissez **Connect a branch**.
1. Sur la page **Ajouter une branche de dépôt**, pour **Branch**, sélectionnez la branche de votre référentiel à connecter.
1. Dans **Nom de l'application**, sélectionnez l'application à utiliser pour ajouter un environnement principal. Vous pouvez choisir l'application actuelle ou n'importe quelle autre application de la région actuelle.
1. Pour **Environnement**, sélectionnez le nom de l'environnement principal à ajouter. Vous pouvez utiliser un environnement existant ou en créer un nouveau.
1. Si vous devez configurer un rôle de service pour accorder à Amplify les autorisations nécessaires pour apporter des modifications au backend de votre application, la console vous invite à effectuer cette tâche. Pour plus d'informations sur la création d'un rôle de service, consultez la section [Ajouter un rôle de service avec des autorisations pour déployer des ressources de backend](amplify-service-role.md).
1. Par défaut, la fonction full stack CI/CD est désactivée. La désactivation de Full-Stack CI/CD entraîne l'exécution de l'application en mode *pull uniquement*. Au moment de la création, Amplify générera automatiquement le `aws-exports.js` fichier uniquement, sans modifier votre environnement principal.
1. Choisissez **Suivant**.
1. Choisissez **Save and deploy** (Enregistrer et déployer).
## Modifier un frontend existant pour qu'il pointe vers un autre backend
**Pour modifier un frontend, l'application Amplify afin qu'elle pointe vers un autre backend**
1. Connectez-vous à la console [Amplify AWS Management Console](https://console.aws.amazon.com/amplify/) et ouvrez-la.
1. Choisissez l'application dont vous souhaitez modifier le backend.
1. Choisissez l'onglet **Environnements d'hébergement**.
1. Localisez la branche à modifier et choisissez **Modifier**.
![\[Emplacement du lien Modifier pour une branche dans la console Amplify.\]](http://docs.aws.amazon.com/fr_fr/amplify/latest/userguide/images/amplify_edit_backend.png)
1. Sur la page **Sélectionnez un environnement principal à utiliser avec cette branche**, dans **Nom de l'application**, sélectionnez l'application frontale dont vous souhaitez modifier l'environnement principal. Vous pouvez choisir l'application actuelle ou n'importe quelle autre application de la région actuelle.
1. Pour **l'environnement principal**, sélectionnez le nom de l'environnement principal à ajouter.
1. Par défaut, Full-Stack CI/CD est activé. Décochez cette option pour désactiver le full stack CI/CD pour ce backend. La désactivation de Full-Stack CI/CD entraîne l'exécution de l'application en mode *pull uniquement*. Au moment de la création, Amplify générera automatiquement le `aws-exports.js` fichier uniquement, sans modifier l'environnement principal.
1. Choisissez **Enregistrer**. Amplify appliquera ces modifications lors de la prochaine création de l'application.