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.

Utilisation d’Application Manager pour gérer les modèles CloudFormation

Application Manager, un outil d’AWS Systems Manager, inclut une bibliothèque de modèles et d’autres outils pour vous aider à gérer des modèles AWS CloudFormation. Cette section comprend les informations suivantes.

Utilisation de la bibliothèque de modèles

La bibliothèque de modèles Application Manager vous fournit des outils pour afficher, créer, modifier, supprimer et cloner des modèles. Vous pouvez également approvisionner des piles directement à partir de la bibliothèque de modèles. Les modèles sont stockés sous forme de documents Systems Manager (SSM) du type CloudFormation. En stockant des modèles sous forme de documents SSM, vous pouvez utiliser des contrôles de version pour utiliser différentes versions d'un modèle. Vous pouvez également définir des autorisations et partager des modèles. Une fois l'approvisionnement d'une pile réussi, la pile et le modèle sont disponibles dans Application Manager et CloudFormation.

Avant de commencer

Nous vous recommandons de lire les rubriques suivantes pour en savoir plus sur les documents SSM avant de commencer à travailler avec les modèles CloudFormation dans Application Manager.

Création d'un modèle

La procédure suivante décrit la création d'un modèle CloudFormation dans Application Manager. Lorsque vous créez un modèle, vous saisissez les détails de la pile du modèle au format JSON ou YAML. Si le format JSON ou YAML ne vous est pas familier, vous pouvez utiliser AWS Infrastructure Composer, un outil destiné à la création et la modification visuelles de modèles. Pour plus d’informations, consultez Créer des modèles visuellement avec Infrastructure Composer dans le guide de l’utilisateur AWS CloudFormation. Pour plus d’informations sur la structure et la syntaxe d’un modèle, consultez Sections du modèle CloudFormation dans le guide de l’utilisateur AWS CloudFormation.

Vous pouvez également créer un modèle à partir de plusieurs extraits de modèle. Les extraits de modèle proposent des exemples qui montrent comment écrire des modèles pour une ressource déterminée. Par exemple, vous pouvez afficher des extraits pour les instances Amazon Elastic Compute Cloud (Amazon EC2), les domaines Amazon Simple Storage Service (Amazon S3), les mappages CloudFormation, etc. Les extraits sont regroupés par ressource. Vous pouvez trouver des extraits CloudFormation polyvalents dans la section Extraits de modèle généraux du Guide de l'utilisateur AWS CloudFormation.

Création d'un modèle CloudFormation dans Application Manager (console)

Procédez comme suit pour créer un modèle CloudFormation dans Application Manager en utilisant la the console.

Création d'un modèle CloudFormation dans Application Manager (ligne de commande)

Après avoir créé le contenu de votre modèle CloudFormation au format JSON ou YAML, vous pouvez utiliser la AWS Command Line Interface (AWS CLI) ou Outils AWS pour PowerShell pour enregistrer le modèle sous forme de document SSM. Remplacez chaque example resource placeholder (espace réservé pour les ressources) avec vos propres informations.

Avant de commencer

Installez et configurez l'AWS CLI ou Outils AWS pour PowerShell si vous ne l'avez pas déjà fait. Pour plus d'informations, consultez la section Installation ou mise à jour de la version la plus récente de l'AWS CLI et Installation d'Outils AWS pour PowerShell.

Linux & macOS

aws ssm create-document \
    --content file://path/to/template_in_json_or_yaml \
    --name "a_name_for_the_template" \
    --document-type "CloudFormation" \
    --document-format "JSON_or_YAML" \
    --tags "Key=tag-key,Value=tag-value"

Windows

aws ssm create-document ^
    --content file://C:\path\to\template_in_json_or_yaml ^
    --name "a_name_for_the_template" ^
    --document-type "CloudFormation" ^
    --document-format "JSON_or_YAML" ^
    --tags "Key=tag-key,Value=tag-value"

PowerShell

$json = Get-Content -Path "C:\path\to\template_in_json_or_yaml | Out-String
New-SSMDocument `
    -Content $json `
    -Name "a_name_for_the_template" `
    -DocumentType "CloudFormation" `
    -DocumentFormat "JSON_or_YAML" `
    -Tags "Key=tag-key,Value=tag-value"

Si elle aboutit, la commande renvoie une réponse semblable à la suivante :

{
    "DocumentDescription": {
        "Hash": "c1d9640f15fbdba6deb41af6471d6ace0acc22f213bdd1449f03980358c2d4fb",
        "HashType": "Sha256",
        "Name": "MyTestCFTemplate",
        "Owner": "428427166869",
        "CreatedDate": "2021-06-04T09:44:18.931000-07:00",
        "Status": "Creating",
        "DocumentVersion": "1",
        "Description": "My test template",
        "PlatformTypes": [],
        "DocumentType": "CloudFormation",
        "SchemaVersion": "1.0",
        "LatestVersion": "1",
        "DefaultVersion": "1",
        "DocumentFormat": "YAML",
        "Tags": [
            {
                "Key": "Templates",
                "Value": "Test"
            }
        ]
    }

Modification d'un modèle

Procédez comme suit pour modifier un modèle CloudFormation dans Application Manager. Les modifications de modèle sont disponibles dans CloudFormation après l'approvisionnement d'une pile qui utilise le modèle mis à jour.