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 jobs」を参照してください。

位置引数

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 を指定すると、ノードごとの vCPU の数が識別されます。

デフォルト: 1

-m MEMORY, --memory MEMORY

ジョブに送信するメモリのハード制限 (MiB 単位) を指定します。ここで指定したメモリ制限を超えようとすると、ジョブは強制終了されます。

デフォルト: 128

-e ENV, --env ENV

ジョブ環境にエクスポートする環境変数名のカンマ区切りリストを指定します。すべての環境変数をエクスポートするには、「all」を指定します。「all」の環境変数のリストには、–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

ジョブが終了していない場合に がジョブ AWS Batch を終了するまでの時間 (ジョブ試行のstartedAtタイムスタンプから測定) を秒単位で指定します。タイムアウト値は 60 秒以上に指定する必要があります。

-n NODES, --nodes NODES

ジョブ用に予約するノード数を指定します。マルチノード並列送信が有効になるように、このパラメータに値を指定します。

注記

Scheduler/AwsBatchQueues/CapacityType パラメータが SPOT に設定されている場合、マルチノードの並列ジョブはサポートされません。さらに、アカウントには AWSServiceRoleForEC2Spot のサービスにリンクされたロールが必要です。このロールは、次の AWS CLI コマンドを使用して作成できます。

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

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「スポットインスタンスリクエストのサービスにリンクされたロール」を参照してください。

-a ARRAY_SIZE, --array-size ARRAY_SIZE

配列のサイズを示します。2 から 10,000 までの値を指定できます。ジョブの配列プロパティを指定した場合は、配列ジョブになります。

-d DEPENDS_ON, --depends-on DEPENDS_ON

ジョブの依存関係のセミコロン区切りリストを指定します。ジョブは最大 20 個のジョブに依存します。配列ジョブのジョブ ID を指定せずに、SEQUENTIAL タイプの依存関係を指定できます。シーケンシャルな依存関係では、各子配列ジョブがインデックス 0 から開始して順番に完了します。また、配列ジョブのジョブ ID を使用して N_TO_N タイプの依存関係を指定することもできます。N_TO_N の依存関係では、このジョブの各インデックスの子は各依存関係の対応するインデックスの子が完了するまで待機してから開始されます。このパラメータの構文は、「jobId=<string>,type=<string>;...」です。