Vue d’ensemble de la console Orchestration

La console Orchestrator est une application monopage qui vous permet d’analyser et d’exécuter votre déploiement Orchestrator. Cet article détaille les fonctionnalités prises en charge dans la console Orchestrator 2022.

Volet de navigation

Le volet de navigation à gauche affiche l’arborescence Runbook et Dossiers, comme celle affichée sur le Runbook Designer. Contrairement à la console dans les versions antérieures, vous ne pouvez pas sélectionner les dossiers, mais vous sélectionnez les Runbooks et affichez leurs travaux et les exécutez.

Le volet de navigation est toujours visible sur tous les écrans pour permettre une navigation rapide vers d’autres runbooks et dossiers tout en restant sur le même écran.

À droite du volet de navigation, vous pouvez voir l’écran choisi. L’écran Tableau de bord s’affiche par défaut.

Notes

Actuellement, l’actualisation automatique n’est prise en charge pour aucun des écrans. Rechargez la page manuellement.

Tableau de bord

Le tableau de bord affiche Travaux actifs en haut suivi d’un tableau de tous les travaux terminés (historique). Le volet Travaux terminés (historique) est réduit par défaut, ce qui permet de se concentrer sur les travaux actifs.

Chaque ligne des deux panneaux correspond à un travail unique. Un travail peut avoir une ou plusieurs instances de Runbook. Chaque ligne affiche :

• ID du travail : Lien vers le Runbook
• Horodatage : le nombre d’instances réussies et ayant échoué est affiché dans l’une des colonnes pour toutes les lignes.
• Boutons d’action : Arrêter le travail ou Afficher les détails du travail

Vous pouvez sélectionner et développer chacune des lignes du travail et afficher les instances du travail.

Runbooks

Lorsque vous sélectionnez un runbook dans l’arborescence de navigation ou sélectionnez un lien de runbook, l’application accède à l’écran runbook. Le panneau supérieur répertorie les métadonnées de runbook (modification status, horodatages, etc.). Le bouton Exécuter disponible à l’écran vous permet de mettre en file d’attente le runbook pour l’exécution sur le sous-ensemble souhaité de serveurs runbook. Le bouton Exécuter est désactivé pour les runbooks qui ne sont pas à l’état Publié .

Sous ce panneau se trouve une vue à onglets :

• Affichage : pour l’image graphique du Runbook.
• Travaux : pour obtenir la liste des travaux actifs et terminés du runbook (voir ci-dessous).
• Instances : pour obtenir la liste des instances actives et terminées du runbook sur tous ses travaux (voir ci-dessous).

Vous pouvez sélectionner les lignes dans la vue Travaux comme celles de l’écran Tableau de bord. Les travaux en cours d’exécution peuvent être arrêtés à l’aide des boutons à droite de la ligne en cours d’exécution.

Tant que cet écran est actif, vous pouvez choisir un autre runbook dans l’arborescence de navigation. Cela ne modifie pas l’onglet sélectionné. Vous pouvez rapidement consulter travaux de différents runbooks en sélectionnant l’onglet Travaux et en accédant aux runbooks souhaités dans l’arborescence de navigation.

travaux

