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 Application Manager pour gérer les AWS CloudFormation modèles

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

Utilisation de la bibliothèque de modèles

Le Application Manager La bibliothèque de modèles fournit des outils pour vous aider à 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 de type Systems Manager (SSM)CloudFormation. En stockant les modèles sous forme de SSM documents, vous pouvez utiliser les contrôles de version pour travailler avec différentes versions d'un modèle. Vous pouvez également définir des autorisations et partager des modèles. Une fois que vous avez correctement approvisionné une pile, 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 SSM les documents avant de commencer à travailler avec des CloudFormation modèles dans Application Manager.

Création d'un modèle

La procédure suivante décrit comment créer un CloudFormation modèle dans Application Manager. Lorsque vous créez un modèle, vous entrez les détails de la pile du modèle dans JSON ouYAML. Si vous ne connaissez pas JSON ou YAML si vous pouvez utiliser AWS CloudFormation Designer, un outil permettant de créer et de modifier visuellement des modèles. Pour plus d'informations, consultez Qu'est-ce que AWS CloudFormation Designer ? dans le AWS CloudFormation Guide de l'utilisateur. Pour plus d'informations sur la structure et la syntaxe d'un modèle, consultez Anatomie du modèle.

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 consulter des extraits pour des instances Amazon Elastic Compute Cloud (AmazonEC2), des domaines Amazon Simple Storage Service (Amazon S3), des mappages, etc. AWS CloudFormation Les extraits sont regroupés par ressource. Vous pouvez trouver des extraits AWS CloudFormation polyvalents dans la section Extraits de modèle généraux du Guide de l'utilisateur AWS CloudFormation .

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

Utilisez la procédure suivante pour créer un CloudFormation modèle dans Application Manager en utilisant le AWS Management Console.

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

Après avoir créé le contenu de votre CloudFormation modèle dans JSON ouYAML, vous pouvez utiliser le AWS Command Line Interface (AWS CLI) ou AWS Tools for PowerShell pour enregistrer le modèle en tant que SSM document. Remplacez chacun example resource placeholder avec vos propres informations.

Avant de commencer

Installez et configurez le AWS CLI ou le AWS Tools for 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' AWS Tools for 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

Utilisez la procédure suivante pour modifier un CloudFormation modèle dans Application Manager. Les modifications de modèle sont disponibles une CloudFormation fois que vous avez provisionné une pile utilisant le modèle mis à jour.