Aller au contenu principal

Paquet d'Installation Unix

Configuration actuelle de la tâche Unix Update Package dans le Workflow Designer
  • Type de tâche: ssh_updatepackage

Description​

La tâche Paquet d'Installation Unix permet de mettre à jour un seul paquet logiciel sur un système, en exécutant l'opération sur la machine locale (mode Par défaut) ou sur un hôte distant via SSH.

La tâche gère de manière transparente le gestionnaire de paquets du système d'exploitation, simplifiant l'exécution des opérations de mise à jour au sein du workflow.

Configuration​

La configuration définit le mode d'exécution (local ou distant) et les options relatives au gestionnaire de paquets utilisé pour la mise à jour. Les champs de configuration peuvent être compilés manuellement ou valorisés dynamiquement via paramètres et variables du flux de travail.

Connexion au Serveur​

  • Mode de connexion: Définit la source des identifiants utilisés pour la connexion. Il peut prendre trois modes d'opération :
  • Par défaut: la commande est exécutée depuis la machine locale.
  • Manuel: Permet d'entrer manuellement les paramètres de connexion SSH.
  • Environnement: 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​

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

  • Utilisateur: Nom de l'utilisateur avec lequel la commande sera exécutée.
  • Mot de passe: Mot de passe de l'utilisateur utilisé pour l'exécution de la commande.

Détails de la Mise à Jour​

  • Gestionnaire de paquets: Menu qui permet de sélectionner le gestionnaire de paquets approprié pour le système d'exploitation du serveur de destination. Le choix du gestionnaire correct est essentiel pour le bon déroulement de l'opération.
  • yum: À utiliser pour les distributions basées sur Red Hat (comme CentOS, Fedora, RHEL).
  • apt: À utiliser pour les distributions basées sur Debian (comme Ubuntu, Debian).
  • Paquet: Le nom exact du paquet logiciel que vous souhaitez mettre à jour (par exemple, openssl, httpd, nginx).

Paramètres de Sortie​

À la fin de l'exécution, la tâche expose les paramètres de sortie suivants :

  • result: Contient un message textuel qui décrit 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, les configurations et les détails sur l'exécution.
  • exitStatus: Retourne le code de sortie de la commande de mise à jour. Une valeur de 0 indique que la mise à jour s'est terminée avec succès.

Exemple de paramètre resultJson​

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Notes Importantes​

  • Permissions: La tâche établit une connexion SSH avec le serveur distant et exécute la commande de mise à jour du package configuré. Si vous utilisez l'authentification 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.
  • Connectivité Internet: Le serveur distant doit avoir accès à Internet pour pouvoir contacter les référentiels logiciels à partir desquels l'update est téléchargée.