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.

# Créez une pile à partir du code source du référentiel avec la synchronisation Git
<a name="git-sync-create-stack-from-repository-source-code"></a>

Cette rubrique explique comment créer une CloudFormation pile synchronisée avec un dépôt Git avec Git sync.

**Important**  
Avant de continuer, remplissez l'ensemble des [conditions préalables](git-sync-prereq.md) de la section précédente. 

## Créer une pile à partir du code source du référentiel
<a name="create-stack-from-repository-source-code"></a>

1. Connectez-vous à la CloudFormation console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)

1. Dans la barre de navigation en haut de l'écran, choisissez le Région AWS pour créer le stack in.

1. Sur la page **Piles**, choisissez **Créer une pile**, puis **Avec de nouvelles ressources (standard)**.

1. Sur la page **Créer une pile**, procédez de la manière suivante :

   1. Pour la **Condition préalable – Préparer le modèle**, laissez la case **Choisir un modèle existant** cochée.

   1. Pour **Spécifier le modèle**, choisissez **Sync. depuis Git**, puis **Suivant**.

1. Sur la page **Spécifier les détails de la pile**, entrez un nom pour la pile dans la zone **Nom de la pile**. Les noms de pile peuvent contenir des lettres (A à Z et a à z), des chiffres (0 à 9) et des tirets (-).

1. Pour le **fichier de déploiement Stack**, **création du fichier de déploiement** :
   + Si vous *n’avez pas* créé de fichier de déploiement de pile et ne l’avez pas ajouté à votre référentiel, sélectionnez **Créer le fichier à l’aide des paramètres suivants et le placer dans mon référentiel**.
   + Si votre référentiel contient un fichier de déploiement de pile, choisissez **Je fournis mon propre fichier dans mon référentiel.**

1. Pour le **référentiel de définition de modèles**, **choisissez Choisir un dépôt Git lié** pour choisir un dépôt Git auquel il est déjà lié CloudFormation, ou **Lier un dépôt Git** pour en lier un nouveau. Si vous choisissez **Lier un référentiel Git**, procédez comme suit :

   1. Pour **Sélectionner un fournisseur** de référentiel, choisissez l’une des options suivantes :
      + **GitHub**
      + **GitHub Serveur d'entreprise**
      + **GitLab**
      + **Bitbucket**
      + **GitLab autogéré**

   1. Pour la **connexion**, choisissez une connexion dans la liste. Si aucune option n’apparaît dans la liste **Connexion**, choisissez **Ajouter une nouvelle connexion** pour accéder à la [console Connexions](https://console.aws.amazon.com/codesuite/settings/connections) et créer une connexion à votre référentiel.

1. Dans la liste **Référentiel**, sélectionnez le référentiel Git qui contient votre fichier modèle de pile.

1. Dans la liste **Branche**, sélectionnez la branche que vous souhaitez que la synchronisation Git surveille.
**Note**  
Git sync surveille uniquement les modifications apportées au CloudFormation modèle et aux fichiers de déploiement de la pile dans la branche sélectionnée. Toutes les modifications que vous souhaitez appliquer à votre pile doivent être validées dans cette branche.

1. Pour le **chemin du fichier de déploiement**, spécifiez le chemin complet, y compris le nom du fichier de déploiement de la pile, à partir de la racine de la branche de votre référentiel.

   S' CloudFormation il génère le fichier pour vous, c'est ici que le fichier sera enregistré dans votre dépôt. Si vous fournissez le fichier, il s’agit de l’emplacement du fichier dans votre référentiel.

1. Ajoutez un **rôle IAM**. Le rôle IAM inclut les autorisations requises CloudFormation pour synchroniser la pile depuis votre référentiel Git. Vous pouvez choisir **Nouveau rôle IAM** pour générer un nouveau rôle, ou choisir **Rôle IAM existant** pour sélectionner un rôle existant dans votre Compte AWS. Si vous choisissez de générer un nouveau rôle, les autorisations requises sont incluses dans le rôle.

1. Activez ou désactivez les commentaires en cas de demande d’extraction :
   + Pour que les informations relatives à la CloudFormation post-modification soient définies dans les pull requests pour les mises à jour de la pile, maintenez le bouton **Activer le commentaire sur la pull request** activé.
   + Si vous désactivez cette option, je ne CloudFormation décrirai pas les différences entre la configuration actuelle de la pile et les modifications proposées dans les pull requests lorsque les fichiers de dépôt sont mis à jour.

1. Pour le **chemin du fichier modèle**, spécifiez le chemin complet de la racine de votre référentiel pour le fichier modèle de la pile.

1. (Facultatif) Pour spécifier les paramètres de la pile, sélectionnez **Ajouter un paramètre**, indiquez une clé et une valeur pour chaque paramètre, puis sélectionnez **Suivant**. Pour de plus amples informations, veuillez consulter [Fichier de déploiement de pile](git-sync-concepts-terms.md#git-sync-concepts-terms-depoyment-file).

   Par exemple, pour spécifier un paramètre **port=8080** dans votre fichier de déploiement de pile, procédez comme suit :

   1. Choisissez **Ajouter un paramètre**.

   1. Pour **Clé**, entrez **port**.

   1. Pour le champ **Value (Valeur)**, entrez **8080**.

1. (Facultatif) Pour spécifier des balises de pile, sélectionnez **Ajouter une nouvelle balise**, fournissez une clé et une valeur pour chaque balise, puis sélectionnez **Suivant**. Pour de plus amples informations, veuillez consulter [Fichier de déploiement de pile](git-sync-concepts-terms.md#git-sync-concepts-terms-depoyment-file).

1. Choisissez **Suivant** pour passer à **Configurer les options de la pile**. Pour plus d’informations sur les options de configuration de la pile, consultez [Configuration des options de pile](cfn-console-create-stack.md#configure-stack-options).

   Une fois la configuration de votre pile terminée, sélectionnez **Suivant** pour continuer.

1. Vérifiez les paramètres de votre pile et confirmez les points suivants :
   + Le modèle de pile est correctement configuré et défini sur **Synchronisation à partir de Git**.
   + Le fichier de déploiement est correctement configuré.
   + Le référentiel de définition du modèle est correctement configuré, en particulier en ce qui concerne la sélection du **Référentiel** et du **Nom de branche** corrects.
   + L’aperçu du fichier de déploiement est correct et contient les paramètres et valeurs attendus.

1. Choisissez **Envoyer** pour créer la pile.

   Après avoir sélectionné **Soumettre**, une demande d’extraction est automatiquement créée dans votre référentiel Git. Vous devez fusionner cette demande d’extraction dans votre référentiel Git pour créer votre pile. Une fois la pile créée, CloudFormation surveille les modifications apportées à votre dépôt Git.

## Mettez à jour votre pile depuis votre référentiel Git
<a name="update-stack-from-repository-source-code"></a>

Pour mettre à jour la pile, apportez les modifications directement dans votre fichier modèle ou dans le fichier de déploiement de la pile dans votre référentiel Git. Une fois que vous avez validé vos modifications dans la branche surveillée, la pile est CloudFormation automatiquement mise à jour. Si vous utilisez des requêtes pull, une requête pull est automatiquement créée dans votre référentiel Git avant la mise à jour de la pile. Vous devez fusionner cette demande d’extraction dans votre référentiel Git pour mettre à jour votre pile.

Dans la CloudFormation console, vous pouvez sélectionner la pile et choisir l'onglet **Git sync** pour afficher les informations relatives à l'état de la pile et aux événements de synchronisation. Pour de plus amples informations, veuillez consulter [Tableau de bord d’état de la synchronisation Git](git-sync-status.md).