Actions disponibles dans la création de packages

Lorsque vous créez un package (doc : Créer un package), Medulla affiche un éditeur en deux colonnes : à gauche Available Actions (les actions disponibles), à droite Deployment Workflow (votre séquence de déploiement).

Pour construire votre package, vous glissez une action de la colonne de gauche vers la colonne de droite. Chaque action devient une étape de la séquence, qui s'exécutera de haut en bas sur l'ordinateur cible. Vous pouvez réordonner les étapes par glisser-déposer, et déplier chaque étape pour régler ses options.

Cette page décrit, pour chaque action, à quoi elle sert et les réglages importants à connaître.

Quelques notions communes

Libellé d'étape (Step label) : chaque étape porte un libellé. Il sert de repère et, surtout, de point de destination pour les sauts « aller à l'étape ». Un libellé est proposé automatiquement, mais vous pouvez le renommer pour vous y retrouver (ex. install_msi).
Aller à l'étape (goto) : plusieurs actions permettent de rediriger la séquence vers un libellé précis. Deux destinations spéciales existent toujours : END_SUCCESS (terminer en succès) et END_ERROR (terminer en erreur).
Options : le bouton Options de chaque étape affiche les réglages avancés (timeout, package alternatif, etc.), masqués par défaut.
Package alternatif (Alternate package) : sur les actions qui manipulent des fichiers ou des commandes, vous pouvez cocher cette option pour exécuter l'action à partir d'un autre package que celui en cours d'édition.

Actions de commande et de script

Lancer une commande (Run command)

Exécute une ligne de commande sur l'ordinateur cible. C'est l'action la plus courante pour lancer un installeur ou une commande système (ex. msiexec /i app.msi /qn).

Réglages clés :

Command : la commande à exécuter.
Set timeout : temps maximum d'exécution, en secondes (800 par défaut).
Return result : choisit ce que Medulla récupère de la sortie (les premières ou dernières lignes, ou le résultat complet).
On return code, goto : redirige la séquence selon le code de retour de la commande. Vous saisissez une condition et le libellé de destination. Par défaut, une règle « !=0 → END_ERROR » est présente : tout code différent de 0 est considéré comme une erreur. Conditions possibles : une valeur exacte (0, ==3), une différence (!=0), une comparaison (<5, >=10) ou un intervalle (IN1,5, OUT-5,5).

Exécuter un script (Execute script)

Écrit un script complet sur l'ordinateur cible, puis l'exécute avec l'interpréteur choisi. À privilégier quand une simple ligne de commande ne suffit pas.

Réglages clés :

Script language : l'interpréteur — Natif (batch Windows / bash Linux et macOS), Python, VBScript (Windows), PowerShell (Windows), Korn Shell ou C Shell (Linux & macOS).
Script : le contenu du script.
Force suffix / Force hash-bang : réglages avancés pour imposer l'extension du fichier ou le shebang (#!) au lieu de ceux déduits du langage.
Set timeout et Return result : comme pour « Lancer une commande ».
On return code, goto : branchement conditionnel selon le code de retour (mêmes conditions que ci-dessus).

Actions sur le système et les fichiers

Définir des variables d'environnement (Set Environment variables)

Positionne une ou plusieurs variables d'environnement pour la suite de la séquence.

Réglage clé : saisissez vos variables au format clé :: valeur, une par ligne, séparées par des virgules (ex. LANG :: fr_FR, LOGLEVEL :: INFO).

Redémarrer (Restart)

Redémarre la machine ou l'agent Medulla.

Réglage clé : Target Restart — Restart Machine (redémarre l'ordinateur) ou Restart Agent Machine (redémarre uniquement l'agent Medulla sur la machine).

Paramétrer un fichier de configuration (Set config file parameter)

Ajoute ou supprime un paramètre dans un fichier de configuration de type INI (fichier / section / clé / valeur).

Réglage clé : le champ Config action description décrit l'opération :

Ajouter : add@__@fichier.ini@__@section@__@clé@__@valeur (ex. add@__@agentconf.ini@__@global@__@log_level@__@INFO).
Supprimer : del@__@fichier.ini@__@section@__@clé.

Décompresser un fichier (Unzip File)

Décompresse une archive ZIP sur l'ordinateur cible.

Réglages clés :

