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

指定以逗號分隔的清單，其中列出要匯出至任務環境的環境變數名稱。若要匯出所有環境變數，請指定「所有」。請注意，'all' 環境變量的列表不包括–env-blacklist參數中列出的變量或以 PCLUSTER_* or 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

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

注意

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

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

如需詳細資訊，請參閱 Amazon 彈性運算雲端 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 相依性表示，此任務的每個索引子系必須等待各相依性對應的索引子系完成後，才能開始。<string>這個參數的語法是「jobId =<string>，類型 =;...」。