Utilisation Application Manager pour gérer les CloudFormation modèles - AWS Systems Manager

• Le AWS Systems Manager CloudWatch tableau de bord ne sera plus disponible après le 30 avril 2026. Les clients peuvent continuer à utiliser CloudWatch la console Amazon pour consulter, créer et gérer leurs CloudWatch tableaux de bord Amazon, comme ils le font aujourd'hui. Pour plus d'informations, consultez la documentation Amazon CloudWatch Dashboard.

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 CloudFormation modèles

Application Manager, un outil dans 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

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 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 les documents SSM avant de commencer à travailler avec des CloudFormation modèles dansApplication Manager.

Pour afficher la bibliothèque de modèles dans Application Manager
  1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

  2. Dans le panneau de navigation, sélectionnez Application Manager.

  3. Choisissez la bibliothèque de CloudFormation modèles.

Création d'un modèle

La procédure suivante décrit comment créer un CloudFormation modèle dansApplication 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 vous n'êtes pas familiarisé avec JSON ou YAML, vous pouvez utiliser AWS Infrastructure Composer, un outil permettant de créer et de modifier visuellement des 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 consulter des extraits pour des instances Amazon Elastic Compute Cloud (Amazon EC2), des domaines Amazon Simple Storage Service (Amazon S3 CloudFormation ), des mappages, 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 CloudFormation modèle dans Application Manager (console)

Utilisez la procédure suivante pour créer un CloudFormation modèle dans à Application Manager l'aide du AWS Management Console.

Pour créer un CloudFormation modèle dans Application Manager
  1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

  2. Dans le panneau de navigation, sélectionnez Application Manager.

  3. Choisissez Bibliothèque de CloudFormation modèles, puis choisissez Créer un modèle ou choisissez un modèle existant, puis sélectionnez Actions, Cloner.

  4. Pour Nom, saisissez un nom pour le modèle, qui vous aidera à identifier les ressources créées ou le but de la pile.

  5. (Facultatif) Pour Nom de la version, saisissez un nom ou un numéro pour identifier la version du modèle.

  6. Dans la section Éditeur de code, sélectionnez YAML ou JSON, puis saisissez ou copiez et collez votre code de modèle.

  7. (Facultatif) Dans la section Balises, appliquez une ou plusieurs name/value paires de clés de balise au modèle.

  8. (Facultatif) Dans la section Autorisations, entrez un Compte AWS identifiant et choisissez Ajouter un compte. Cette action fournit une autorisation en lecture au modèle. Le propriétaire du compte peut approvisionner et cloner le modèle, mais il ne peut ni le modifier ni le supprimer.

  9. Sélectionnez Create (Créer). Le modèle est enregistré dans le service Document Systems Manager (SSM).

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

Après avoir créé le contenu de votre CloudFormation modèle au format JSON ou YAML, vous pouvez utiliser le AWS Command Line Interface (AWS CLI) ou Outils AWS pour PowerShell pour enregistrer le modèle en tant que document SSM. Remplacez chaque example resource placeholder par vos propres informations.

Avant de commencer

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

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

Pour modifier un CloudFormation modèle dans Application Manager
  1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

  2. Dans le panneau de navigation, sélectionnez Application Manager.

  3. Choisissez la bibliothèque CloudFormation de modèles

  4. Sélectionnez une règle, puis sélectionnez Actions, Edit (Modifier). Vous ne pouvez pas modifier le nom d'un modèle, mais tous les autres détails sont modifiables.

  5. Sélectionnez Enregistrer. Le modèle est enregistré dans le service Document Systems Manager.