Zip file : le fichier ZIP à décompresser (nom dans le dossier du package, ou chemin complet).
Unzip to specified folder : dossier de destination (sinon, extraction dans le dossier courant).
Go to step / On success / On error : étapes de destination selon le résultat.

Télécharger un fichier (Download File)

Télécharge un fichier depuis une URL vers l'ordinateur cible.

Réglages clés :

Download File : l'URL du fichier à télécharger.
Nom de destination : vous pouvez imposer le nom du fichier téléchargé ; sinon, le nom est déduit de l'URL.

Supprimer les fichiers téléversés (Remove uploaded files)

Nettoie les fichiers du package déposés sur l'ordinateur. On la place généralement en fin de séquence pour ne rien laisser traîner. Aucun réglage : seul le libellé d'étape est modifiable.

Marqueurs de section

Ces trois actions ne font « rien » par elles-mêmes : elles servent à classer les étapes qui les suivent dans la bonne phase du cycle de vie du logiciel. Elles n'ont aucun réglage.

Section Installation (Install Section) : les étapes suivantes relèvent de l'installation.
Section Mise à jour (Update Section) : les étapes suivantes relèvent de la mise à jour.
Section Désinstallation (Uninstall Section) : les étapes suivantes relèvent de la désinstallation.

Interactions avec l'utilisateur et le Kiosk

Notification kiosque (Kiosk Progression)

Envoie un message — et éventuellement une progression — au Kiosk de l'utilisateur.

Réglages clés : le message à afficher, et en option un pourcentage de progression (1 à 100) pour renseigner l'avancement du déploiement.

Notification utilisateur (User Notification)

Affiche une fenêtre d'information (bouton « OK ») à l'utilisateur connecté sur la machine.

Réglages clés :

Message box title et Message : le titre et le texte affichés (avec une taille de police réglable pour chacun).
True button text : le libellé du bouton (par défaut « OK »).
Set timeout : durée maximale d'attente d'une réponse.

Question à l'utilisateur (User Question)

Pose une question OUI / NON à l'utilisateur et oriente la séquence selon sa réponse.

Réglages clés :

Message box title et Question : le titre et la question posée.
True / False button text : le libellé des deux boutons (par défaut « Yes » et « No »).
Aller à l'étape selon le cas : réponse Oui, réponse Non, aucun utilisateur connecté, ou délai dépassé.
Set timeout : durée maximale d'attente d'une réponse.

Report d'action par l'utilisateur (User Postpone Options)

Permet à l'utilisateur de reporter une action (par exemple un redémarrage), un nombre de fois limité et à intervalle régulier. Pratique pour ne pas interrompre son travail tout en garantissant l'exécution à terme.

Réglages clés :

Titre, Question et libellés des boutons : comme pour la question Oui/Non.
Aller à l'étape selon le cas : réponse Oui, nombre maximum de reports atteint, aucun utilisateur, ou délai dépassé.
Maximum allowed postponements : nombre de reports autorisés (1 par défaut).
Interval : délai entre deux demandes à l'utilisateur (900 secondes par défaut).

Contrôle du déroulement

Attendre puis aller à l'étape (Wait and go to step)

Marque une pause d'un nombre de secondes donné, puis redirige la séquence vers l'étape de votre choix (par défaut END_SUCCESS). Utile pour laisser le temps à un service de démarrer avant l'étape suivante.

Ajouter une info au journal de déploiement (Add info in deployment log)

Écrit un message libre dans le journal de déploiement, pour tracer ou annoter l'exécution. Vous pouvez insérer des variables dynamiques entourées de @@@, remplacées à l'exécution — par exemple @@@PACKAGE_NAME@@@, @@@HOSTNAME@@@, @@@OS_FAMILY@@@, @@@IP_MACHINE@@@ ou @@@UUID_PACKAGE@@@.

Les étapes de fin (automatiques)

Tout nouveau package contient d'office deux étapes de sortie, que vous ne glissez pas depuis la palette. Elles reçoivent les sauts END_SUCCESS et END_ERROR.

Fin en succès (End Success) : point de sortie « réussite ». Deux options utiles : Delete package (supprimer ou non les fichiers du package sur la machine à la fin) et Inventory (déclencher un inventaire — forcé, jamais, ou seulement en cas de changement).
Fin en erreur (End Error) : point de sortie « échec ». Aucun réglage.

Une fois votre séquence terminée et le package enregistré, vous pouvez le déployer : voir Déploiement de logiciel.