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

共用方式為