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 pile CloudFormation qui se synchronise avec un référentiel Git à l’aide de synchronisation Git.

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 AWS Management Console et ouvrez la console CloudFormation à l’adresse https://console.aws.amazon.com/cloudformation.

  2. Dans la barre de navigation en haut de l’écran, choisissez la Région AWS dans laquelle vous souhaitez créer la pile.

  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 des modèles, sélectionnez Choisir un référentiel Git lié pour choisir un référentiel Git déjà lié à CloudFormation, ou Lier un référentiel 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 Enterprise Server

      • 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

    La synchronisation Git ne surveille que la branche sélectionnée pour les modifications apportées au modèle CloudFormation et aux fichiers de déploiement de pile. 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.

    Si CloudFormation génère le fichier pour vous, c’est ici que le fichier sera enregistré dans votre référentiel. 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 comprend les autorisations requises pour que CloudFormation synchronise la pile à partir de 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 CloudFormation publie les informations relatives aux ensembles de modifications dans les demandes d’extraction pour les mises à jour de pile, laissez l’option Activer les commentaires sur les requêtes pull activée.

    • Si vous désactivez cette option, CloudFormation ne décrira pas les différences entre la configuration actuelle de la pile et les modifications proposées dans les demandes d’extraction lorsque les fichiers du référentiel seront 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, consultez 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, consultez 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 votre référentiel Git pour détecter les modifications.

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, CloudFormation met automatiquement à jour la pile. 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 console CloudFormation, vous pouvez sélectionner la pile et choisir l’onglet Synchronisation Git pour afficher des informations sur l’état de la pile et les événements de synchronisation. Pour de plus amples informations, consultez Tableau de bord d’état de la synchronisation Git.