• 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
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.
# Tutoriel : Création d’un runbook à l’aide de l’expérience de conception visuelle
Dans ce tutoriel, vous apprendrez les bases de l’utilisation de l’expérience de conception visuelle fournie par Systems Manager Automation. Dans le cadre de l’expérience de conception visuelle, vous pouvez créer un runbook qui utilise plusieurs actions. Vous utilisez la fonctionnalité glisser-déposer pour organiser les actions sur le canevas. Vous pouvez également rechercher, sélectionner et configurer ces actions. Vous pouvez ensuite afficher le code YAML généré automatiquement pour le flux de travail de votre runbook, quitter l’expérience de conception visuelle, exécuter le runbook et consulter les détails d’exécution.
Ce tutoriel explique également comment mettre à jour le runbook et afficher la nouvelle version. À la fin du tutoriel, vous effectuez une étape de nettoyage et supprimez votre runbook.
Après avoir terminé ce tutoriel, vous saurez comment utiliser l’expérience de conception visuelle pour créer un runbook. Vous saurez également comment mettre à jour, exécuter et supprimer votre runbook.
**Note**
Avant de commencer ce tutoriel, assurez-vous d’avoir terminé [Configuration d'Automation](automation-setup.md).
**Topics**
+ [Étape 1 : Navigation vers l’expérience de conception visuelle](#navigate-console)
+ [Étape 2 : Création d’un flux de travail](#create-workflow)
+ [Étape 3 : Vérification du code généré automatiquement](#view-generated-code)
+ [Étape 4 : Exécution de votre nouveau runbook](#use-tutorial-runbook)
+ [Étape 5 : nettoyer](#cleanup-tutorial-runbook)
## Étape 1 : Navigation vers l’expérience de conception visuelle
1. Connectez-vous à la [console Systems Manager Automation](https://console.aws.amazon.com/systems-manager/automation/home?region=us-east-1#/).
1. Sélectionnez **Créer un runbook d’Automatisation**.
## Étape 2 : Création d’un flux de travail
Dans l’expérience de conception visuelle, un flux de travail est une représentation graphique de votre runbook sur le canevas. Vous pouvez utiliser l’expérience de conception visuelle pour définir, configurer et examiner les actions individuelles de votre runbook.
**Pour créer un flux de travail**
1. À côté du bouton **Design** et **Code**, sélectionnez l’icône en forme de crayon et saisissez le nom de votre runbook. Dans le cadre de ce didacticiel, entrez **VisualDesignExperienceTutorial**.
![\[Expérience de conception visuelle : nommez votre runbook\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/images/visual_designer_tutorial_name.png)
1. Dans la section **Attributs du document** du panneau **Formulaire**, développez le menu déroulant **Paramètres d’entrée**, puis sélectionnez **Ajouter un paramètre**.
1. Dans le champ **Nom du paramètre**, saisissez **InstanceId**.
1. Dans le menu déroulant **Type**, sélectionnez **AWS::EC2::Instance**.
1. Sélectionnez le bouton **Obligatoire**.
![\[Créez un paramètre pour votre runbook\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/images/visual_designer_actions_tutorial_parameter.png)
1. Dans le **AWS APIs**navigateur, entrez **DescribeInstances** dans la barre de recherche.
1. Faites glisser une DescribeInstances action **Amazon EC2** vers le canevas vide.
1. Pour **Nom étape**, saisissez une valeur. Pour ce tutoriel, vous pouvez utiliser le nom **GetInstanceState**.
![\[Choisissez une action d’API de description des instances Amazon EC2.\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/images/visual_designer_tutorial_api_action.png)
1. Développez le menu déroulant **Entrées supplémentaires**, puis dans le champ **Nom de l’entrée**, saisissez **InstanceIds**.
1. Sélectionnez l’onglet **Entrées**.
1. Dans le champ **Valeur d’entrée**, sélectionnez l’entrée du document **InstanceId**. Cela fait référence à la valeur du paramètre d’entrée que vous avez créé au début de la procédure. Étant donné que l'**InstanceIds**entrée de l'`DescribeInstances`action accepte `StringList` des valeurs, vous devez placer l'**InstanceId**entrée entre crochets. Le YAML pour la **valeur d’entrée** doit correspondre à ce qui suit : **['\$1\$1 InstanceId \$1\$1']**.
1. Dans l’onglet **Sorties**, sélectionnez **Ajouter une sortie** et saisissez **InstanceState** dans le champ **Nom**.
1. Dans le champ **Sélecteur**, saisissez **\$1.Reservations[0].Instances[0].State.Name**.
1. Dans le menu déroulant **Type**, sélectionnez **String**.
1. Faites glisser une action **Branche** depuis le navigateur **Actions**, puis déposez-la en dessous de l’étape **`GetInstanceState`**.
1. Pour **Nom étape**, saisissez une valeur. Pour ce tutoriel, utilisez le nom `BranchOnInstanceState`.
Pour définir la logique de branchement, procédez comme suit :
1. Choisissez l’état **`Branch`** sur le canevas. Ensuite, sous **Entrées** et **Choix**, sélectionnez l’icône en forme de crayon pour modifier la **Règle n°1**.
1. Sélectionnez **Ajouter des conditions**.
1. Dans la boîte de dialogue **Conditions pour la règle n°1**, sélectionnez le résultat de l’étape **GetInstanceState.InstanceState** dans le menu déroulant **Variable**.
1. Pour **Opérateur**, sélectionnez **est égal à**.
1. Pour **Valeur**, sélectionnez **String** dans la liste déroulante. Saisissez **stopped**.
![\[Définissez une condition pour une action de branche.\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/images/visual_designer_tutorial_condition.png)
1. Sélectionnez **Enregistrer les conditions**.
1. Sélectionnez **Ajouter une nouvelle règle de choix**.
1. Sélectionnez **Ajouter des conditions** pour la **Règle n°2**.
1. Dans la boîte de dialogue **Conditions pour la règle n°2**, sélectionnez le résultat de l’étape **GetInstanceState.InstanceState** dans le menu déroulant **Variable**.
1. Pour **Opérateur**, sélectionnez **est égal à**.
1. Pour **Valeur**, sélectionnez **String** dans la liste déroulante. Saisissez **stopping**.
1. Sélectionnez **Enregistrer les conditions**.
1. Sélectionnez **Ajouter une nouvelle règle de choix**.
1. Pour la **Règle n°3**, sélectionnez **Ajouter des conditions**.
1. Dans la boîte de dialogue **Conditions pour la règle n°3**, sélectionnez le résultat de l’étape **GetInstanceState.InstanceState** dans le menu déroulant **Variable**.
1. Pour **Opérateur**, sélectionnez **est égal à**.
1. Pour **Valeur**, sélectionnez **String** dans la liste déroulante. Saisissez **running**.
1. Sélectionnez **Enregistrer les conditions**.
1. Dans la **Règle par défaut**, sélectionnez **Aller à la fin** pour l’**Etape par défaut**.
1. Faites glisser une action **Modifier l'état d'une instance** vers la zone vide **Faire glisser l'action ici** sous le **\$1\$1 GetInstanceState. InstanceState \$1\$1 == Condition « arrêtée »**.
1. Pour le **Nom de l’étape**, saisissez **StartInstance**.
1. Dans l'onglet **Entrées**, sous **Instance IDs**, choisissez la valeur d'entrée du **InstanceId**document dans le menu déroulant.
1. Pour l’**Etat souhaité**, spécifiez **`running`**.
1. Faites glisser une action **Attendre la AWS ressource** vers la zone vide **Faire glisser l'action ici** sous le **\$1\$1 GetInstanceState. InstanceState \$1\$1 == condition « d'arrêt »**.
1. Pour **Nom étape**, saisissez une valeur. Pour ce tutoriel, utilisez le nom `WaitForInstanceStop`.
1. Pour le champ **Service**, sélectionnez **Amazon EC2**.
1. Pour le champ **API**, sélectionnez **DescribeInstances**.
1. Pour le champ **Sélecteur de propriétés**, saisissez **\$1.Reservations[0].Instances[0].State.Name**.
1. Pour le paramètre **Valeurs souhaitées**, saisissez **`["stopped"]`**.
1. Dans l'onglet **Configuration** de l'**WaitForInstanceStop**action, choisissez dans le **StartInstance**menu déroulant **Étape suivante**.
1. Faites glisser une action **Exécuter la commande sur les instances** vers la zone vide **Drag action here** située sous le **\$1\$1 GetInstanceState. InstanceState \$1\$1 == condition « en cours d'exécution »**.
1. Pour le **Nom de l’étape**, saisissez **SayHello**.
1. Dans l’onglet **Entrées**, saisissez **AWS-RunShellScript** pour le paramètre **Nom du document**.
1. Pour **InstanceIds**, choisissez la valeur d'entrée du **InstanceId**document dans la liste déroulante.
1. Développez le menu déroulant **Entrées supplémentaires**, puis sélectionnez **Paramètres** dans le menu déroulant **Nom de l’entrée**.
1. Saisissez **`{"commands": "echo 'Hello World'"}`** dans le champ **Valeur de l’entrée**.
1. Passez en revue le runbook terminé dans le canevas et sélectionnez **Créer un runbook** pour enregistrer le runbook du tutoriel.
![\[Vérifiez et créez le runbook.\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/images/visual_designer_tutorial_complete.png)
## Étape 3 : Vérification du code généré automatiquement
Lorsque vous glissez et déposez des actions depuis le navigateur **Actions** vers le canevas, l’expérience de conception visuelle compose automatiquement le contenu YAML ou JSON de votre runbook en temps réel. Vous pouvez consulter et modifier ce code. Pour afficher le code généré automatiquement, sélectionnez **Code** pour le commutateur **Conception** et **Code**.
## Étape 4 : Exécution de votre nouveau runbook
Après avoir créé votre runbook, vous pouvez exécuter l’automatisation.
**Pour exécuter votre nouveau runbook d’automatisation**
1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Dans le panneau de navigation, sélectionnez **Automation** (Automatisation), puis **Execute automation** (Exécuter l'automatisation).
1. Dans la liste **Automation document** (Document Automation), sélectionnez un runbook. Sélectionnez une ou plusieurs options dans le panneau **Document categories (Catégories de documents)** pour filtrer les documents SSM en fonction de leur but. Pour afficher un runbook vous appartenant, sélectionnez l'onglet **Owned by me (M'appartenant)**. Pour afficher un runbook partagé avec votre compte, sélectionnez l'onglet **Shared with me (Partagé avec moi)**. Pour afficher tous les runbooks, sélectionnez l'onglet **All documents (Tous les documents)**.
**Note**
Vous pouvez consulter les informations sur un runbook en sélectionnant son nom.
1. Dans la section **Document details (Détails du document)**, vérifiez que l'option **Document version (Version de document)** correspond à la version que vous souhaitez exécuter. Le système inclut les options de version suivantes :
+ **Version par défaut lors de l’exécution** : sélectionnez cette option si le runbook d’Automatisation est mis à jour régulièrement et qu’une nouvelle version par défaut est attribuée.
+ **Dernière version lors de l’exécution** : sélectionnez cette option si le runbook d’Automatisation est mis à jour régulièrement et que vous souhaitez exécuter la dernière version mise à jour.
+ **1 (Par défaut)** : sélectionnez cette option pour exécuter la première version du document, qui est la version par défaut.
1. Choisissez **Suivant**.
1. Dans la section **Exécuter le runbook d’Automatisation**, sélectionnez **Exécution simple**.
1. Dans la section **Input parameters (Paramètres d'entrée)**, spécifiez les entrées obligatoires. Vous pouvez éventuellement choisir un rôle de service IAM dans la **AutomationAssumeRole**liste.
1. (Facultatif) Choisissez une CloudWatch alarme Amazon à appliquer à votre automatisation à des fins de surveillance. Pour associer une CloudWatch alarme à votre automatisation, le principal IAM qui lance l'automatisation doit être autorisé à effectuer l'`iam:createServiceLinkedRole`action. Pour plus d'informations sur les CloudWatch alarmes, consultez la section [Utilisation des CloudWatch alarmes Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html). Si votre alarme s’active, l’automatisation s’arrête. Si vous utilisez AWS CloudTrail, vous verrez l'appel d'API dans votre journal.
1. Sélectionnez **Execute (Exécuter)**.
## Étape 5 : nettoyer
**Pour supprimer votre runbook**
1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Dans le panneau de navigation, cliquez sur **Documents**.
1. Sélectionnez l’onglet **M’appartenant**.
1. Localisez le **VisualDesignExperienceTutorial**runbook.
1. Sélectionnez le bouton sur la page de la fiche du document, puis sélectionnez **Supprimer le document** dans le menu déroulant **Actions**.