Einführung
Verwenden Sie Shell auf einem anderen Gerät ausführen um ein inline Shell-Skript auf einem ausgewählten Runner-Gerät auszuführen, anstatt auf dem Gerät, das die Automatisierung durchläuft. Dies ist nützlich, wenn ein Befehl Tools, Netzwerkzugang oder Ressourcen benötigt, die auf einem dedizierten Gerät verfügbar sind.
Die Automatisierung behält weiterhin den Kontext des Geräts, das den Workflow betreten hat. Systemvariablen, benutzerdefinierte Felder und Automatisierungsvariablen werden von diesem Workflow-Gerät aufgelöst, bevor das Shell-Skript auf dem Runner ausgeführt wird.
Aktion hinzufügen
Öffnen Sie die Automatisierung und wählen Sie Bearbeiten.
Wählen Sie + dort, wo Sie die Aktion hinzufügen möchten.
In der System Kategorie, wählen Sie Shell auf einem anderen Gerät ausführen.
In Runner-Gerät, suchen und wählen Sie das Gerät aus, das das Shell-Skript ausführen soll.
Wählen Sie die Sprache, das Zeitlimit und den Ausführen als Kontext.
Geben Sie das Skript im Editor ein.
Konfigurieren Sie Bedingungen und zusätzliche Optionen, dann wählen Sie Speichern.
Der Runner ist Teil der Aktionskonfiguration. Jedes Workflow-Gerät, das diese Aktion erreicht, sendet sein gerendertes Shell-Skript an den ausgewählten Runner.
Workflow-Gerät und Runner-Gerät – Kontext
Die Remote-Ausführung trennt das zu verwaltende Gerät von dem Gerät, das die Arbeit ausführt.
Kontext | Verwendetes Gerät |
Auslöser- und Aktionsbedingungen | Workflow-Gerät |
Systemvariablen wie | Workflow-Gerät |
Werte benutzerdefinierter Felder | Workflow-Gerät |
Automatisierungsvariablen | Aktueller Automatisierungsdurchlauf für das Workflow-Gerät |
Shell-Ausführung, Betriebssystem, installierte Tools und Netzwerkzugang | Runner-Gerät |
Ausführen als Benutzerkontext | Runner-Gerät |
ℹ️ HINWEIS: Ein Verweis wie {{ level_device_hostname }} gibt den Hostnamen des Workflow-Geräts zurück, nicht den Hostnamen des Runners. Verwenden Sie den Runner nur als den Ort, an dem das Shell-Skript ausgeführt wird.
Beispiel
Eine Automatisierung läuft für eine Arbeitsstation, die ein internes Verwaltungssystem nicht direkt erreichen kann. Ein Server mit den erforderlichen Tools und dem erforderlichen Netzwerkzugang wird als Runner ausgewählt. Der Befehl wird auf dem Server ausgeführt, während eine Variable wie {{ level_device_hostname }} identifiziert weiterhin die Arbeitsstation, die die Automatisierung durchläuft.
Shell-Skript konfigurieren
Wählen Sie die Sprache, das Zeitlimit und den Ausführen als Kontext für das Runner-Gerät, und geben Sie dann Ihr Skript im Editor ein. Fügen Sie Systemvariablen, Automatisierungsvariablen und benutzerdefinierte Felder über die Variablenauswahl ein. Level rendert diese Werte vom Workflow-Gerät, bevor das Skript an den Runner gesendet wird.
Siehe Shell-Aktion für Details zu Sprache, Editor, Ausgabe, Exit-Code, Bedingung und zusätzlichen Optionen, die hier ebenfalls gelten.
Ausgabe erfassen
Verwenden Sie Aktionsausgabe einer Variable zuweisen um die Standardausgabe des Runners in einer Automatisierungsvariablen zu speichern. Der Wert steht späteren Aktionen im Automatisierungsdurchlauf des Workflow-Geräts zur Verfügung.
Verfügbarkeit des Runners und Fehlerbehandlung
Der Runner muss verfügbar sein, um die Aktion zu empfangen und auszuführen. Antwortet er nicht, wiederholt Level den Versuch, bevor die Aktion das Zeitlimit überschreitet und als fehlgeschlagen markiert wird. Die Bei Aktionsfehler, Wiederholungs- und Zeitlimiteinstellungen legen fest, was die Automatisierung als Nächstes tut.
Der Exit-Code des Shell-Skripts wird anhand seiner Ausführung auf dem Runner bewertet:
Exit-Code | Ergebnis |
0 | Aktion als erfolgreich markiert |
Ungleich null | Aktion als fehlgeschlagen markiert |
Verwendung des Runner-Geräts
Level verfolgt, wenn ein Gerät als Automatisierungs-Runner verwendet wird. Ein Runner, auf den eine aktive Automatisierung verweist, kann nicht gelöscht werden, bis Sie diese Automatisierungsverwendung entfernt oder ersetzt haben.
⚠️ WARNUNG: Überprüfen Sie vor dem Ändern oder Entfernen eines Runners jede Automatisierung, die ihn verwendet. Diese Automatisierungen sind auf die Verfügbarkeit, die Tools, das Betriebssystem und den Netzwerkzugang des Runners angewiesen.
Häufig gestellte Fragen
Wird das Shell-Skript auf beiden Geräten ausgeführt? Nein. Der Runner führt das Skript aus. Das Workflow-Gerät liefert den Automatisierungskontext und die Variablenwerte.
Welches Gerät beschreiben Systemvariablen? Sie beschreiben das Workflow-Gerät, das die Automatisierung durchläuft.
Welches Betriebssystem und welcher Benutzerkontext gelten? Das Betriebssystem des Runner-Geräts und die Ausführen als Einstellung, die für die Aktion ausgewählt wurde.
Wo wird die erfasste Ausgabe gespeichert? Sie wird im Automatisierungsdurchlauf des Workflow-Geräts gespeichert und kann von späteren Aktionen verwendet werden.
Warum kann ich das Runner-Gerät nicht löschen? Eine aktive Automatisierung verweist noch darauf. Öffnen Sie die Automatisierungsverwendung des Geräts und entfernen oder ersetzen Sie dann den Runner in diesen Automatisierungen.
Für Details zu Variablen, siehe Systemvariablen und Automatisierungsvariablen.