Einführung
Automatisierungsvariablen ermöglichen es Aktionen, innerhalb derselben Pipeline Daten aneinander weiterzugeben. Eine Aktion schreibt einen Wert in eine Variable – einen Exit-Code eines Skripts, einen benutzerdefinierten Feldwert, ein Patching-Ergebnis – und eine spätere Aktion oder Bedingung liest diesen aus.
Variablen sind auf die Automatisierung beschränkt, in der sie definiert wurden. Sie werden nicht zwischen Automatisierungen übertragen.
Automatisierungsvariablen erstellen
Es gibt zwei Möglichkeiten, eine Automatisierungsvariable zu erstellen.
Über den Reiter „Variablen"
Öffnen Sie eine Automatisierung und klicken Sie auf Variablen in der linken Seitenleiste.
Wählen Sie den Benutzerdefiniert Reiter.
Klicken Sie auf + Variable hinzufügen.
Geben Sie einen Namen (ohne Leerzeichen) und einen optionalen Standardwert ein.
Klicken Sie auf Speichern.
Variablen, die im Benutzerdefiniert Reiter sind sofort in allen Aktionen und Bedingungen der Automatisierung verfügbar.
Wählen Sie den System Reiter, um die schreibgeschützte Referenz der integrierten Level-Variablen zu durchsuchen. Sie zeigt die Referenz, Beschreibung, den Typ und einen Beispielwert jeder Variable. Systemvariablen sind immer verfügbar und müssen nicht erstellt werden. Siehe Systemvariablen Reiter für Details.
Über die Ausgabe einer Aktion
Jede Aktion kann ihre Ausgabe zur Laufzeit in eine Variable schreiben.
Öffnen Sie eine Aktion im Bearbeitungsmodus und scrollen Sie zu Zusätzliche Optionen.
Geben Sie im Aktionsausgabe einer Variable zuweisen Feld einen Variablennamen ein oder wählen Sie eine vorhandene aus.
Speichern Sie die Aktion.
ℹ️ HINWEIS: Dies ist derselbe Mechanismus, der durch das orangefarbene (x) Badge auf Pipeline-Karten. Wenn Sie ein (x) Badge auf einer Aktion, liest oder schreibt diese Aktion eine Variable.
Variablen verwenden
In Aktionen und Skripten
Überall dort, wo das Rendern von Variablen unterstützt wird, klicken Sie auf das Variablensymbol, um eine Variable nach Name einzufügen. Sie können die Referenz auch direkt mit der Doppel-Curly-Bracket-Syntax eingeben, z. B. {{MyVariable}}.
In Aktionsbedingungen
Variablen können in Aktionsbedingungen ausgelesen werden, um zu steuern, ob ein Schritt ausgeführt wird. Zum Beispiel: Eine „Alarm erstellen"-Aktion nur auslösen, wenn eine Variable namens PatchingStatus gleich failed.
Siehe Aktionsbedingungen die vollständige Referenz zu Bedingungstypen und Operatoren.
Zuordnung zu Skriptvariablen
Skriptvariablen sind benannte Werte, die im Variablen Reiter. In einer Skript ausführen Aktion ermöglicht die Zuordnung einer Skriptvariablen zu einer Automatisierungsvariablen, sodass Werte in beide Richtungen fließen können:
Bevor das Skript ausgeführt wird, rendert Level den aktuellen Wert der Automatisierungsvariablen in die zugeordnete Skriptvariable. Dadurch kann ein wiederverwendbares gespeichertes Skript Automatisierungseingaben empfangen, ohne einen automatisierungsspezifischen Variablennamen im Skript fest zu codieren.
Wenn das Skript der zugeordneten Skriptvariablen einen neuen Wert zuweist, schreibt Level diesen Wert zurück in die Automatisierungsvariable, sodass spätere Aktionen und Bedingungen ihn verwenden können.
So ordnen Sie eine Skriptvariable einer Automatisierungsvariablen zu:
Öffnen Sie die Skript ausführen Aktion im Bearbeitungsmodus.
Öffnen Sie im Skriptvariablen Abschnitt und suchen Sie die Skriptvariable, die Sie zuordnen möchten.
Öffnen Sie das Automatisierungsvariablen Dropdown in dieser Zeile.
Wählen Sie eine vorhandene Automatisierungsvariable aus oder klicken Sie auf Neue Variable erstellen.
Wenn das Skript startet, erhält die zugeordnete Skriptvariable den aktuellen Wert der Automatisierungsvariablen. Um einen neuen Wert zurück an die Automatisierung zu senden, weisen Sie die Skriptvariable mit {{script_variable_name=value_expression}}.
Level ersetzt diese Zuweisung durch den korrekten Befehl für die Shell des Skripts. Die Skriptvariable muss im Variablen Reiter definiert und in der Skript ausführen Aktion.
ℹ️ HINWEIS: Der Abschnitt „Skriptvariablen" wird nur angezeigt, wenn das ausgewählte Skript mindestens eine Variable im Reiter „Variablen" definiert hat.
Verwenden Sie Aktionsausgabe einer Variable zuweisen stattdessen verwenden, wenn die gesamte Standardausgabe des Skripts der Wert ist, den Sie erfassen möchten.
💡 TIPP: Dieses Muster – Ausgabe erfassen → in einer Bedingung prüfen – ist die Standardmethode zum Aufbau einer bedingten Fehlerbehandlung in Level. Siehe Automatisierungen erstellen für eine vollständige Anleitung zu diesem Muster.
Häufig gestellte Fragen
Wo kann ich alle in einer Automatisierung verfügbaren Variablen einsehen? Öffnen Sie die Automatisierung und klicken Sie auf Variablen in der linken Seitenleiste. Der Benutzerdefiniert Reiter listet die für diese Automatisierung definierten Variablen auf. Der System Reiter enthält eine durchsuchbare, schreibgeschützte Referenz der integrierten Variablen. Siehe Systemvariablen für Details.
Kann ich denselben Variablennamen in mehreren Automatisierungen verwenden? Ja. Variablennamen sind auf die Automatisierung beschränkt –
PatchingStatusin einer Automatisierung hat nichts mitPatchingStatusin einer anderen.Welchen Wert hat eine Variable, bevor eine Aktion in sie schreibt? Es wird der Standardwert verwendet, der beim Erstellen der Variable festgelegt wurde. Wenn kein Standardwert festgelegt wurde, ist sie leer.
Kann ich eine Variable aus einem früheren Automatisierungsdurchlauf auslesen? Nein. Variablen werden zu Beginn jedes Durchlaufs zurückgesetzt. Sie werden nicht zwischen Durchläufen gespeichert.