Commande Orkyvo Remote

Propre à OrkyvoToutes les offres1 entrée · 1 sortie

Exécute une commande par l'intermédiaire de l'agent Orkyvo Remote installé sur le serveur.

Éléments reçusCommande Orkyvo RemoteÉléments produits

Fonctionnement

La tâche est remise à l'agent du serveur (connexion sortante mTLS) lors de sa prochaine interrogation. L'agent n'exécute que les tâches qui lui sont destinées, valides et non expirées ; une tâche reçue deux fois renvoie son état connu sans relancer la commande.

Paramètres

Paramètre	Type	Détail
Serveur ou groupeobligatoire	serveur ou groupe	Serveurs de l'environnement de l'exécution uniquement. Un groupe est résolu au démarrage de l'étape.
Mode d'exécution	choix	« Programme et arguments » : aucune interprétation par un shell (pas de redirection, de variable ni de joker). Valeurs : Script interprété par le shell, Programme et arguments (sans shell).
Shellselon les autres paramètres	choix	Valeurs : bash, sh (POSIX).
Scriptobligatoire · selon les autres paramètres	script	Texte fixe, jamais interprété comme expression Orkyvo. Arguments : $1, $2… ; variables : $NOM.
Arguments du script ($1, $2…)selon les autres paramètres	liste	—
Programmeobligatoire · selon les autres paramètres	texte	—
Argumentsselon les autres paramètres	liste	Un argument par ligne, transmis tel quel.
Répertoire de travail	texte	Facultatif. Transmis littéralement (échappé).
Variables transmises	clé-valeur	Seules ces valeurs sont envoyées au serveur, échappées : utilisez {{ $env.NOM }} ou {{ $json.champ }} sans risque d'interprétation par le shell.
Délai maximal (secondes)	nombre	3600 s au plus. Au-delà, le processus distant est arrêté et l'arrêt vérifié.
Codes de sortie réussis	texte	Ex. 0 ; 0,1 ; 0-2.
Taille maximale des sorties (Ko)	nombre	Par flux (stdout, stderr), 1024 Ko au plus ; au-delà la sortie est tronquée et signalée.
Exécuter avec sudo (non interactif)	oui / non	Refusé si le serveur n'autorise pas les opérations privilégiées.
En cas d'échec sur un serveur	choix	Valeurs : Échouer le bloc (après tous les serveurs), Continuer : le statut figure dans le résultat.
Serveurs traités en parallèle (groupe)	nombre	50 au plus.

Données reçues et renvoyées

EntréeListe d'éléments ; le premier élément alimente les expressions.
SortieUn élément par serveur : { serverId, serverName, environmentId, status, exitCode, stdout, stderr, startedAt, finishedAt, durationMs, timedOut, cancelled, cancelConfirmed, outputTruncated, error, taskId }. status : SUCCEEDED, FAILED, TIMED_OUT, CANCELLED, INDETERMINATE (connexion perdue : la commande a pu s'exécuter), REFUSED, EXPIRED.

Erreurs

Agent absent, suspendu ou révoqué, capacité non autorisée, tâche expirée avant d'être prise en charge, délai dépassé.

À savoir. Une commande dont le résultat est inconnu (connexion perdue, worker interrompu) n'est jamais relancée automatiquement : elle est marquée « indéterminée ».

À savoir. Annulation : interruption du processus distant puis vérification ; cancelConfirmed indique si l'arrêt a été constaté.

À savoir. Mode « Programme et arguments » : l'agent lance le programme sans shell.

Exemple

Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.

Paramètres de l'exemple (JSON)Ouvrir l'éditeur

{
  "mode": "argv",
  "program": "/usr/bin/uptime",
  "args": [],
  "timeoutSeconds": "20"
}