StartTask interface

參考

套件:: @azure/arm-batch

在某些情況下，即使節點未重新開機，仍可能會重新執行啟動工作。因此，啟動工作應該具有等冪性，並在執行中的設定已完成時正常結束。請特別小心，以避免啟動工作從啟動工作目錄建立中斷程式或安裝/啟動服務，因為這樣會封鎖 Batch 無法重新執行啟動工作。

屬性

commandLine	命令列不會在殼層下執行，因此無法利用殼層功能，例如環境變數擴充。如果您想要利用這類功能，您應該在命令列中叫用殼層，例如在 Windows 中使用「cmd /c MyCommand」或 Linux 中的「/bin/sh -c MyCommand」。如果指定 startTask 的任何其他屬性，則為必要項。
containerSettings	當指定這個值時，所有目錄都會遞迴在節點AZ_BATCH_NODE_ROOT_DIR (節點上Azure Batch目錄的根目錄) 對應到容器中，所有工作環境變數都會對應到容器中，而工作命令列則會在容器中執行。
environmentSettings	啟動工作的環境變數設定清單。
maxTaskRetryCount	如果工作的結束代碼不是零，Batch 服務會重試工作。請注意，這個值會特別控制重試次數。 Batch 服務會嘗試工作一次，然後可一直重試直到達此限制。例如，如果重試計數上限為 3，Batch 會嘗試工作最多 4 次， (一次初始嘗試，3 次重試) 。如果重試計數上限為 0，Batch 服務不會重試工作。如果重試計數上限為 -1，Batch 服務會重試工作，而沒有限制。預設值為 0
resourceFiles	Batch 服務在執行命令列之前會下載到計算節點的檔案清單。
userIdentity	如果省略，工作會以工作唯一的非系統管理使用者身分執行。
waitForSuccess	如果為 true，且計算節點上的啟動工作失敗，Batch 服務就會將啟動工作重試到最大重試計數， (maxTaskRetryCount) 。如果工作在重試之後仍未順利完成，Batch 服務會將計算節點標示為無法使用，且不會排程工作。您可以透過節點狀態和排程錯誤詳細資料來偵測此條件。如果為 false，Batch 服務將不會等候啟動工作完成。在此情況下，其他工作可以在啟動工作仍在執行時開始在計算節點上執行;即使啟動工作失敗，新的工作仍會繼續排程在節點上。預設值是 true。

屬性詳細資料

commandLine

命令列不會在殼層下執行，因此無法利用殼層功能，例如環境變數擴充。如果您想要利用這類功能，您應該在命令列中叫用殼層，例如在 Windows 中使用「cmd /c MyCommand」或 Linux 中的「/bin/sh -c MyCommand」。如果指定 startTask 的任何其他屬性，則為必要項。

commandLine?: string

屬性值

string

containerSettings

當指定這個值時，所有目錄都會遞迴在節點AZ_BATCH_NODE_ROOT_DIR (節點上Azure Batch目錄的根目錄) 對應到容器中，所有工作環境變數都會對應到容器中，而工作命令列則會在容器中執行。

containerSettings?: TaskContainerSettings

屬性值

TaskContainerSettings

environmentSettings

啟動工作的環境變數設定清單。

environmentSettings?: EnvironmentSetting[]

屬性值

EnvironmentSetting[]

maxTaskRetryCount

如果工作的結束代碼不是零，Batch 服務會重試工作。請注意，這個值會特別控制重試次數。 Batch 服務會嘗試工作一次，然後可一直重試直到達此限制。例如，如果重試計數上限為 3，Batch 會嘗試工作最多 4 次， (一次初始嘗試，3 次重試) 。如果重試計數上限為 0，Batch 服務不會重試工作。如果重試計數上限為 -1，Batch 服務會重試工作，而沒有限制。預設值為 0

maxTaskRetryCount?: number

屬性值

number

resourceFiles

Batch 服務在執行命令列之前會下載到計算節點的檔案清單。

resourceFiles?: ResourceFile[]

屬性值

ResourceFile[]

userIdentity

如果省略，工作會以工作唯一的非系統管理使用者身分執行。

userIdentity?: UserIdentity

屬性值

UserIdentity

waitForSuccess

如果為 true，且計算節點上的啟動工作失敗，Batch 服務就會將啟動工作重試到最大重試計數， (maxTaskRetryCount) 。如果工作在重試之後仍未順利完成，Batch 服務會將計算節點標示為無法使用，且不會排程工作。您可以透過節點狀態和排程錯誤詳細資料來偵測此條件。如果為 false，Batch 服務將不會等候啟動工作完成。在此情況下，其他工作可以在啟動工作仍在執行時開始在計算節點上執行;即使啟動工作失敗，新的工作仍會繼續排程在節點上。預設值是 true。

waitForSuccess?: boolean

屬性值

boolean

共用方式為