Concevoir un Runbook avec Visual Designer
Utilisez le concepteur visuel pour concevoir et créer des carnets d'exécution personnalisés dans Fleet Application Management. Le concepteur fournit une interface de glisser avec une option pour ajouter du code afin que vous puissiez créer et modifier des runbooks plus facilement. Runbook peut être écrit en YAML ou JSON. Cependant, vous pouvez créer un dossier d'exécution sans avoir à le créer dans JSON natif ou YAML à l'aide du concepteur visuel.
Avec le concepteur visuel, vous pouvez effectuer les tâches suivantes :
- Concevez un dossier d'exécution à l'aide des composants du dossier d'exécution.
- Simplifiez l'exécution du livre d'exécution.
- Configurez les instructions conditionnelles avec le générateur de conditions.
- Configurer les exécutions de tâche conditionnelles en fonction des composants de produit, des variables d'entrée et de sortie, ou des deux.
- configuration du traitement des erreurs;
- Illustrer les livres d'exécution fournis par Fleet Application Management.
- Cloner des runbooks illustrés pour vous aider à créer des runbooks personnalisés dans lesquels vous ajoutez votre code en mode source ou concepteur.
Lorsque vous créez un dossier d'exécution, le concepteur visuel valide votre travail et génère automatiquement du code. Vous pouvez vérifier le code généré ou l'exporter pour le développement local. Après avoir créé le dossier d'exécution, vous pouvez l'enregistrer, le publier et examiner les résultats dans la console.
- Le volet actions du côté droit contient les onglets Composants et Propriétés.
- Le canvas au centre est un paramètre fictif dans lequel vous concevez le dossier d'exécution. Vous pouvez faire glisser les composants à partir du volet d'actions, tels que des groupes de ressources parallèles ou non, et faire glisser des tâches dans ces groupes. Vous pouvez modifier l'ordre des composants sur le canevas en les plaçant dans l'ordre dans lequel vous souhaitez exécuter les tâches, ou sélectionner des actions pour configurer les propriétés ou traiter les erreurs.
Le canevas contient également l'icône de modification à côté de chaque composant de tâche pour voir et modifier la tâche du dossier d'exécution.
Pour voir le code YAML ou JSON généré automatiquement pour le dossier d'exploitation lorsque vous utilisez le concepteur visuel, sélectionnez Vue de code dans le canevas. Lorsque vous mettez à jour YAML ou JSON, les modifications sont automatiquement générées en mode concepteur.
Volet d'actions
Dans le volet Actions, vous pouvez sélectionner les composants à faire glisser dans la zone de travail du canevas. Le volet contient les éléments suivants :
Onglet Composants
Pour ajouter une tâche, vous devez d'abord ajouter un groupe de ressources parallèle ou continu. Une tâche doit se trouver dans un groupe. Pour plus d'informations sur l'utilisation des types de groupe, voir Création d'un classeur d'exécution.
- Nouvelle tâche : Utilisez ce bouton pour créer des tâches pour un dossier d'exécution. Vous pouvez maintenant ajouter une tâche qui peut exécuter un script en spécifiant le type d'action en tant que script.
- Groupe de tâches parallèle : Toutes les tâches faisant partie d'un groupe de tâches parallèle sont exécutées en parallèle sur une ressource (ressources de calcul et de base de données) faisant partie d'un parc.
Par exemple, si un parc comporte deux ressources et deux tâches (task1 et task2) qui font partie du groupe de tâches parallèle, task1 et task2 s'exécutent en parallèle sur resource1 et resource2.
- Groupe de ressources parallèle : Toutes les tâches faisant partie d'un groupe de ressources parallèle sont exécutées en parallèle sur l'ensemble des ressources (ressources de calcul et de base de données) qui font partie d'un parc. Au sein d'une ressource, les tâches qui font partie d'un groupe de ressources en parallèle s'exécutent séquentiellement.
Par exemple, si un parc comporte deux ressources et deux tâches (task1 et task2) qui font partie du groupe de ressources parallèle, task1 et task2 sont exécutées séquentiellement sur resource1 et resource2, et l'exécution sur resource1 et resource2 se produit en parallèle.
- Groupe de ressources continu : Toutes les tâches faisant partie d'un groupe de ressources continu s'exécutent séquentiellement entre les ressources (ressources de calcul et de base de données) qui font partie d'un parc. Au sein d'une ressource, les tâches qui font partie d'un groupe de ressources non simultanées s'exécutent séquentiellement.
Par exemple, si un parc comporte deux ressources et deux tâches (task1 et task2) qui font partie du groupe de ressources glissantes, task1 et task2 sont exécutés séquentiellement sur resource1. Une fois les tâches resource1 terminées, task1 et task2 sont exécutés séquentiellement sur resource2.
Onglet Propriétés
L'onglet Propriétés fournit des paramètres pour contrôler les énoncés conditionnels et configurer le traitement des erreurs des composants que vous ajoutez au canevas. Après avoir ajouté un composant à la zone de travail du canevas sous Tâches ou Reporter les tâches, configurez-le pour répondre à votre cas d'utilisation. Sélectionnez l'icône des propriétés (
) du composant pour configurer ses propriétés et ses options. Vous pouvez également voir le code YAML ou JSON en sélectionnant Vue de code. Les propriétés sont disponibles pour un dossier d'exploitation, des groupes et des tâches.
Propriétés du dossier d'exécution
Voici les deux propriétés d'un dossier d'exploitation :
- En cas d'échec de tâches : L'option que vous sélectionnez pour cette propriété est la valeur par défaut pour tous les groupes et toutes les tâches d'un dossier d'exécution.
- Exécuter le : L'option que vous sélectionnez décrit où et comment les tâches sont exécutées. Il peut s'agir d'instances programmées, d'environnements auto-hébergés ou d'instances sélectionnées en fonction des résultats des tâches précédentes. Voici les sous-propriétés de l'option Exécuter le :
- Instances spécifiées par programme : Cette propriété est utilisée pour l'exécution conditionnelle d'un dossier d'exploitation sur une cible lorsque la condition est évaluée à Vrai. Il convient le mieux pour gérer les flux de travail de la pile de produits au sein d'un dossier d'exploitation.
- Instance auto-hébergée : Cette propriété vous aide à localiser et à sélectionner une instance auto-hébergée pour les tâches post-provisionnement
- Instance spécifiée par la tâche précédente : Cette propriété indique que l'exécution d'une tâche dépend de l'achèvement d'une tâche précédente.
Propriétés de groupe
Voici les cinq propriétés d'un groupe :
- En cas d'échec : L'option sélectionnée pour cette propriété détermine le jeu d'actions suivant en cas d'échec de l'une des tâches d'un groupe. L'exécution du dossier d'exploitation sur la cible se poursuit si vous sélectionnez Continuer, si l'exécution du dossier d'exploitation du produit sur la cible s'arrête et si l'exécution du dossier d'exploitation de la pile de produits sur le groupe d'actions s'arrête si vous sélectionnez Abandonner et si l'exécution du dossier d'exploitation passe à l'étape de repositionnement si vous sélectionnez Repositionner. Selon l'étendue du repositionnement, l'action de repositionnement peut être au niveau de la cible ou du groupe d'actions.
- Précondition : Spécifie la condition à l'aide des variables d'entrée de la tâche courante et des variables de sortie de toutes les tâches précédentes. Une tâche n'est exécutée sur la cible que si la condition est vérifiée.
- Exécuter le : Spécifie la condition à l'aide du nom du produit cible (pour le dossier d'exécution de la pile de produits), des propriétés du produit et du nom du composant, ainsi que des propriétés du composant d'une cible. Une tâche n'est exécutée sur la cible que si la condition est vraie.
Par exemple, dans le dossier d'exécution de la pile de produits Oracle WebLogic Server et Java Patching, pour exécuter une tâche uniquement sur la cible Oracle WebLogic Server si sa valeur de propriété java_version est
1.8.0_391et lorsque le composant ADMIN_SERVER est disponible, entrez la condition suivante.target.product.name == "Oracle Weblogic Server" AND target.product.properties.java_home == "1.8.0_391" AND target.product.components.ADMIN_SERVER.properties.Server == "AdminServer" - Mettre en pause l'exécution : Option qui arrête l'exécution du livre d'exécution jusqu'à ce que vous interveniez ou que la durée définie soit expirée. La pause se produit avant l'exécution d'une tâche.
- Avis : Vous avise à l'aide du service d'avis OCI du statut de la tâche.
Propriétés de tâche
Les tâches incluent une propriété supplémentaire par rapport à un groupe. La description de la propriété est la suivante :
Mappage de VARIABLE de sortie : Pour le type de tâche Exécuter un script, la sortie des journaux de script est analysée pour évaluer la valeur de la VARIABLE d'entrée avec une correspondance de modèle $$VARIABLE=VALUE$.
- Cochez la case Output Variable et ajoutez une variable de sortie. L'exécution du script Fleet Application Management garantit que la variable de sortie est alimentée.
- Dans la tâche suivante, cochez la case Variable d'entrée et ajoutez une variable d'entrée.
- Mappez le nom de la variable d'entrée au nom de la variable de sortie des tâches précédentes à l'aide du mappage de variable de sortie.
Le script de gestion des applications de parc analyse maintenant les journaux de sortie pour identifier un modèle tel que $$VARIABLE=VALUE$$.
Onglet Bibliothèque
L'onglet Bibliothèque des tâches fournit une liste des tâches réutilisables prêtes à l'emploi qui existent dans Fleet Application Management ou que vous avez créées. Vous pouvez utiliser l'icône de poignée de glisser-déposer ( 
) dans le coin droit d'une tâche pour la faire glisser dans la zone de travail du dossier d'exploitation sur le canevas. La bibliothèque affiche uniquement les tâches pertinentes pour un dossier d'exploitation en fonction du produit ou de la pile de produits et du type de système d'exploitation.
Repositionner les tâches
Pour repositionner une tâche définie en cas d'échec, vous pouvez ajouter un groupe, puis ajouter les tâches à repositionner dans le paramètre fictif Repositionner les tâches de la zone de travail du canevas. Pour effectuer un repositionnement, sélectionnez la propriété de tâche En cas d'échec Repositionner sous Tâches pour la tâche spécifique.
Vous pouvez étendre le repositionnement à des niveaux cible ou de groupe d'actions. Cette portée signifie que Fleet Application Management exécute les tâches d'annulation sur une cible spécifique ou sur tous les groupes de cibles. Les tâches d'annulation s'exécutent sur la cible qui échoue si vous définissez une portée pour une cible, tandis que les tâches d'annulation s'exécutent sur tous les groupes de cibles si vous définissez une portée pour un groupe d'actions.
Canevas
Après avoir déterminé une action à ajouter au concepteur visuel, faites glisser un composant dans la zone de travail du canevas. Pour modifier l'ordre des composants, utilisez l'icône de poignée de glisser-déposer ( ) dans le coin droit d'un composant pour le faire glisser vers un autre emplacement dans la zone de travail du dossier d'exploitation. Cette nouvelle action est ajoutée à la zone de travail et son code est généré automatiquement.
raccourcis clavier pour la navigation
| raccourci clavier | Action |
|---|---|
| Tabulation | Naviguez jusqu'à l'élément de carnet d'exécution suivant. |
| Shift+Tab | Naviguez jusqu'à l'élément de carnet d'exécution précédent. |
| Touches de flèche | Déplacez un composant après qu'il se trouve sur le canevas. Exemple :
|
| Barre d'espacement ou Entrée/Retour | Sélectionnez un composant dans l'onglet Composants ou Propriétés, ou un élément de carnet d'exécution. |
| Échap | Annuler le déplacement d'un composant sur le canevas ou toute action avant qu'il ne soit déclenché. |
| Barre d'espacement ou entrée | Déclenchez une activité appropriée lorsque l'accent est mis sur l'un des composants, des propriétés ou des éléments du carnet d'exécution. Exemple :
|