Aller au contenu principal

Contrôle des Services Unix

Configuration actuelle de la tâche Unix Service Control dans le Workflow Designer
  • Type de tâche: ssh_checkservice

Description​

La tâche Unix Service Control permet de gérer l'état d'un service ou démon sur une machine locale (mode Default) ou sur un serveur distant via SSH.

Elle permet d'exécuter des opérations standard sur les services, telles que le démarrage, l'arrêt et la vérification de l'état, sans avoir besoin de spécifier manuellement les commandes du système d'exploitation.

Configuration​

La configuration définit le mode d'exécution (local ou distant) et le service à gérer. Les champs de configuration de la tâche peuvent être valorisés manuellement ou via paramètres et variables du flux de travail.

Connection au Serveur (Connexion au Serveur)​

  • Mode de connexion: définit l'origine des identifiants et le type d'exécution. Il peut prendre trois modes opérationnels :
  • Default: Les commandes sont exécutées sur la machine locale, sans connexion SSH.
  • Manuelle: Permet d'entrer manuellement les paramètres de connexion SSH.
  • Environment: Utilise un environnement de connexion préconfiguré. Dans ce mode, un menu est affiché listant les connexions disponibles en fonction du rôle associé au Workflow.
  • Adresse IP: Adresse IP du serveur distant.
  • Nom d'hôte: Nom d'hôte du serveur distant.
  • Utilisateur: Nom d'utilisateur utilisé pour établir la connexion SSH.
  • Mot de passe: Mot de passe associé à l'utilisateur de connexion.
  • Port: Port utilisé pour la connexion SSH (la valeur par défaut est 22).

Exécuter la commande en tant qu'autre utilisateur (Exécuter la commande en tant qu'autre utilisateur)​

En activant cette case à cocher, il est possible d'exécuter la commande de gestion du service avec un utilisateur différent de celui utilisé pour la connexion SSH.

  • Utilisateur: Le nom de l'utilisateur avec lequel la commande sera exécutée (par exemple, root).
  • Mot de passe: Le mot de passe de l'utilisateur spécifié ci-dessus.

Détails de l'Opération (Détails de l'Opération)​

  • Operation: Un menu pour sélectionner l'action à effectuer sur le service :
  • Status: Vérifie l'état courant du service (par exemple, actif, inactif, en cours de chargement).
  • Start: Démarre le service.
  • Stop: Arrête le service.
  • Nom du service: Le nom du service sur lequel agir, tel qu'il est connu du système d'exploitation (par exemple, httpd, apache2, postgresql, sshd).

Paramètres de Sortie (Paramètres de Sortie)​

À la complétion de l'exécution, la tâche rend disponibles les Paramètres de Sortie suivants, utilisables comme entrées dans les tâches suivantes du Workflow.

  • result: Contient un message textuel décrivant le résultat de l'opération ou un message d'erreur (par exemple, “Missing server address”).
  • resultJson: Représente le résultat de l'exécution de la tâche au format JSON, incluant des informations générales, des configurations et des détails sur l'exécution.
  • exitStatus: Retourne le code de sortie de la commande exécutée. Une valeur de 0 indique typiquement que l'opération a été exécutée avec succès. Des codes différents peuvent indiquer divers états (par exemple, "service déjà arrêté" ou "service non trouvé").

Notes​

La tâche établit une connexion SSH avec le serveur distant et exécute la commande stop/start/status du service spécifié sur le serveur configuré. Si l'authentification est effectuée via des clés SSH, il est nécessaire que la clé publique soit enregistrée sur le serveur distant. Si l'option “Exécuter la commande en tant qu'autre utilisateur” est activée, la commande est exécutée avec un utilisateur différent de celui de la connexion SSH principale.