기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Batch (`awsbatch`)
에 대한 자세한 내용은 단원을 AWS Batch참조하십시오[AWS Batch](https://aws.amazon.com/batch/). 설명서는 [AWS Batch 사용 설명서](https://docs.aws.amazon.com/batch/latest/userguide/)를 참조하세요.
**AWS ParallelCluster 에 대한 CLI 명령 AWS Batch**
`awsbatch` 스케줄러를 사용하면에 대한 AWS ParallelCluster CLI 명령이 AWS ParallelCluster 헤드 노드에 자동으로 설치 AWS Batch 됩니다. CLI는 AWS Batch API 작업을 사용하며 다음 작업을 허용합니다.
+ 작업 제출 및 관리
+ 작업, 대기열 및 호스트 모니터링
+ 기존 스케줄러 명령 미러링
**중요**
AWS ParallelCluster 는에 대한 GPU 작업을 지원하지 않습니다 AWS Batch. 자세한 내용은 [GPU 작업](https://docs.aws.amazon.com/batch/latest/userguide/gpu-jobs.html)을 참조하세요.
**Topics**
+ [`awsbsub`](awsbatchcli.awsbsub.md)
+ [`awsbstat`](awsbatchcli.awsbstat.md)
+ [`awsbout`](awsbatchcli_awsbout.md)
+ [`awsbkill`](awsbatchcli_awsbkill.md)
+ [`awsbqueues`](awsbatchcli_awsbqueues.md)
+ [`awsbhosts`](awsbatchcli_awsbhosts.md)
# `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 작업](https://docs.aws.amazon.com/batch/latest/userguide/gpu-jobs.html)을 참조하세요.
## 위치 인수
***command***
작업을 제출(지정된 명령이 컴퓨팅 인스턴스에서 사용 가능해야 함)하거나 전송할 파일 이름을 지정합니다. 또한 `--command-file` 섹션도 참조하세요.
**arguments**
(선택 사항) 명령 또는 명령 파일의 인수를 지정합니다.
## 이름 지정된 인수
**-jn *JOB\$1NAME*, --job-name *JOB\$1NAME***
작업 이름을 지정합니다. 첫 번째 자리는 문자 또는 숫자여야 합니다. 작업 이름은 최대 128자까지 포함할 수 있으며, 대문자와 소문자, 숫자, 하이픈(-), 밑줄(\$1)을 포함할 수 있습니다.
**-c *CLUSTER*, --cluster *CLUSTER***
사용할 클러스터를 지정합니다.
**-cf, --command-file**
명령이 컴퓨팅 인스턴스로 전송될 파일임을 나타냅니다.
기본값: False
**-w *WORKING\$1DIR*, --working-dir *WORKING\$1DIR***
작업의 작업 디렉터리로 사용할 폴더를 지정합니다. 작업 디렉터리가 지정되지 않으면 작업이 사용자의 홈 디렉터리에 있는 `job-` 하위 폴더에서 실행됩니다. 이 파라미터 또는 `--parent-working-dir` 파라미터를 사용할 수 있습니다.
**-pw *PARENT\$1WORKING\$1DIR*, --parent-working-dir *PARENT\$1WORKING\$1DIR***
작업의 작업 디렉터리에서 상위 폴더를 지정합니다. 상위 작업 디렉터리가 지정되지 않은 경우, 사용자의 홈 디렉터리가 기본적으로 지정됩니다. 상위 작업 디렉터리에 `job-`라는 하위 폴더가 만들어집니다. 이 파라미터 또는 `--working-dir` 파라미터를 사용할 수 있습니다.
**-if *INPUT\$1FILE*, --input-file *INPUT\$1FILE***
작업의 작업 디렉터리에서 컴퓨팅 인스턴스로 전송할 파일을 지정합니다. 여러 입력 파일 파라미터를 지정할 수 있습니다.
**-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\$1DENYLIST*, --env-blacklist *ENV\$1DENYLIST***
작업 환경으로 내보내지 않을**** 환경 변수 이름의 목록을 쉼표로 구분하여 지정합니다. 기본적으로, `HOME`, `PWD`, `USER`, `PATH`, `LD_LIBRARY_PATH`, `TERM` 및 `TERMCAP`은 내보내지 않습니다.
**-r *RETRY\$1ATTEMPTS*, --retry-attempts *RETRY\$1ATTEMPTS***
작업을 `RUNNABLE` 상태로 전환하는 횟수를 지정합니다. 1부터 10까지 시도 횟수를 지정할 수 있습니다. 시도 횟수가 1보다 큰 경우 작업이 실패하면 `RUNNABLE` 상태로 전환될 때까지 지정된 횟수만큼 다시 시도됩니다.
기본값: 1
**-t *TIMEOUT*, --timeout *TIMEOUT***
완료되지 않은 경우가 작업을 AWS Batch 종료하는 시간을 초 단위로 지정합니다(작업 시도의 `startedAt` 타임스탬프에서 측정). 제한 시간 값은 60초 이상이어야 합니다.
**-n *NODES*, --nodes *NODES***
작업을 위해 예약할 노드 수를 지정합니다. 다중 노드 병렬 제출을 사용하려면 이 파라미터의 값을 지정합니다.
[`cluster_type`](cluster-definition.md#cluster-type) 파라미터가 `spot`로 설정된 경우 다중 노드 병렬 작업은 지원되지 않습니다.
**-a *ARRAY\$1SIZE*, --array-size *ARRAY\$1SIZE***
배열의 크기를 지정합니다. 2\$110,000 범위의 값을 지정할 수 있습니다. 작업에 배열 속성을 지정하면 배열 작업이 됩니다.
**-d *DEPENDS\$1ON*, --depends-on *DEPENDS\$1ON***
작업에 대해 세미콜론으로 구분된 종속성 목록을 지정합니다. 작업은 최대 20개의 작업에 종속될 수 있습니다. 배열 작업의 작업 ID를 지정하지 않고 `SEQUENTIAL` 유형의 종속성을 지정할 수 있습니다. 순차 종속성을 사용하면 각 하위 배열 작업을 인덱스 0부터 순차적으로 완료할 수 있습니다. 배열 작업의 작업 ID로 N\$1TO\$1N 유형의 종속성을 지정할 수도 있습니다. N\$1TO\$1N 종속성이란 이 작업의 각 인덱스 하위 항목은 각 종속성의 해당 인덱스 하위 항목이 완료될 때까지 기다린 후에만 시작할 수 있다는 의미입니다. 이 파라미터의 구문은 "jobId=**,type=**;..."입니다.
# `awsbstat`
클러스터의 작업 대기열에 제출된 작업을 표시합니다.
```
awsbstat [-h] [-c CLUSTER] [-s STATUS] [-e] [-d] [job_ids [job_ids ...]]
```
## 위치 인수
***job\$1ids***
출력에 표시할 작업 ID 목록을 공백으로 구분하여 지정합니다. 작업이 작업 배열이면 모든 하위 작업이 표시됩니다. 단일 작업이 요청되면 자세한 버전으로 표시됩니다.
## 이름 지정된 인수
**-c *CLUSTER*, --cluster *CLUSTER***
사용할 클러스터를 지정합니다.
**-s *STATUS*, --status *STATUS***
포함할 작업 상태 목록을 쉼표로 구분하여 지정합니다. 기본 작업 상태는 “활성”입니다. 허용되는 값: `SUBMITTED`, `PENDING`, `RUNNABLE`, `STARTING`, `RUNNING`, `SUCCEEDED`, `FAILED` 및 `ALL`
기본값: “`SUBMITTED`,`PENDING`,`RUNNABLE`,`STARTING`,`RUNNING`”
**-e, --expand-children**
하위 항목(배열 및 다중 노드 병렬 모두)을 사용하여 작업을 확장합니다.
기본값: False
**-d, --details**
작업 세부 정보를 표시합니다.
기본값: False
# `awsbout`
지정된 작업의 출력을 표시합니다.
```
awsbout [ - h ] [ - c CLUSTER ] [ - hd HEAD ] [ - t TAIL ] [ - s ] [ - sp STREAM_PERIOD ] job_id
```
## 위치 인수
***job\$1id***
작업 ID를 지정합니다.
## 이름 지정된 인수
**-c *CLUSTER*, --cluster *CLUSTER***
사용할 클러스터를 지정합니다.
**-hd *HEAD*, --head *HEAD***
작업 출력의 첫 번째 *HEAD* 행을 가져옵니다.
**-t *TAIL*, --tail *TAIL***
작업 출력의 마지막 행을 가져옵니다.
**-s, --stream**
작업 출력을 가져온 다음 추가 출력이 생성될 때까지 대기합니다. 이 인수는 -tail과 함께 사용하여 작업 출력의 마지막 행에서 시작할 수 있습니다.
기본값: False
**-sp *STREAM\$1PERIOD*, --stream-period *STREAM\$1PERIOD***
스트리밍 기간을 설정합니다.
기본값: 5
# `awsbkill`
클러스터에 제출된 작업을 취소하거나 종료합니다.
```
awsbkill [ - h ] [ - c CLUSTER ] [ - r REASON ] job_ids [ job_ids ... ]
```
## 위치 인수
***job\$1ids***
작업을 취소하거나 종료할 작업 ID 목록을 공백으로 구분하여 지정합니다.
## 이름 지정된 인수
**-c *CLUSTER*, --cluster *CLUSTER***
사용할 클러스터의 이름을 나타냅니다.
**-r *REASON*, --reason *REASON***
작업에 첨부할 메시지를 표시하고 취소 이유를 설명합니다.
기본값: “Terminated by the user”
# `awsbqueues`
클러스터와 연관된 작업 대기열을 표시합니다.
```
awsbqueues [ - h ] [ - c CLUSTER ] [ - d ] [ job_queues [ job_queues ... ]]
```
## 위치 인수
***job\$1queues***
표시할 대기열 이름의 목록을 공백으로 구분하여 지정합니다. 단일 대기열이 요청되면 자세한 버전으로 표시됩니다.
## 이름 지정된 인수
**-c *CLUSTER*, --cluster *CLUSTER***
사용할 클러스터의 이름을 지정합니다.
**-d, --details**
대기열의 세부 정보 표시 여부를 나타냅니다.
기본값: False
# `awsbhosts`
클러스터의 컴퓨팅 환경에 속한 호스트를 표시합니다.
```
awsbhosts [ - h ] [ - c CLUSTER ] [ - d ] [ instance_ids [ instance_ids ... ]]
```
## 위치 인수
***instance\$1ids***
공백으로 구분된 인스턴스 ID 목록을 지정합니다. 단일 인스턴스가 요청되면 자세한 버전으로 표시됩니다.
## 이름 지정된 인수
**-c *CLUSTER*, --cluster *CLUSTER***
사용할 클러스터의 이름을 지정합니다.
**-d, --details**
호스트의 세부 정보 표시 여부를 나타냅니다.
기본값: False