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.

Comment fonctionne la synchronisation Git avec CloudFormation

Cette rubrique décrit le fonctionnement de la synchronisation Git et présente les concepts clés nécessaires à son utilisation.

Comment fonctionne la synchronisation Git

Pour utiliser la synchronisation Git, vous devez d’abord connecter un fournisseur Git à CloudFormation à l’aide du service CodeConnections. Dans les procédures décrites dans ce guide, la connexion est établie via la console CodeConnections. Vous pouvez également créer la connexion avec le AWS CLI. Vous pouvez utiliser l’un des fournisseurs Git suivants :

Ensuite, vous créez un modèle CloudFormation qui définit votre pile et vous l’ajoutez à votre référentiel. Ce fichier modèle est surveillé. CloudFormation met automatiquement à jour la pile lorsque des modifications y sont apportées.

Dans la console CloudFormation, vous créez une nouvelle pile et choisissez Sync. depuis Git pour indiquer à CloudFormation d’utiliser la synchronisation Git. Vous spécifierez le référentiel et la branche que vous voulez que CloudFormation surveille, ainsi que le modèle CloudFormation qui définit la pile dans votre référentiel.

Lors de la configuration, vous pouvez soit fournir votre propre fichier de déploiement de pile à partir de votre référentiel, soit demander à la synchronisation Git d’en générer un pour vous. Le fichier de déploiement de la pile contient des paramètres et des valeurs qui configurent les ressources de votre pile. Ce fichier de déploiement de pile est surveillé. CloudFormation met automatiquement à jour la pile lorsque des modifications y sont apportées.

La synchronisation Git crée une demande d’extraction dans votre référentiel pour synchroniser votre pile avec le fichier modèle CloudFormation et le fichier de déploiement de la pile. Si c’est la synchronisation Git qui génère le fichier de déploiement de la pile pour vous, ce fichier est envoyé à votre référentiel par la synchronisation Git.

Fusionnez ensuite la demande d’extraction dans votre référentiel afin que CloudFormation provisionne la pile, la configure avec vos paramètres de déploiement et commence à surveiller les modifications apportées à votre référentiel.

À partir de ce moment, chaque fois que vous apportez des modifications à votre fichier modèle ou à votre fichier de déploiement de pile et que vous les validez dans votre référentiel, CloudFormation détecte automatiquement les modifications. Si votre équipe utilise des requêtes pull, les membres de votre équipe peuvent alors examiner et approuver les modifications avant leur déploiement. Une fois la requête pull acceptée, CloudFormation déploie vos modifications.

Vous pouvez surveiller l’état de votre configuration de synchronisation Git pour la pile et consulter l’historique des commits appliqués à la pile dans la console CloudFormation. La console fournit également des outils pour reconfigurer la synchronisation  Git et résoudre les problèmes.

Commentaires sur les demandes d'extraction

Vous pouvez choisir de demander à CloudFormation de créer un résumé des modifications apportées au code dans les demandes d’extraction via le service CodeConnections en activant l’option Activer les commentaires sur les demandes d’extraction dans la console. Fournir un résumé des modifications apportées dans les demandes d’extraction permet aux membres de l’équipe d’examiner et de comprendre facilement l’impact des modifications proposées avant de fusionner la demande d’extraction. Pour de plus amples informations, consultez Activation de la publication par CloudFormation d’un résumé des modifications de pile dans les requêtes pull.

Fichier de déploiement de pile

Le fichier de déploiement de pile est un fichier au format JSON (JavaScript Object Notation) ou YAML standard qui contient des paramètres et des valeurs qui gèrent votre pile CloudFormation. Il est surveillé pour détecter les modifications. Lorsque les modifications apportées au fichier sont validées dans le référentiel, la pile associée est automatiquement mise à jour.

Le fichier de déploiement de pile contient une paire clé-valeur et deux dictionnaires :

Vous pouvez fournir votre propre fichier de déploiement de pile, ou demander à la synchronisation Git d’en créer un pour vous et d’envoyer automatiquement une demande d’extraction à votre référentiel. Vous pouvez gérer les paramètres et les balises en modifiant le fichier de déploiement de pile et en validant les modifications dans le référentiel.

Voici un exemple de fichier de déploiement de pile avec synchronisation Git :

template-file-path: fargate-srvc/my-stack-template.yaml

parameters: 
    image: public.ecr.aws/lts/nginx:latest
    task_size: x-small
    max_capacity: 5
    port: 8080
    env: production
tags:
    cost-center: '123456'
    org: 'AWS'

Fichier modèle CloudFormation

Le fichier modèle contient une déclaration des ressources AWS qui composent une pile CloudFormation. Avec la synchronisation Git, le fichier modèle est stocké dans votre référentiel Git et référencé par le fichier de déploiement de la pile. Vous pouvez gérer la pile en modifiant le fichier modèle et en validant les modifications dans le référentiel.

Pour de plus amples informations, consultez Utilisation de CloudFormation modèles.

Référentiel de définition du modèle

Le référentiel de définition du modèle est le référentiel Git lié à CloudFormation via la synchronisation Git. Le référentiel est surveillé pour détecter les modifications apportées au modèle CloudFormation et au fichier de déploiement de la pile. Lorsque vous validez les modifications apportées au fichier, la pile associée est automatiquement mise à jour.