Utilisation de l’expérience de conception visuelle - AWS Systems Manager

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 de l’expérience de conception visuelle

Apprenez à créer, modifier et exécuter des flux de travail runbook à l’aide de l’expérience de conception visuelle. Une fois que votre flux de travail est prêt, vous pouvez l’enregistrer ou l’exporter. Vous pouvez également utiliser l’expérience de conception visuelle pour un prototypage rapide.

Création d’un flux de travail runbook

  1. Connectez-vous à la console Systems Manager Automation.

  2. Sélectionnez Créer un runbook.

  3. Dans le champ Nom, saisissez le nom de votre runbook, MyNewRunbook, par exemple.

  4. À côté du bouton Design et Code, sélectionnez l’icône en forme de crayon et saisissez le nom de votre runbook.

Vous pouvez désormais concevoir un flux de travail pour votre nouveau runbook.

Conception d’un runbook

Pour concevoir un flux de travail runbook à l’aide de l’expérience de conception visuelle, vous devez faire glisser une action d’automatisation du navigateur Actions vers le canevas, en la plaçant là où vous le souhaitez dans le flux de travail de votre runbook. Vous pouvez également réorganiser les actions de votre flux de travail en les faisant glisser vers un autre emplacement. Lorsque vous faites glisser une action sur le canevas, une ligne apparaît à l’endroit où vous pouvez déposer l’action dans votre flux de travail. Une fois qu’une action est déposée sur le canevas, son code est généré automatiquement et ajouté au contenu de votre runbook.

Si vous connaissez le nom de l’action que vous souhaitez ajouter, utilisez le champ de recherche en haut du navigateur Actions pour trouver l’action.

Après avoir déposé une action sur le canevas, configurez-la à l’aide du panneau Formulaire sur la droite. Ce panneau contient les onglets Général, Entrées, Sorties et Configuration pour chaque action d’automatisation ou action d’API que vous placez sur le canevas. Par exemple, l’onglet Général comprend les sections suivantes :

  • Le Nom de l’étape identifie l’étape. Spécifiez une valeur unique pour le nom de l’étape.

  • La Description vous permet de décrire l’action en cours dans le flux de travail de votre runbook.

L’onglet Entrées contient des champs qui varient en fonction de l’action. Par exemple, l’action d’automatisation aws:executeScript comprend les sections suivantes :

  • L’exécution est le langage à utiliser pour exécuter le script fourni.

  • Le gestionnaire est le nom de votre fonction. Vous devez vous assurer que la fonction définie dans le gestionnaire possède deux paramètres : events et context. L’exécution de PowerShell ne prend pas en charge ce paramètre.

  • Script est un script incorporé que vous souhaitez exécuter pendant le flux de travail.

  • (Facultatif) La Pièce jointe est destinée aux scripts autonomes ou aux fichiers .zip qui peuvent être invoqués par l’action. Ce paramètre est obligatoire pour les runbook JSON.

L’onglet Sorties vous permet de spécifier les valeurs que vous souhaitez obtenir à partir d’une action. Vous pouvez référencer des valeurs de sortie dans des actions ultérieures de votre flux de travail ou générer des sorties à partir d’actions à des fins de journalisation. Toutes les actions n’auront pas d’onglet Sorties car toutes les actions ne prennent pas en charge les sorties. Par exemple, l’action aws:pause ne prend pas en charge les sorties. Pour les actions qui prennent en charge les sorties, l’onglet Sorties comprend les sections suivantes :

  • Le Nom est le nom à utiliser pour la valeur de sortie. Vous pouvez référencer les résultats dans des actions ultérieures de votre flux de travail.

  • Le Sélecteur est une chaîne d’expression JSONPath commençant par "$." qui est utilisée pour sélectionner un ou plusieurs composants au sein d’un élément JSON.

  • Le Type est le type de données pour la valeur de sortie. Par exemple, un type de donnée String ou Integer.

L’onglet Configuration contient des propriétés et des options utilisables par toutes les actions d’automatisation. L’action se compose des sections suivantes :

  • La propriété Maximal de tentatives indique le nombre de tentatives répétées d’une action en cas d’échec.

  • La propriété Délai en secondes spécifie la valeur du délai d’expiration d’une action.

  • La propriété Est critique détermine si l’échec de l’action arrête l’ensemble de l’automatisation.

  • La propriété Etape suivante détermine l’action à laquelle l’automatisation passe ensuite dans le runbook.

  • La propriété En cas d’échec détermine à quelle action l’automatisation passe ensuite dans le runbook en cas d’échec de l’action.

  • La propriété En cas d’annulation détermine à quelle action l’automatisation passe ensuite dans le runbook si l’action est annulée par un utilisateur.

Pour supprimer une action, vous pouvez utiliser l’espace arrière, la barre d’outils au-dessus du canevas ou cliquer avec le bouton droit de la souris et choisir Supprimer l’action.

Au fur et à mesure que votre flux de travail se développe, il se peut qu’il ne rentre pas dans le canevas. Pour adapter le flux de travail au canevas, essayez l’une des options suivantes :

  • Utilisez les commandes situées sur les panneaux latéraux pour redimensionner ou fermer les panneaux.

  • Utilisez la barre d’outils située en haut du canevas pour zoomer ou dézoomer le graphique du flux de travail.

Mise à jour de votre runbook

Vous pouvez mettre à jour un flux de travail de runbook existant en créant une nouvelle version de votre runbook. Les mises à jour de vos runbook peuvent être effectuées à l’aide de l’expérience de conception visuelle ou en modifiant directement le code. Pour mettre à jour un runbook existant, procédez comme suit :

  1. Connectez-vous à la console Systems Manager Automation.

  2. Sélectionnez le runbook que vous souhaitez mettre à jour.

  3. Choisissez Create new version (Créer une version).

  4. L’expérience de conception visuelle comporte deux volets : un volet de code et un volet de flux de travail visuel. Sélectionnez Design dans le volet du flux de travail visuel pour modifier votre flux de travail avec l’expérience de conception visuelle. Lorsque vous avez terminé, sélectionnez Créer une nouvelle version pour enregistrer les modifications et quitter.

  5. (Facultatif) Utilisez le volet de code pour modifier le contenu du runbook en YAML ou JSON.

Exportation de votre runbook

Pour exporter le code YAML ou JSON du flux de travail de votre runbook, ainsi qu’un graphique de votre flux de travail, procédez comme suit :

  1. Choisissez votre runbook dans la console Documents.

  2. Choisissez Create new version (Créer une version).

  3. Dans le menu déroulant Actions, sélectionnez si vous souhaitez exporter le diagramme ou le runbook, et sélectionnez le format que vous préférez.