Créez une pile à partir du code source du dépôt avec Git sync

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

Important

Avant de continuer, remplissez l'ensemble des conditions préalables de la section précédente.

Création d'une pile à partir du code source du référentiel

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

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

3. Sur la page Stacks, choisissez Create stack, puis choisissez With new resources (standard).

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

   1. Pour Prérequis - Préparer le modèle, maintenez la case Choisir un modèle existant sélectionnée.

   2. Pour Spécifier le modèle, choisissez Sync from Git, puis Next.

5. Sur la page Spécifier les détails de la pile, dans Nom de la pile, tapez le nom de votre pile. Les noms de pile peuvent contenir des lettres (A à Z et a à z), des chiffres (0 à 9) et des tirets (-).

6. 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 stack et que vous ne l'avez pas ajouté à votre référentiel, choisissez Créer le fichier en utilisant les paramètres suivants et placez-le dans mon référentiel.

   • Si vous avez un fichier de déploiement de pile dans votre référentiel, choisissez Je fournis mon propre fichier dans mon référentiel.

7. 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 dépôt Git, procédez comme suit :

   1. Pour Sélectionner le fournisseur de référentiel, choisissez l'une des options suivantes :

      • GitHub

      • GitHub Serveur d'entreprise

      • GitLab

      • Bitbucket

      • GitLab autogéré

   2. Pour Connexion, choisissez une connexion dans la liste. Si aucune option n'apparaît dans la liste des connexions, choisissez Ajouter une nouvelle connexion pour accéder à la console Connections et créer une connexion à votre référentiel.

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

9. 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.

10. 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.

11. Ajoutez un IAMrôle. Le IAM rôle inclut les autorisations requises CloudFormation pour synchroniser la pile depuis votre dépôt Git. Vous pouvez choisir Nouveau IAM rôle pour générer un nouveau rôle, ou choisir IAMRôle existant pour sélectionner un rôle existant parmi votre Compte AWS. Si vous choisissez de générer un nouveau rôle, les autorisations requises sont incluses dans le rôle.

12. Activez ou désactivez les commentaires lors d'une pull request :

    • 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.

13. 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.

14. (Facultatif) Pour spécifier les paramètres de la pile, choisissez Ajouter un paramètre, fournissez une clé et une valeur pour chaque paramètre, puis choisissez Suivant. Pour de plus amples informations, veuillez consulter Fichier de déploiement de pile.

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

    1. Choisissez Ajouter un paramètre.

    2. Pour Clé, entrez port.

    3. Pour le champ Value (Valeur), entrez 8080.

15. (Facultatif) Pour spécifier des balises de pile, choisissez Ajouter une nouvelle balise, fournissez une clé de balise et une valeur pour chaque balise, puis choisissez Next. Pour de plus amples informations, veuillez consulter Fichier de déploiement de pile.

16. Choisissez Suivant pour passer à Configurer les options de la pile. Pour plus d’informations sur les options de configuration de la pile, consultez Configurer les options de pile.

    Une fois la configuration terminée, choisissez Suivant pour passer à la vérification et au déploiement.

17. 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.

18. Choisissez Envoyer pour créer la pile.

    Une fois que vous avez choisi Soumettre, une pull request est automatiquement créée dans votre dépôt Git. Vous devez fusionner cette pull request dans votre dépôt Git pour créer votre stack. Une fois la pile créée, CloudFormation surveille les modifications apportées à votre dépôt Git.

Mettez à jour votre stack depuis votre dépôt Git

Pour mettre à jour la pile, apportez des modifications directement à votre fichier modèle ou à votre fichier de déploiement de pile dans votre dépôt 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 pull requests, une pull request est automatiquement créée dans votre dépôt Git avant que la pile ne soit mise à jour. Vous devez fusionner cette pull request dans votre dépôt Git pour mettre à jour votre stack.

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 de l'état de synchronisation Git.