JobPreparationTask Klasse

command_line

str

Erforderlich. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher keine Shellfeatures wie die Erweiterung von Umgebungsvariablen nutzen. Wenn Sie solche Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" unter Linux. Wenn die Befehlszeile auf Dateipfade verweist, sollte sie einen relativen Pfad (relativ zum Arbeitsverzeichnis Task) oder die von Batch bereitgestellte Umgebungsvariable (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) verwenden.

container_settings

TaskContainerSettings

Die Einstellungen für den Container, unter dem der Auftragsvorbereitungstask ausgeführt wird. Wenn dies angegeben ist, werden alle Verzeichnisse rekursiv unterhalb der AZ_BATCH_NODE_ROOT_DIR (dem Stammverzeichnis der Azure Batch Verzeichnisse auf dem Knoten) dem Container zugeordnet, alle Taskumgebungsvariablen werden dem Container zugeordnet, und die Taskbefehlszeile wird im Container ausgeführt. Dateien, die im Container außerhalb von AZ_BATCH_NODE_ROOT_DIR erstellt werden, werden möglicherweise nicht auf den Hostdatenträger wiedergegeben, was bedeutet, dass Batch-Datei-APIs nicht auf diese Dateien zugreifen können.

resource_files

list[ResourceFile]

Dateien, die unter diesem Element aufgeführt sind, befinden sich im Arbeitsverzeichnis des Tasks. Es gibt eine maximale Größe für die Liste der Ressourcendateien. Wenn die maximale Größe überschritten wird, schlägt die Anforderung fehl, und der Antwortfehlercode lautet RequestEntityTooLarge. In diesem Fall muss die Sammlung von ResourceFiles verkleinert werden. Dies kann mithilfe von .zip-Dateien, Anwendungspaketen oder Docker-Containern erreicht werden.

environment_settings

list[EnvironmentSetting]

constraints

TaskConstraints

Einschränkungen, die für den Auftragsvorbereitungstask gelten.

wait_for_success

bool

Gibt an, ob der Batch-Dienst auf den erfolgreichen Abschluss des Auftragsvorbereitungstask warten soll, bevor andere Aufgaben des Auftrags auf dem Computeknoten geplant werden. Ein Auftragsvorbereitungstask wurde erfolgreich abgeschlossen, wenn er mit dem Exitcode 0 beendet wird. Wenn true und der Auftragsvorbereitungstask auf einem Knoten fehlschlägt, führt der Batch-Dienst den Auftragsvorbereitungstask bis zu seiner maximalen Wiederholungsanzahl (wie im constraints-Element angegeben) erneut aus. Wenn die Aufgabe nach allen Wiederholungen immer noch nicht erfolgreich abgeschlossen wurde, plant der Batch-Dienst keine Aufgaben des Auftrags auf dem Knoten. Der Knoten bleibt aktiv und kann Aufgaben anderer Aufträge ausführen. Bei "false" wartet der Batch-Dienst nicht auf den Abschluss des Auftragsvorbereitungstask. In diesem Fall können andere Aufgaben des Auftrags mit der Ausführung auf dem Computeknoten beginnen, während der Task zur Auftragsvorbereitung noch ausgeführt wird. Und selbst wenn der Auftragsvorbereitungstask fehlschlägt, werden neue Aufgaben weiterhin auf dem Computeknoten geplant. Der Standardwert lautet „true“.

user_identity

UserIdentity

Die Benutzeridentität, unter der der Auftragsvorbereitungstask ausgeführt wird. Wenn diese Angabe ausgelassen wird, wird der Task als nicht administrativer Benutzer ausgeführt, der für die Aufgabe auf Windows-Computeknoten eindeutig ist, oder als nicht administrativer Benutzer, der für den Pool auf Linux-Computeknoten eindeutig ist.

rerun_on_node_reboot_after_success

bool

Gibt an, ob der Batch-Dienst den Auftragsvorbereitungstask nach dem Neustart eines Computeknotens erneut ausführen soll. Der Auftragsvorbereitungstask wird immer dann erneut ausgeführt, wenn ein Computeknoten ein erneutes Image erstellt wird oder wenn der Auftragsvorbereitungstask nicht abgeschlossen wurde (z. B. weil der Neustart während der Ausführung des Tasks erfolgte). Daher sollten Sie einen Auftragsvorbereitungstask immer so schreiben, dass er idempotent ist und sich bei mehrfacher Ausführung ordnungsgemäß verhält. Der Standardwert lautet „true“.