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는 AWS Batch를 위한 GPU 작업은 지원하지 않습니다. 자세한 내용은 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와 함께 사용할 경우 노드당 vCPU 수를 식별합니다.

기본값: 1

-m MEMORY, --memory MEMORY

작업에 제공할 메모리의 하드 제한(MiB)을 지정합니다. 작업에서 여기서 지정된 메모리 제한을 초과하려고 하면 해당 작업이 중지됩니다.

기본값: 128

-e ENV, --env ENV

작업 환경으로 내보낼 환경 변수 이름의 목록을 쉼표로 구분하여 지정합니다. 모든 환경 변수를 내보내려면 'all'을 지정하세요. –env-blacklist 파라미터에 나열된 변수, 또는 PCLUSTER_*나 AWS_*로 시작하는 변수는 'all' 환경 변수 목록에 포함되지 않습니다.

-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 EC2 사용 설명서의 스팟 인스턴스 요청용 서비스 연결 역할을 참조하세요.

-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>;..."입니다.