Ausführung von Schritten

In einer Schrittdefinition enthält die Eigenschaft "Befehl" Betriebssystembefehle und/oder Punktbefehle.

Sie können mehrere Befehle in einem einzelnen Schritt ausführen. Trennen Sie die einzelnen Befehle, indem Sie sie in separaten Zeilen eingeben.
Anmerkung: Wenn Sie für die Eigenschaft Ergebnis Ihres Schritts die Standardeinstellung "Exit-Code" verwenden, wird anhand des vom letzten Befehl im Schritt zurückgegebenen Exit-Codes ermittelt, ob der gesamte Schritt erfolgreich war oder fehlgeschlagen ist. Damit Sie mögliche Fehler bei der Ausführung von Befehlen erkennen, können Sie einen Protokollfilter erstellen und in der Eigenschaft Ergebnis dessen Verwendung angeben.

Bevor ein Schritt im System ausgeführt wird, wird die Schrittumgebung erstellt. Variablen werden mithilfe von Werten definiert, die in der Serverumgebung, Projektumgebung und Schrittumgebung angegeben sind. Siehe Übernahme von Umgebungen. Die Variablen werden standardmäßig syntaktisch analysiert und stehen dann für die Verwendung in Befehlen zur Verfügung. Siehe Interpretation von Variablen in Schritten.

Shell angeben

Sie können das #! -Verzeichnis verwenden, um die zum Ausführen der Befehle verwendete Shell anzugeben. Dies funktioniert unter Windows® ebenso wie auf Linux®- und UNIX®-Systemen (der Windows-Agent verarbeitet die Übergabe der Befehle an den Interpreter). Verwenden Sie #!C:\perl\bin\perl.exe, wenn Sie Befehle aus einem Schritt an eine Kopie von Perl in c:\perl\bin (unter Windows) senden möchten. Wenn Sie den Windows-Agenten mit Cygwin verwenden, jedoch einen Befehl an die Befehlsdatei cmd.exe der Windows-Shell leiten müssen, können Sie die folgende Zeile verwenden, bei der die Vorteile der impliziten Windows-Pfade genutzt werden:

#!cmd.exe /C

Beachten Sie, dass für cmd.exe die Option /C erforderlich ist. Andernfalls wartet die Datei nach der Übergabe Ihrer Schrittbefehle auf weitere Befehle. Bei einem UNIX- oder Linux-System wird die Verwendung des Befehls #!/bin/perl empfohlen.

Anmerkung: Wenn Sie den Befehl #! auf Linux- oder UNIX-Systemen verwenden, wechselt das System nicht in das Standardverzeichnis (der Pfad, der aus einer Kombination des Serverpfads, des Projektnamens und des Felds "Schrittpfad" konstruiert wird), da es die erforderliche Syntax nicht vorhersagen kann. Zum Ändern des Verzeichnisses müssen Sie Ihren eigenen entsprechenden Befehl eingeben. Verwenden Sie dazu spezielle vom System erstellte Umgebungsvariablen wie BF_SERVER_ROOT und BF_PROJECTNAME_PHYS.

Aufteilung eines Schritts

Rational® Build Forge® teilt einen Schritt in Abschnitte auf, wobei jeder Abschnitt aus einer Reihe von Betriebssystembefehlen oder aus einem einzelnen Punktbefehl besteht. Der folgende Schritt hat beispielsweise sechs Abschnitte.

cmd1        # Abschnitt 1
cmd2
.dot_cmd1   # Abschnitt 2
cmd3        # Abschnitt 3
cmd4
.dot_cmd2   # Abschnitt 4
.sleep 30   # Abschnitt 5
.dot_cmd3   # Abschnitt 6

Die Schrittabschnitte werden der Reihe nach ausgeführt. Die Umgebung aus jedem Abschnitt wird an den nächsten Abschnitt übergeben. Wenn in einem Abschnitt ein Fehler auftritt, wird die Verarbeitung sofort gestoppt.

In früheren Releases musste jeder Abschnitt aus dem vorhergehenden Schritt ein einzelner Schritt sein.

Anmerkung: Erstellen Sie keine Referenzen zwischen Abschnitten. Erstellen Sie keine Sprünge zwischen Abschnitten, z. B. ein GOTO in einem Abschnitt und das zugehörige Ziel in einem anderen Abschnitt.

Feedback