SSH-Aktivitäten erstellen
Erstellen Sie eine Aktivität, die das SSH-Netzwerkprotokoll verwendet, um Daten von einem Zielhost zu extrahieren.
Vorbereitungen
Erforderliche Rolle: activity_creator oder workflow_admin
Warum und wann dieser Vorgang ausgeführt wird
Anweisungen zur Verwendung des Prozess-Flows für Aktivitätsvorlagen finden Sie unter Anwenderdefinierte Aktivitäten erstellen.
Prozedur
Erweiterte SSH-Skriptoptionen
Um ein MID-Server -Skript auf dem Zielhost auszuführen, geben Sie den Skripttyp an, und übergeben Sie den Namen des Skripts an den Parameter
${syncFile()}. Das System verwendet diesen Parameter, um nach dem benannten Skript in der Tabelle der MID Server-Skriptdatei [ecc_agent_script_file] zu suchen und dieses auf dem Ziel host auszuführen. Beispielsweise kann ein Bash-Skript wie folgt ausgedrückt werden: bash ${syncFile("<MID script name>")} argument1 argument2 argument3Ein Basisskript (
main_script.bash) kann auf ein anderes Skript (my_include.bash) sowie auf eine andere Datei (.my_profile) verweisen, die sich auf dem Ziel-Host befindet. Sowohl das Skript als auch die Datei, auf die verwiesen wird, müssen mithilfe des Parameters ${syncFile()} mit MID-Serversynchronisiert werden, um ordnungsgemäß ausgeführt zu werden.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 Sie die automatische Zuordnung, um Ausgaben und Analyseregeln zu generieren.
- Wenn Sie die automatische Zuordnung nicht verwenden, können Sie Ausgabevariablen und Analyseregeln manuell erstellen.
Ausführungsparameter für SSH-Vorlagen
Verwenden Sie Ausführungsparameter, um das Eingabeprozessskript im Formular Vorverarbeitung des Aktivitätendesigners zu erstellen.
Beschreibungen der Befehlsfelder finden Sie unter SSH-Ausführungsbefehle konfigurieren.
Hinweis:
Sie müssen das Präfix
executionParam. mit allen Variablen in dieser Tabelle verwenden.| Name | Variable | Typ | Verwendung |
|---|---|---|---|
| Quelle | source | Zeichenfolge | Vorgesehenes Ziel oder vorgesehener Host |
| Befehl | command | Zeichenfolge | Auf dem Host auszuführender Befehl |
| Verzeichnis | directory | Zeichenfolge | Verzeichnis auf dem Host, in dem der Befehl ausgeführt werden soll |
| Anmelde-Tag | credential_tag | Zeichenfolge | Anmelde-Tag von Orchestration, das beim Ausführen des Befehls verwendet werden soll |
| MidCapabilities | midCapabilities | Zeichenfolge (durch Kommas getrennt) | Liste der erforderlichen MID Server-Fähigkeiten |
| ValueCapabilities | valueCapabilities | Hashmap-Array | Fähigkeitswerte zur Auswahl des MID Servers. Weitere Informationen finden Sie unter MID Server-Fähigkeiten. Verwenden Sie dieses Beispiel, um die Auswahl des MID Servers anzupassen, wenn zusätzliche Fähigkeiten nach Wert zugewiesen werden: |
| Lang laufend | long_running | Boolesch | Gibt an, ob die Befehlsausführung lange Zeit in Anspruch nimmt oder nicht. Der Wert „wahr“ gibt an, dass der Befehl lange ausgeführt wird. |
| Sudo erforderlich | must_sudo | Boolesch | Gibt an, ob diese Aktivität Sudo verwenden muss, um Root-Befehle auszuführen. Der Wert „true“ gibt an, dass sudo- SSH-Anmeldeinformationen verwendet werden müssen. |
SSH-Nachverarbeitungsparameter und Analyse des Payload
Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript und eine Payload-Analyse zu erstellen sowie ein Tagging vorzunehmen.
| Name | Variable | Typ | Verwendung |
|---|---|---|---|
| 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 Eingabenachricht der ECC-Warteschlange zugeordnet ist |
| ErrorMessages | errorMessages | Zeichenfolge | Enthält die vom SSH-Befehl abgerufenen Fehlermeldungen. Dieser Wert ist null, wenn keine Fehlermeldungen vorhanden sind. |
| Tags | tags | Hashmap der vom SSH-Befehl zurückgegebenen Tag-Werte. | Enthält die Tags, die zum Extrahieren der Ausgabe mithilfe der SSH-Befehle verwendet werden. Die Tag-Ausgabe wird durch doppelte Prozentzeichen begrenzt, wie z. B. %%tagname%% … %%. Geben Sie den Befehl in folgendem Format an:tag beginnt und mit dem Tag-Namen endet. |
SSH-Ausführungsbefehle konfigurieren
Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration auf dem Hostziel ausführt.
Vorbereitungen
Erforderliche Rolle: activity_creator, admin
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 dazu finden Sie unter „Vorlagenausgaben testen“.
Prozedur
-
Ziehen Sie Variablen aus der Liste der Eingaben, und legen Sie sie in den Befehlsfeldern ab.
Das System formatiert die Variablen in der richtigen Syntax für den Befehl.
Abbildung : 1. SSH-Ausführungsbefehl