Lorsque vous sélectionnez un travail (à l’aide du bouton (i), l’application accède à cet écran. Le panneau supérieur affiche les métadonnées du travail (horodatages, paramètres).

Un tableau montrant les instances de ce travail suit le panneau.

La plupart des travaux ont une seule instance. Si le runbook a une activité de déclencheur Monitor/Event, chaque déclencheur démarre un travail unique instance. La capture d’écran ci-dessous montre un travail avec plusieurs instances.

Notes

Un travail peut avoir au maximum une instance en cours d’exécution à tout moment. Mais étant donné qu’un Runbook peut avoir plusieurs travaux en cours d’exécution simultanée, un Runbook peut avoir plusieurs instances en cours d’exécution.

La status du travail s’affiche visuellement avec les icônes :

• Trois points : Le travail est mis en file d’attente
• Sablier : le travail est en cours d’exécution
• Cercle avec barre oblique : le travail a été annulé
• Coche : Travail terminé avec succès
• Exclamation rouge : travail terminé mais a échoué
• Avertissement : travail terminé avec avertissement(s)

Instances

Lorsque vous sélectionnez une instance (à l’aide du bouton (i), l’application accède à cet écran. Le panneau supérieur affiche les métadonnées de l’instance (ID du travail, horodatages, paramètres, serveur qui exécute cette instance).

Le panneau supérieur comporte également trois boutons de navigation :

• Précédent : Affichez l’instance qui s’est exécutée avant celle-ci.
• Suivant : Afficher l’instance qui s’est exécutée après celle-ci.
• Dernier : Afficher les instance les plus récents

Notes

L’ID de travail est le même, et étant donné que le deuxième instance est toujours en cours d’exécution, le travail est toujours en cours d’exécution.

Sous le panneau, vous voyez le diagramme de runbook. Vous pouvez sélectionner chaque activité de runbook pour afficher les sorties d’activité. Une icône dédiée à chaque activité indique la status de cette activité. Lorsque vous sélectionnez une activité, une superposition s’affiche à droite qui répertorie les sorties de l’activité.

Étant donné qu’une activité peut être exécutée plusieurs fois au sein d’un instance (en raison d’une boucle), chaque exécution de l’activité a un numéro de séquence unique. La superposition vous permet de choisir le numéro de séquence à l’aide de la liste déroulante située en haut.

Notes

Pour garantir un temps de chargement rapide, seules les 10 premières sorties d’activité sont chargées pour l’activité. Le bouton Charger plus indique le nombre de fois où cette activité a été exécutée, et vous pouvez la sélectionner pour charger davantage de sorties.

Les status d’instance et d’activité suivent le même format que l’état du travail.

Exécuter des runbooks

Accédez à l’écran runbook du Runbook souhaité, puis sélectionnez Exécuter. Un formulaire de superposition s’ouvre à droite à l’endroit où vous êtes invité à :

• Définir des valeurs sur tous les paramètres d’entrée (obligatoire)
• Choisissez l’ensemble de serveurs Runbook sur lesquels ce travail peut être planifié.

Un seul de ces serveurs exécute réellement ce travail. Pour exécuter un Runbook sur de nombreux serveurs, vous devez exécuter ces nombreux travaux et définir explicitement les serveurs un par un.

Notes

Entrez les paramètres dans le formulaire, sinon le formulaire ne sera pas pris en compte.

Lorsque le formulaire est envoyé, une fenêtre contextuelle qui disparaît s’affiche en haut à droite pour indiquer si le travail a été correctement mis en file d’attente ou non.

Arrêter l’exécution des travaux

Le bouton Arrêter s’affiche dans le tableau de bord et l’écran Travail. Vous trouverez une fenêtre contextuelle qui disparaît en haut à droite de la page pour vérifier si un travail est toujours en cours d’exécution ou s’il s’est arrêté.

FAQ

La console ne se charge pas ; erreur « Euh oh ! Problème de connexion à WebApi [status 0] » s’affiche

1. Vérifiez la console du développeur du navigateur (onglet Console), recherchez les erreurs CORS (bloquées par la stratégie CORS).

   

2. S’il n’y a pas d’erreurs CORS, case activée les journaux d’observateur d'événements (application) sur l’ordinateur de l’API web.

Pour corriger les erreurs CORS, vous devez vous assurer que le fichier de web.config l’API doit avoir une configuration CORS appropriée. L’erreur du navigateur indique la valeur d’origine attendue dans l’API web.web.config Bien que les noms de domaine ne respectent pas la casse, IIS CORS utilise un test de comparaison respectant la casse. Vérifiez que la origin valeur est en minuscules dans la configuration CORS IIS.

Conseil

Configuration TYPIQUE d’IIS CORS de l’API web :

<add allowCredentials="true" maxAge="7200" origin="http://{domain}[:{port}]">
  <allowMethods>
    <add method="GET"/>
    <add method="PUT"/>
    <add method="POST"/>
    <add method="PATCH"/>
    <add method="DELETE"/>
  </allowMethods>
  <allowHeaders allowAllRequestedHeaders="true"/>
</add>

Pour plus d’informations sur la configuration de CORS dans web.config, consultez cet article sur la configuration du module CORS.

Comment faire mettre à jour l’URL de l’API web ?

La console charge {install_dir}\assets\configuration.json pour rechercher l’URL de l’API. Vous pouvez la modifier à l’aide d’un éditeur de texte ordinaire. Vérifiez qu’il n’y a pas de fin / à la fin de l’URL.

Étapes suivantes

Pour en savoir plus sur le déploiement de runbooks, consultez Déployer des runbooks.