AWS CloudFormation Procédure pas à pas de Git Sync - AWS CloudFormation
Étape 1 : Créer la pileÉtape 2 : Spécifier les détails de la pileÉtape 3 : Configurer les options de la pileÉtape 4 : Vérifier et déployerModification de la pile

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.

AWS CloudFormation Procédure pas à pas de Git Sync

Apprenez à utiliser la synchronisation Git en suivant la procédure pas à pas ci-dessous. Avant de commencer, assurez-vous de remplir les prérequis pour la synchronisation Git.

Étape 1 : Créer la pile

  1. Accédez à la CloudFormationconsole.

  2. Sélectionnez Créer la pile.

  3. Dans le tableau de bord Créer une pile, dans le panneau Prérequis - Préparer le modèle, vérifiez que l'option Choisir un modèle existant est sélectionnée.

  4. Dans le volet Spécifier le modèle, choisissez Synchroniser à partir de Git.

  5. Sélectionnez Suivant pour spécifier les détails de la pile.

Étape 2 : Spécifier les détails de la pile

  1. Dans le volet Donner un nom à la pile, saisissez un nom pour votre pile. Les noms de pile peuvent contenir des lettres (A à Z et a à z), des chiffres (0 à 9) et des tirets (-).

  2. Le fichier de déploiement de la pile comporte deux options :

    • Créer le fichier en utilisant les paramètres suivants et le placer dans mon référentiel.

      Choisissez cette option si vous souhaitez que la synchronisation Git crée le fichier de déploiement de la pile et le place dans votre référentiel.

    • Je fournis mon propre fichier dans mon référentiel.

      Choisissez cette option si vous avez créé un fichier de déploiement de la pile et l’avez ajouté à votre référentiel.

    Pour plus d’informations, consultez Fichier de déploiement de pile.

  3. Le volet Référentiel de définition du modèle comporte deux options :

    • Choisir un référentiel Git lié

    • Lier un référentiel Git

    Si vous avez déjà lié un dépôt Git à CloudFormation, sélectionnez Choisir un dépôt Git lié et passez à l'étape suivante. Sinon, suivez les étapes ci-dessous pour connecter un référentiel Git :

    1. Choisissez Lier un référentiel Git.

    2. Choisissez votre fournisseur de référentiel Git parmi les suivants :

      • GitHub

      • GitHub Entreprise

      • GitLab

      • Bitbucket

    3. Choisissez une Connexion dans la liste. Si aucune option n’apparaît dans la liste Connexion, accédez à la console Connexions pour créer une connexion à votre référentiel.

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

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

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

  7. 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 CloudFormation compte. Si vous choisissez de générer un nouveau rôle, les autorisations requises sont incluses dans le rôle.

    Note

    Pour obtenir des informations importantes sur les autorisations requises et la politique d’approbation pour la synchronisation Git, consultez Autorisations nécessaires.

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

  9. Ajoutez les paramètres de votre pile que vous souhaitez définir à partir de votre fichier de déploiement de pile. Les paramètres sont des paires clé-valeur. Par exemple, pour ajouter le paramètre port au fichier de déploiement de la pile :

    1. Choisissez Ajouter un paramètre.

    2. Pour Clé, entrez port.

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

    4. Répétez les étapes précédentes pour tous les paramètres de la pile que vous souhaitez rendre disponibles dans votre fichier de déploiement de pile.

  10. (Facultatif) Ajoutez des balises. Les balises sont des paires clé-valeur que vous pouvez utiliser pour identifier et classer les ressources de la pile. Pour ajouter des balises au déploiement de la pile, suivez la même procédure que pour l’ajout de paramètres.

  11. Choisissez Suivant pour passer à Configurer les options de la pile.

Étape 3 : Configurer les options de la pile

Pour plus d’informations sur les options de configuration de la pile, consultez Configuration des options de AWS CloudFormation pile.

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

Étape 4 : Vérifier et déployer

  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.

  2. Choisissez Envoyer pour créer la pile.

    Important

    Une demande d’extraction est automatiquement créée dans votre référentiel Git lorsque vous choisissez Envoyer. Vous devez fusionner cette demande d’extraction dans votre référentiel Git pour terminer le processus. Lorsque vous fusionnez la pull request, la pile est créée et Git sync surveille le CloudFormation modèle et le fichier de déploiement de la pile pour détecter les modifications nécessaires à la mise à jour de la pile.

Modification de la pile

Après avoir effectué les étapes précédentes, une nouvelle pile est créée et CloudFormation surveille les modifications apportées à votre dépôt Git.

Pour modifier la pile, apportez les modifications directement au fichier de déploiement de la pile. Ensuite, validez-les dans le référentiel et la branche que vous avez configurés pour la pile dans la synchronisation Git.

Dans le CloudFormation tableau de bord, 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 plus d'informations, voir AWS CloudFormation Tableau de bord de l'état de synchronisation Git.