Zum Hauptinhalt springen

Unix Update Package

Aktuelle Konfiguration des Tasks `Unix Update Package` im Workflow Designer
  • Aufgabentyp: ssh_updatepackage

Beschreibung​

Der Task Unix Update Package ermöglicht das Aktualisieren eines einzelnen Softwarepakets auf einem System, indem die Operation auf der lokalen Maschine (Modus Default) oder auf einem Remote-Host über SSH ausgeführt wird.

Der Task verwaltet das Paketverwaltungssystem des Betriebssystems transparent und vereinfacht die Durchführung von Update-Operationen innerhalb des Workflows.

Konfiguration​

Die Konfiguration definiert den Ausführungsmodus (lokal oder remote) und die Optionen für das für das Update verwendete Paketverwaltungssystem. Die Konfigurationsfelder können manuell ausgefüllt oder dynamisch über Workflow-Parameter und -Variablen. befüllt werden.

Serververbindung​

  • Verbindungsmodus: Definiert die Quelle der für die Verbindung verwendeten Anmeldeinformationen. Es können drei Betriebsmodi angenommen werden:
  • Default: Der Befehl wird von der lokalen Maschine ausgeführt.
  • Manuell: Ermöglicht die manuelle Eingabe der SSH-Verbindungsparameter.
  • Environment: Verwendet eine voreingestellte Verbindungsumgebung. In diesem Modus wird ein Menü angezeigt, das die verfügbaren Verbindungen basierend auf der dem Workflow zugeordneten Rolle auflistet.
  • IP-Adresse: IP-Adresse des Remote-Servers.
  • Hostname: Hostname des Remote-Servers.
  • Benutzer: Benutzername, der für die SSH-Verbindung verwendet wird.
  • Passwort: Passwort, das mit dem Verbindungskonto verknüpft ist.
  • Port: Port, der für die SSH-Verbindung verwendet wird (der Standardwert ist 22).

Befehl als anderer Benutzer ausführen​

Durch Aktivieren dieser Checkbox kann die Suche mit einem Benutzer durchgeführt werden, der von dem für die SSH-Verbindung verwendeten Benutzer abweicht.

  • Benutzer: Name des Benutzers, unter dem der Befehl ausgeführt wird.
  • Passwort: Passwort des Benutzers, der für die Ausführung des Befehls verwendet wird.

Update-Details​

  • Paketmanager: Ein Menü, das den geeigneten Paketmanager für das Betriebssystem des Zielservers auswählen lässt. Die Wahl des richtigen Managers ist für den Erfolg der Operation unerlässlich.
  • yum: Für Red Hat-basierte Distributionen (wie CentOS, Fedora, RHEL) zu verwenden.
  • apt: Für Debian-basierte Distributionen (wie Ubuntu, Debian) zu verwenden.
  • Paket: Der exakte Name des zu aktualisierenden Softwarepakets (z. B. openssl, httpd, nginx).

Ausgabe-Parameter​

Nach Abschluss der Ausführung stellt der Task die folgenden Ausgabe-Parameter bereit:

  • result: Enthält eine Textnachricht, die das Ergebnis der Operation oder eine Fehlermeldung beschreibt (z. B. “Missing server address”).
  • resultJson: Stellt das Ergebnis der Task-Ausführung im JSON-Format dar und enthält allgemeine Informationen, Konfigurationen und Details zur Ausführung.
  • exitStatus: Gibt den Exit-Code des Update-Befehls zurück. Ein Wert von 0 gibt an, dass das Update erfolgreich abgeschlossen wurde.

Beispiel-Parameter resultJson​

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Wichtige Hinweise​

  • Berechtigungen: Der Task stellt eine SSH-Verbindung zum Remote-Server her und führt den konfigurierten Paket-Update-Befehl aus. Wenn eine Authentifizierung über SSH-Schlüssel verwendet wird, muss der öffentliche Schlüssel auf dem Remote-Server registriert sein. Wenn die Option „Befehl als anderer Benutzer ausführen“ aktiviert ist, wird der Befehl mit einem Benutzer ausgeführt, der von dem Haupt-SSH-Verbindungsbenutzer abweicht.
  • Internetkonnektivität: Der Remote-Server muss über Internetzugang verfügen, um die Software-Repositories erreichen zu können, von denen das Update heruntergeladen werden soll.