Mit globalen Objekten können Sie konfigurierbare Konstanten erstellen, um Ihre Pipeline zur Laufzeit zu konfigurieren. Verwenden Sie Parameter oder Benutzervariablen in Pipelines, um Werte zur Laufzeit anzugeben, anstatt die Werte fest zu codieren. Im Gegensatz zu Pipelineparametern können Benutzervariablen während des Ablaufs dynamisch festgelegt werden.
Informationen zum Erstellen von:
Pipelineparameter
Verwenden Sie Pipelineparameter, um einen Wert zur Laufzeit der Pipeline anzugeben. Wenn Sie beispielsweise möchten, dass ein Benutzer einen Bereitstellungsbereich für die Pipelineausgabe eingibt, verwenden Sie einen Parameter, um die Eingabe des Bereichsnamens anzufordern, der bei der Ausführung der Pipeline verwendet werden soll. Wenn Sie den Wert des Parameters bei jeder Ausführung des Jobs angeben, können Sie die richtigen Ressourcen verwenden.
Informationen zu Pipelineparametern:
- kann als Knotenwert zugewiesen oder für den Pipelinejob zugewiesen werden.
- kann jedem Knoten zugeordnet werden, und Sie werden durch einen Statusanzeiger benachrichtigt.
- kann für mehrere Knoten verwendet werden.
Pipelineparameter definieren
- Erstellen Sie einen Pipelineparameter über die Knotenkonfigurationsanzeige in der Symbolleiste.
- Geben Sie einen Namen und eine optionale Beschreibung ein. Der Name muss in Kleinschreibung für snake mit Kleinbuchstaben, Zahlen und Unterstreichungszeichen angegeben werden.
lower_snake_case_with_numbers_123
ist beispielsweise ein gültiger Name. Der Name muss mit einem Buchstaben beginnen. Wenn der Name nicht konform ist, erhalten Sie einen Fehler 404, wenn Sie versuchen, die Pipeline auszuführen. - Ordnen Sie einen Parametertyp zu. Je nach Parametertyp müssen Sie möglicherweise weitere Details angeben oder einen Standardwert zuordnen.
- Klicken Sie auf Zur Liste hinzufügen, um den Pipelineparameter zu speichern.
-Sie können einen einzelnen Parameter definieren oder einen Parametersatzerstellen. Parameter, die Sie einzeln definieren, können auch zu einer Gruppe hinzugefügt werden.
-Es ist möglich, einen Pipelineparameter auf eine Weise zu verwenden, die nicht unterstützte Ergebnisse in einer Pipeline erzeugen kann. Wenn Sie einen Parameter mit einem generischen Asset als Wert zuordnen, können Sie ein Asset als Parameterwert auswählen, der vom Knoten Asset kopieren nicht unterstützt wird.
Parametertypen
Es gibt folgende Parametertypkategorien:
- Basis: enthält Datentypen für die Strukturierung von Eingaben für eine Pipeline oder Optionen für die Handhabung der Erstellung eines doppelten Bereichs oder Assets.
- Ressource: Zum Auswählen eines Projekts, Katalogs, Bereichs oder Assets.
- Instanz: Wählen Sie eine Machine Learning-Instanz oder eine Cloud Object Storage -Instanz aus.
- Andere: zum Angeben von Details wie Erstellungsmodus oder Fehlerrichtlinie.
Beispiel für die Verwendung von Pipelinetypen
Gehen Sie wie folgt vor, um einen Parameter des Typs Pfadzu erzeugen:
- Erstellen Sie einen Parametersatz mit dem Namen MASTER_PARAMETER_SET.
- Erstellen Sie einen Parameter namens
file_path
und setzen Sie den Typ auf Path. - Setzen Sie den Wert von
file_path
aufmnts/workspace/masterdir
. Es gibt mehrere Möglichkeiten, den Wert festzulegen:- Ressource auswählen: Durchsuchen Sie Ihre Bereiche über die Benutzerschnittstelle nach der Datei.
- Wert eingeben: Ein gültiger Text für den relativen Pfad der Datei, z. B.
/mnts/sender.txt
.
- Ziehen Sie den Knoten Auf Datei warten in den Erstellungsbereich und setzen Sie den Wert für Dateiposition auf
MASTER_PARAMETER_SET.file_path
. - Verbinden Sie den Knoten Auf Datei warten mit dem Knoten Bash-Script ausführen , damit der letztere Knoten nach dem ersten ausgeführt wird.
- Optional: Testen Sie Ihre Parametervariable:
- Fügen Sie den Parameter der Umgebungsvariablen zum Parametersatz MASTER_PARAMETER_SET hinzu, z. B.
FILE_PATH
. - Fügen Sie den folgenden Befehl in den Scriptcode des Bash-Scripts ausführenein:
echo File: $FILE_PATH cat $FILE_PATH
- Fügen Sie den Parameter der Umgebungsvariablen zum Parametersatz MASTER_PARAMETER_SET hinzu, z. B.
- Führen Sie die Pipeline aus. Der Pfad
mnts/workspace/masterdir
befindet sich in den beiden Ausführungsprotokollen der Knoten, um festzustellen, ob sie erfolgreich übergeben wurden.
Knoten mit Pipelineparameter konfigurieren
Wenn Sie einen Knoten mit einem Pipelineparameter konfigurieren, können Sie einen vorhandenen Pipelineparameter auswählen oder im Rahmen der Konfiguration eines Knotens einen neuen Parameter erstellen.
Beispiel:
- Erstellen Sie einen Pipelineparameter namens creationmode und speichern Sie ihn in der Parameterliste.
- Konfigurieren Sie einen Knoten Bereitstellungsbereich erstellen und klicken Sie, um die Konfigurationsanzeige zu öffnen.
- Wählen Sie den Pipelineparameter als Eingabe für die Option Erstellungsmodus aus.
- Wählen Sie den Pipelineparameter creationmode aus und speichern Sie die Konfiguration.
Wenn Sie den Fluss ausführen, wird der Pipelineparameter zugeordnet, wenn der Bereich erstellt wird.
Parametersätze
Parametersätze sind eine Gruppe zusammengehöriger Parameter, die in einer Pipeline verwendet wird. Sie können beispielsweise eine Gruppe von Parametern für die Verwendung in einer Testumgebung und eine andere für die Verwendung in einer Produktionsumgebung erstellen.
Parametersätze können als Projektasset erstellt werden. Im Projekt erstellte Parametersätze sind dann für die Verwendung in Pipelines in diesem Projekt verfügbar.
Parametersatz als Projektasset erstellen
Sie können einen Parametersatz als wiederverwendbares Projektasset erstellen, das in Pipelines verwendet werden kann.
- Öffnen Sie ein vorhandenes Projekt oder erstellen Sie ein Projekt.
- Klicken Neues Asset > Wiederverwendbare Parametersätze definieren .
- Ordnen Sie einen Namen für die Gruppe zu und geben Sie die Details für jeden Parameter in der Gruppe an, einschließlich:
- Name für den Parameter
- Datentyp
- In GUI angezeigter Text
- Standardwert
- Erstellen Sie optional Wertegruppen für die Parameter im Parametersatz. Die Wertegruppen können die unterschiedlichen Werte für verschiedene Kontexte sein. Sie können beispielsweise eine Testwertgruppe mit Werten für eine Testumgebung und eine Produktionsgruppe mit Produktionswerten erstellen.
- Speichern Sie den Parametersatz, nachdem Sie alle Parameter erstellt haben. Sie wird für die Verwendung in Pipelines verfügbar, die in diesem Projekt erstellt werden.
Parametersatz zur Verwendung in einer Pipeline hinzufügen
So fügen Sie einen Parametersatz aus einem Projekt hinzu:
- Klicken Sie auf das Symbol für globale Objekte und wechseln Sie zur Registerkarte Parametersätze.
- Klicken Sie auf Parametersatz hinzufügen , um Parametersätze aus Ihrem Projekt hinzuzufügen, die Sie in Ihrer Pipeline verwenden wollen.
- Sie können Parametersätze in der Liste hinzufügen oder entfernen. Die Parametersätze, die Sie zur Verwendung in Ihrer Pipeline angeben, werden verfügbar, sobald Sie Parameter als Eingabe in der Pipeline zuweisen.
Parametersatz aus der Parameterliste in Ihrer Pipeline erstellen
Sie können einen Parametersatz aus der Parameterliste für Ihre Pipeline erstellen
- Klicken Sie auf das Symbol für globale Objekte und öffnen Sie die Pipelineparameter.
- Wählen Sie die Parameter aus, die im Satz enthalten sein sollen, und klicken Sie dann auf das Symbol Als Parametersatz speichern .
- Geben Sie einen Namen und optional eine Beschreibung für die Gruppe ein.
- Speichern Sie, um den Parametersatz zur Verwendung in Ihrer Pipeline hinzuzufügen.
Parametersatz in einer Pipeline verwenden
So verwenden Sie einen Parametersatz:
- Wählen Sie Pipelineparameter zuweisen als Eingabetyp aus einem Knoteneigenschaftenblatt aus.
- Wählen Sie den zuzuweisenden Parameter aus. In einer Liste werden alle verfügbaren Parameter des Typs für diese Eingabe angezeigt. Verfügbare Parameter können einzelne Parameter und Parameter, die als Teil einer Gruppe definiert sind, sein. Der Parametersatzname steht vor dem Namen des Parameters. Beispiel: Parameter_set_name.Parameter_name.
- Führen Sie die Pipeline aus und wählen Sie einen Wert für den entsprechenden Wert aus (falls verfügbar), weisen Sie einen Wert für den Parameter zu oder akzeptieren Sie den Standardwert.
Verwendung von Projekt-Standardparametersätzen
Ein Projekt kann einen Parametersatz namens PROJDEF haben. Dieser Parametersatz enthält einen globalen Satz von Eigenschaften, auf die dann von einem DataStage-Fluss oder Pipelines-Fluss aus verwiesen werden kann. Da es sich um einen Parametersatz handelt, können Sie zur Verwaltung dieser Variablen die vorhandene Benutzeroberfläche für Parametersätze verwenden.
Achten Sie darauf, dass PROJDEFs:
- Sie können einen PROJDEF-Parametersatzwert mit dem Wert PROJDEF des Pipelineparameters referenzieren.
- Der Wert PROJDEF wird für alle Parametertypen mit Ausnahme von verschlüsselten Parametern unterstützt.
- Die Parameter des PROJDEF-Parametersatzes müssen denselben Namen haben wie die Pipeline-Parameter, die den PROJDEF-Wert haben.
Um PROJDEF in einem Projekt zu verwenden:
- Legen Sie den Parametersatz PROJDEF an.
- Fügen Sie einen beliebigen Parameter zu Ihrem PROJDEF-Parametersatz hinzu, zum Beispiel
SOME_DATE
. - Klicken Sie auf Globale Objekte in der Symbolleiste.
- Klicken Sie auf PRODDEF-Parameter hinzufügen.
- Wählen Sie den Parameter aus der Liste aus.
Bearbeiten eines Parametersatzes in einem Job
Wenn Sie beim Definieren eines Jobs einen Parametersatz verwenden, können Sie eine Wertegruppe auswählen, um Variablen mit den Werten in dieser Gruppe zu füllen. Wenn Sie die Werte ändern und speichern, den Job bearbeiten und die Änderungen speichern, werden die Parametersatzwerte auf die Standardwerte zurückgesetzt.
Benutzervariablen
Erstellen Sie Benutzervariablen, um Werte zuzuweisen, wenn der Flow ausgeführt wird. Im Gegensatz zu Pipelineparametern können Benutzervariablen während der Verarbeitung geändert werden.
Benutzervariable definieren
Sie können Benutzervariablen zur Verwendung in Ihrer Pipeline erstellen. Benutzervariablen wie Parameter werden auf globaler Ebene definiert und sind für keinen Knoten spezifisch. Der Anfangswert für eine Benutzervariable muss bei der Definition festgelegt werden und kann nicht dynamisch als Ergebnis einer Knotenausgabe festgelegt werden. Wenn Sie eine Benutzervariable definieren, können Sie den Knoten Benutzervariablen festlegen verwenden, um sie mit der Knotenausgabe zu aktualisieren.
So erstellen Sie eine Benutzervariable:
- Erstellen Sie eine Variable über die Konfigurationsanzeige des Knotens Variable aktualisieren oder über die Symbolleiste.
- Geben Sie einen Namen und eine optionale Beschreibung ein. Der Name muss in Kleinschreibung für snake mit Kleinbuchstaben, Zahlen und Unterstreichungszeichen angegeben werden. 'lower_snake_case_with_numbers_123' ist ein Beispiel für einen gültigen Namen. Der Name muss mit einem Buchstaben beginnen. Wenn der Name nicht konform ist, erhalten Sie einen Fehler 404, wenn Sie versuchen, die Pipeline auszuführen.
- Vervollständigen Sie die Definition der Variablen, einschließlich der Auswahl eines Variablentyps und eines Eingabetyps.
- Klicken Sie auf Hinzufügen, um die Variable zur Liste hinzuzufügen. Sie ist jetzt für die Verwendung in einem Knoten verfügbar.
Einstellen einer Zeitzone
Sie können die Zeitzone in Ihrer Configmap einstellen.
- Öffnen Sie Ihre configmap, indem Sie den Befehl
kubectl edit -n <namespace> configmap watson-pipelines-config
ausführen, wobeinamespace
Ihr Cloud Pak for Data Instanznamensraum ist. - Stellen Sie den Wert für Ihre Zeitzone mit dem folgenden Codebeispiel ein:
apiVersion: v1 kind: ConfigMap metadata: name: watson-pipelines-config namespace: zen data: default_container_env: | - name: TZ value: America/New_York
- Stellen Sie den Wert für Ihre Zeitzone in Pipelines CR ein:
oc patch wspipelines wspipelines-cr -p '{"spec":{"timezone":"America/New_York"}}' --type=merge
- Warten Sie, bis der Abgleich mit abgeschlossen ist:
oc get wspipelines wspipelines-cr
Übergeordnetes Thema: Pipeline erstellen