awsbsub - AWS ParallelCluster
定位引數具名引數

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

awsbsub

將任務提交至叢集的任務佇列。

awsbsub [-h] [-jn JOB_NAME] [-c CLUSTER] [-cf] [-w WORKING_DIR]
        [-pw PARENT_WORKING_DIR] [-if INPUT_FILE] [-p VCPUS] [-m MEMORY]
        [-e ENV] [-eb ENV_DENYLIST] [-r RETRY_ATTEMPTS] [-t TIMEOUT]
        [-n NODES] [-a ARRAY_SIZE] [-d DEPENDS_ON]
        [command] [arguments [arguments ...]]
重要

AWS ParallelCluster 不支援 的 GPU 任務 AWS Batch。如需詳細資訊，請參閱 GPU 任務。

定位引數

command

提交任務 （指定的命令必須可用於運算執行個體） 或要傳輸的檔案名稱。另請參閱--command-file。

arguments

(選用) 指定命令或命令檔案的引數。

具名引數

-jn JOB_NAME, --job-name JOB_NAME

為任務命名。第一個字元必須是字母或數字。任務名稱可包含字母 （大小寫）、數字、連字號和底線，長度上限為 128 個字元。

-c CLUSTER, --cluster CLUSTER

指定要使用的叢集。

-cf, --command-file

指出命令是要傳輸至運算執行個體的檔案。

預設：False

-w WORKING_DIR, --working-dir WORKING_DIR

指定要做為任務工作目錄的資料夾。如果未指定工作目錄，任務會在使用者主目錄的job-<AWS_BATCH_JOB_ID>子資料夾中執行。您可以使用此參數或 --parent-working-dir 參數。

-pw PARENT_WORKING_DIR, --parent-working-dir PARENT_WORKING_DIR

指定任務工作目錄的父資料夾。如果未指定父工作目錄，則會預設為使用者的主目錄。系統會在上層工作目錄中建立一個名為 job-<AWS_BATCH_JOB_ID> 的子資料夾。您可以使用此參數或 --working-dir 參數。

-if INPUT_FILE, --input-file INPUT_FILE

在任務的工作目錄中指定要傳輸至運算執行個體的檔案。您可以指定多個輸入檔案參數。

-p VCPUS, --vcpus VCPUS

指定要保留給容器的 vCPU 數目。與 搭配使用時–nodes，它會識別每個節點vCPUs 數量。

預設：1

-m MEMORY, --memory MEMORY

指定要提供給任務的記憶體的硬性限制 (以 MiB 為單位)。如果您的任務嘗試超過此處指定的記憶體限制，則任務會結束。

預設：128

-e ENV, --env ENV

指定以逗號分隔的清單，其中列出要匯出至任務環境的環境變數名稱。若要匯出所有環境變數，請指定「所有」。請注意，「全部」環境變數的清單不包含 –env-blacklist 參數中列出的變數，或以 PCLUSTER_*或 AWS_*字首開頭的變數。

-eb ENV_DENYLIST, --env-blacklist ENV_DENYLIST

指定以逗號分隔的清單，其中列出不匯出至任務環境的環境變數名稱。根據預設，不會匯出 HOME、PWD、USER、PATH、LD_LIBRARY_PATH、TERM 和 TERMCAP。

-r RETRY_ATTEMPTS, --retry-attempts RETRY_ATTEMPTS

指定將任務移至 RUNNABLE 狀態的次數。您可以指定嘗試 1 至 10 次。如果嘗試的值大於 1，則會在任務失敗時重試，直到其移至指定次數RUNNABLE的狀態為止。

預設：1

-t TIMEOUT, --timeout TIMEOUT

以秒為單位指定持續時間 （從任務嘗試的startedAt時間戳記測量），之後如果任務尚未完成，則 會 AWS Batch 終止任務。逾時值必須至少為 60 秒。

-n NODES, --nodes NODES

指定要為任務保留的節點數目。指定此參數的值，以啟用多節點平行提交。

注意

當 Scheduler / AwsBatchQueues / CapacityType 參數設定為 時SPOT，不支援多節點平行任務。此外，您的帳戶中必須有AWSServiceRoleForEC2Spot服務連結角色。您可以使用下列 AWS CLI 命令建立此角色：

$ aws iam create-service-linked-role --aws-service-name spot.amazonaws.com

如需詳細資訊，請參閱《Amazon Elastic Compute Cloud Linux 執行個體使用者指南》中的 Spot 執行個體請求的服務連結角色。

-a ARRAY_SIZE, --array-size ARRAY_SIZE

指出陣列的大小。您可指定介於 2 到 10,000 之間的值。如果您對任務指定陣列屬性，它會變成陣列任務。

-d DEPENDS_ON, --depends-on DEPENDS_ON

指定以分號分隔的清單，其中列出任務的相依性。一個任務可以取決於最多 20 個任務。您可以指定SEQUENTIAL類型相依性，而無需指定陣列任務的任務 ID。序列相依性允許每個子陣列任務循序完成，從索引 0 開始。您也可以指定 N_TO_N 類型相依性，以及陣列任務的任務 ID。N_TO_N 相依性表示，此任務的每個索引子系必須等待各相依性對應的索引子系完成後，才能開始。此參數的語法為 "jobId=<string>，type=<string>；..."。