Créez une pile à partir du code source du référentiel avec la synchronisation Git - AWS CloudFormation
Créer une pile à partir du code source du référentielMettez à jour votre pile depuis votre référentiel Git

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

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 de la section précédente.

Créer une pile à partir du code source du référentiel

  1. Connectez-vous à la 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 Piles, choisissez Créer une pile, puis Avec de nouvelles ressources (standard).

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

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

  5. 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 (-).

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

  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 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é

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

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

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

    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.

    2. Pour Clé, entrez port.

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

  15. (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.

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

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

  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.

    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

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.