Erstellen Sie eine SSH-Aktivität
Erstellen Sie eine Aktivität, die Daten aus einem Zielhost extrahiert, der das SSH-Netzwerkprotokoll verwendet.
Vorbereitungen
Erforderliche Rolle: Activity_Creator oder Workflow_admin
Warum und wann dieser Vorgang ausgeführt wird
Anweisungen zur Verwendung des Aktivitätsvorlagen-Prozess-Flows finden Sie unter Erstellen Sie anwenderdefinierte Aktivitäten .
Prozedur
Erweiterte SSH-Skriptoptionen
Zum Ausführen von MID-ServerSkript auf dem Zielhost, geben Sie den Skripttyp an, und übergeben Sie den Namen des Skripts an
${syncFile()} Parameter. Das System verwendet diesen Parameter, um das benannte Skript in der Tabelle „MID-Serverskriptdatei“ [ecc_agent_script_file] zu suchen und es auf dem Zielhost auszuführen. Ein Bash-Skript kann beispielsweise folgendermaßen ausgedrückt werden: bash ${syncFile("<MID script name>")} argument1 argument2 argument3Ein Basisskript (
Main_script.bash ) Kann auf ein anderes Skript verweisen ( My_include.bash ) Sowie eine separate Datei ( .Mein_Profil ) Befindet sich auf dem Zielhost. Sowohl Skripts als auch die referenzierte Datei müssen mit synchronisiert werden MID-Server, Mit ${syncFile()} Parameter, zur ordnungsgemäßen Ausführung.source ${syncFile(".my_profile")}
cp ${syncFile("my_include.bash")} /usr/ssmith/my_include.bash
bash ${syncFile("main_script.bash")} one two three four five six
rm /usr/ssmith/my_include.bashEin Python-Beispiel mit Inline-Kommentaren könnte wie folgt aussehen:
set $LIB_DIR=/usr/bin;.
# Sync a file that is referenced inside myF5CreateLBPool.py
cp ${syncFile("specialFunctions.py")} ~/specialFunctions.py
# set up environment variables
source ${syncFile(".python_profile")}
# call script that sets up dependencies on the box from remote package repos
python ${syncFile("setupPythonDependencies.py")} pycontrol
# call a script that requires functions from the package as well as a function from myIncludedFile
python ${syncFile("myF5CreateLBPool.py")} snow_pool myActualValue
# user is responsible for their own cleanup
rm ~/specialFunctions.py Nächste Maßnahme
- Verwenden automatische Zuordnung Dient zum Generieren von Ausgaben und Analyseregeln
- Wenn Sie keine automatische Zuordnung verwenden, können Sie manuell Erstellen Sie Ausgabevariablen Und Erstellen Sie Analyseregeln
SSH-Vorlagenausführungsparameter
Verwenden Sie Ausführungsparameter, um das Eingabeprozessskript in zu erstellen Vorverarbeitung Formular des Aktivitätendesigners.
Beschreibungen der Befehlsfelder finden Sie unter Konfigurieren Sie den SSH-Ausführungsbefehl.
Hinweis:
Sie müssen verwenden
ExecutionParameter. Präfix mit allen Variablen in dieser Tabelle.| Name | Variable | Typ | Nutzung |
|---|---|---|---|
| Quelle | Quelle | Zeichenfolge | Beabsichtigtes Ziel oder Host. |
| Befehl | command | Zeichenfolge | Kommentar, der auf dem Host ausgeführt werden soll. |
| Verzeichnis | Verzeichnis | Zeichenfolge | Verzeichnis auf dem Host, in dem der Befehl ausgeführt werden soll. |
| Anmeldeinformations-Tag | Credential_Tag | Zeichenfolge | Orchestration-Anmeldeinformations-Tag, das bei der Ausführung des Befehls verwendet werden soll. |
| MidCapabilities | MidCapabilities | Zeichenfolge (kommagetrennt) | Liste der erforderlichen MID-Serverfähigkeiten. |
| Wertfähigkeiten | Wertfähigkeiten | Array von Hashmap | Fähigkeitswerte, die zum Auswählen des MID-Servers verwendet werden. Weitere Informationen finden Sie unter MID-Serverfähigkeiten . Wenn zusätzliche Fähigkeiten vorhanden sind, die nach Wert zugewiesen werden, verwenden Sie dieses Beispiel, um die MID-Serverauswahl anzupassen: |
| Lange ausgeführt | Long_running | Boolean | Gibt an, ob der Befehl lange ausgeführt wird. Der Wert „wahr“ gibt an, dass der Befehl lange ausgeführt wird. |
| Muss sudo | Muss_sudo | Boolean | Gibt an, ob diese Aktivität sudo zum Ausführen von Stammbefehlen verwenden muss. Der Wert „wahr“ gibt das an Sudo SSH-Anmeldeinformationen Muss verwendet werden. |
SSH-Nachverarbeitungsparameter und Nutzlastanalyse
Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript, eine Nutzlastanalyse und ein Tagging zu erstellen.
| Name | Variable | Typ | Nutzung |
|---|---|---|---|
| Ausgabe | Ausgabe | Zeichenfolge | Enthält die vom SSH-Befehl zurückgegebene Ausgabe. |
| EccSysID | EccSysID | Zeichenfolge | Enthält die Referenz-ID, die der von der Aktivität zurückgegebenen ECC-Warteschlangeneingabenachricht zugeordnet ist. |
| Fehlernachrichten | errorMessages | Zeichenfolge | Enthält die vom SSH-Befehl abgerufenen Fehlermeldungen. Dieser Wert ist Null Wenn keine Fehlermeldungen vorhanden sind. |
| Tags | tags | HashMap der Tag-Werte, die vom SSH-Befehl zurückgegeben werden | Enthält die Tags, die zum Extrahieren der Ausgabe mit den SSH-Befehlen verwendet werden. Die Tag-Ausgabe wird durch doppelte Prozentzeichen getrennt, wie in %%tagname%% … %% . Richten Sie den Befehl im folgenden Format ein:Tag Mit dem Tagnamen angehängt. |
Konfigurieren Sie den SSH-Ausführungsbefehl
Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration für das Hostziel ausführt.
Vorbereitungen
Erforderliche Rolle: Activity_Creator, Administrator
Hinweis:
Sie können die SSH-Verbindung zwischen dem MID-Server und dem Ziel testen, ohne die Aktivität in einem Workflow-Kontext ausführen zu müssen. Details finden Sie unter Testvorlagenausgaben.
Prozedur
-
Ziehen Sie Variablen aus der Liste der Eingaben, und legen Sie sie in Befehlsfelder ab.
Das System formatiert die Variable in der richtigen Syntax für den Befehl.
Abbildung : 1. SSH-Ausführungsbefehl