기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# `pcluster`
`pcluster`는 기본 AWS ParallelCluster CLI 명령입니다. `pcluster`를 사용하여 AWS 클라우드에서 HPC 클러스터를 시작하고 관리할 수 있습니다.
```
pcluster [ -h ] ( create | update | delete | start | stop | status | list |
instances | ssh | dcv | createami | configure | version ) ...
```
## 인수
**`pcluster command`**
가능한 선택: [`configure`](pcluster.configure.md), [`create`](pluster.create.md), [`createami`](pcluster.createami.md), [`dcv`](pcluster.dcv.md), [`delete`](pcluster.delete.md), [`instances`](pcluster.instances.md), [`list`](pcluster.list.md), [`ssh`](pcluster.ssh.md), [`start`](pcluster.start.md), [`status`](pcluster.status.md), [`stop`](pcluster.stop.md), [`update`](pcluster.update.md), [`version`](pcluster.version.md)
## 하위 명령:
**Topics**
+ [인수](#pcluster.arguments)
+ [하위 명령:](#pcluster.subcommands)
+ [`pcluster configure`](pcluster.configure.md)
+ [`pcluster create`](pluster.create.md)
+ [`pcluster createami`](pcluster.createami.md)
+ [`pcluster dcv`](pcluster.dcv.md)
+ [`pcluster delete`](pcluster.delete.md)
+ [`pcluster instances`](pcluster.instances.md)
+ [`pcluster list`](pcluster.list.md)
+ [`pcluster ssh`](pcluster.ssh.md)
+ [`pcluster start`](pcluster.start.md)
+ [`pcluster status`](pcluster.status.md)
+ [`pcluster stop`](pcluster.stop.md)
+ [`pcluster update`](pcluster.update.md)
+ [`pcluster version`](pcluster.version.md)
# `pcluster configure`
AWS ParallelCluster 구성을 시작합니다. 자세한 내용은 [구성 AWS ParallelCluster](getting-started-configuring-parallelcluster.md) 단원을 참조하십시오.
```
pcluster configure [ -h ] [ -c CONFIG_FILE ] [ -r REGION ]
```
## 이름 지정된 인수
**-h, --help**
`pcluster configure`에 대한 도움말 텍스트를 표시합니다.
**-c * CONFIG\$1FILE*, --config *CONFIG\$1FILE***
사용할 대체 구성 파일의 전체 경로를 지정합니다.
기본값은 `~/.parallelcluster/config`입니다.
자세한 내용은 [구성 AWS ParallelCluster](getting-started-configuring-parallelcluster.md) 단원을 참조하십시오.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. 이를 지정하면 구성이 AWS 리전 감지를 건너뜁니다.
VPC에서 네트워크 리소스를 삭제하려면 CloudFormation 네트워킹 스택을 삭제하면 됩니다. 스택 이름은 “parallelclusternetworking-”으로 시작하며 “YYYYMMDDHHMMSS” 형식의 생성 시간을 포함합니다. [list-stacks](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/ListStacks) 명령을 사용하여 스택을 나열할 수 있습니다.
```
$ aws --region us-east-1 cloudformation list-stacks \
--stack-status-filter "CREATE_COMPLETE" \
--query "StackSummaries[].StackName" | \
grep -e "parallelclusternetworking-"
"parallelclusternetworking-pubpriv-20191029205804"
```
스택은 [delete-stack](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/DeleteStack) 명령을 사용하여 삭제할 수 있습니다.
```
$ aws --region us-east-1 cloudformation delete-stack \
--stack-name parallelclusternetworking-pubpriv-20191029205804
```
[`pcluster configure`](#pcluster.configure)가 사용자를 위해 생성하는 VPC는 CloudFormation 네트워킹 스택에서 생성되지 않습니다. 콘솔에서 또는 AWS CLI를 사용하여 해당 VPC를 수동으로 삭제할 수 있습니다.
```
$ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad
```
# `pcluster create`
새 클러스터를 생성합니다.
```
pcluster create [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] [ -nr ]
[ -u TEMPLATE_URL ] [ -t CLUSTER_TEMPLATE ]
[ -p EXTRA_PARAMETERS ] [ -g TAGS ]
cluster_name
```
## 위치 인수
***cluster\$1name***
클러스터의 이름을 정의합니다. AWS CloudFormation 스택 이름은 입니다`parallelcluster-cluster_name`.
## 이름 지정된 인수
**-h, --help**
`pcluster create`에 대한 도움말 텍스트를 표시합니다.
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
사용할 대체 구성 파일을 지정합니다.
기본값은 `~/.parallelcluster/config`입니다.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. 새 클러스터의 AWS 리전 를 선택하는 데 사용되는 우선 순위는 다음과 같습니다.
1. [`pcluster create`](#pluster.create)의 `-r` 또는 `--region` 파라미터.
1. `AWS_DEFAULT_REGION` 환경 변수.
1. `aws_region_name` AWS ParallelCluster 구성 파일의 `[aws]` 섹션에서 설정(기본 위치는 `~/.parallelcluster/config`) [`pcluster configure`](pcluster.configure.md) 명령으로 업데이트된 위치입니다.
1. `region` AWS CLI 구성 파일(`~/.aws/config`)의 `[default]` 섹션에서 설정
**-nw, --nowait**
스택 명령을 실행한 후 스택 이벤트를 기다리지 않습니다.
기본값은 `False`입니다.
**-nr, --norollback**
오류 시 스택 롤백을 비활성화합니다.
기본값은 `False`입니다.
**-u *TEMPLATE\$1URL*, --template-url *TEMPLATE\$1URL***
사용자 지정 템플릿이 생성될 때 사용된 경우 사용자 지정 AWS CloudFormation 템플릿의 URL을 지정합니다.
**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***
사용할 클러스터 템플릿을 지정합니다.
**-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS***
스택 생성에 파라미터를 추가합니다.
**-g *TAGS*, --tags *TAGS***
스택에 추가할 추가 태그를 지정합니다.
명령이 호출되고 해당 호출의 상태에 대한 폴링을 시작하면 안전하게 "Ctrl-C"를 사용하여 종료할 수 있습니다. `pcluster status mycluster`를 호출하여 현재 상태 보기로 돌아갈 수 있습니다.
** AWS ParallelCluster 버전 2.11.7을 사용하는 예:**
```
$ pcluster create mycluster
Beginning cluster creation for cluster: mycluster
Info: There is a newer version 3.1.4 of AWS ParallelCluster available.
Creating stack named: parallelcluster-mycluster
Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS
$ pcluster create mycluster --tags '{ "Key1" : "Value1" , "Key2" : "Value2" }'
```
# `pcluster createami`
(Linux/macOS) 함께 사용할 사용자 지정 AMI를 생성합니다 AWS ParallelCluster.
```
pcluster createami [ -h ] -ai BASE_AMI_ID -os BASE_AMI_OS
[ -i INSTANCE_TYPE ] [ -ap CUSTOM_AMI_NAME_PREFIX ]
[ -cc CUSTOM_AMI_COOKBOOK ] [--no-public-ip]
[ -post-install POST_INSTALL_SCRIPT ]
[ -c CONFIG_FILE ] [-t CLUSTER_TEMPLATE]
[--vpc-id VPC_ID] [--subnet-id SUBNET_ID]
[ -r REGION ]
```
## 필수 종속 항목
AWS ParallelCluster CLI 외에도를 실행하려면 `pcluster createami`다음 종속성이 필요합니다.
+ **Packer**: [https://developer.hashicorp.com/packer/downloads](https://developer.hashicorp.com/packer/downloads)에서 최신 버전을 다운로드합니다.
**참고**
AWS ParallelCluster 버전 2.8.0 이전에는를 사용하려면 [Berkshelf](https://github.com/berkshelf/berkshelf)(를 사용하여 설치됨`gem install berkshelf`)가 필요했습니다`pcluster createami`.
## 이름 지정된 인수
**-h, --help**
`pcluster createami`에 대한 도움말 텍스트를 표시합니다.
**-ai *BASE\$1AMI\$1ID*, --ami-id *BASE\$1AMI\$1ID***
AMI를 빌드하는 데 사용할 기본 AWS ParallelCluster AMI를 지정합니다.
**-os *BASE\$1AMI\$1OS*, --os *BASE\$1AMI\$1OS***
기본 AMI의 OS를 지정합니다. 유효한 옵션은 `alinux2`, `ubuntu1804`, `ubuntu2004` 및 `centos7`입니다.
OS는 다양한 AWS ParallelCluster 버전의 변경 사항을 지원합니다.
+ AWS ParallelCluster 버전 2.10.4에서에 대한 지원이 제거`centos8`되었습니다.
+ AWS ParallelCluster 버전 2.10.0에서 `centos6`에 대한 지원은 제거되었으며 `centos8`에 대한 지원이 추가되었습니다.
+ alinux2에 대한 지원이 AWS ParallelCluster 버전 2.6.0에 추가되었습니다.
+ AWS ParallelCluster 버전 2.5.0에서 ubuntu1804에 대한 지원이 추가되었습니다.
**-i *INSTANCE\$1TYPE*, --instance-type *INSTANCE\$1TYPE***
AMI를 생성하는 데 사용할 인스턴스 유형을 지정합니다.
기본값은 `t2.xlarge`입니다.
`--instance-type` 인수에 대한 지원이 AWS ParallelCluster 버전 2.4.1에 추가되었습니다.
**-ap *CUSTOM\$1AMI\$1NAME\$1PREFIX*, --ami-name-prefix *CUSTOM\$1AMI\$1NAME\$1PREFIX***
결과 AWS ParallelCluster AMI의 접두사 이름을 지정합니다.
기본값은 `custom-ami-`입니다.
**-cc *CUSTOM\$1AMI\$1COOKBOOK*, --custom-cookbook *CUSTOM\$1AMI\$1COOKBOOK***
AWS ParallelCluster AMI를 빌드하는 데 사용할 쿡북을 지정합니다.
**--post-install *POST\$1INSTALL\$1SCRIPT***
설치 후 스크립트의 경로를 지정합니다. 경로에는 `s3://`, `https://` 또는 `file://` URL 체계를 사용해야 합니다. 예는 다음과 같습니다.
+ `https://bucket-name.s3.region.amazonaws.com/path/post_install.sh`
+ `s3://bucket-name/post_install.sh`
+ `file:///opt/project/post_install.sh`
`--post-install` 인수에 대한 지원이 AWS ParallelCluster 버전 2.10.0에 추가되었습니다.
**--no-public-ip**
AMI를 생성하는 데 사용된 인스턴스에 퍼블릭 IP 주소를 연결하지 마세요. 기본적으로 인스턴스에는 퍼블릭 IP 주소가 연결됩니다.
`--no-public-ip` 인수에 대한 지원이 AWS ParallelCluster 버전 2.5.0에 추가되었습니다.
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
사용할 대체 구성 파일을 지정합니다.
기본값은 `~/.parallelcluster/config`입니다.
**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***
VPC 및 서브넷 설정을 검색하는 데 사용할 *CONFIG\$1FILE의* [[`cluster`] 섹션을](cluster-definition.md) 지정합니다.
`--cluster-template` 인수에 대한 지원이 AWS ParallelCluster 버전 2.4.0에 추가되었습니다.
**--vpc-id *VPC\$1ID***
AWS ParallelCluster AMI를 빌드하는 데 사용할 VPC의 ID를 지정합니다.
`--vpc-id` 인수에 대한 지원이 AWS ParallelCluster 버전 2.5.0에 추가되었습니다.
**--subnet-id *SUBNET\$1ID***
AWS ParallelCluster AMI를 빌드하는 데 사용할 서브넷의 ID를 지정합니다.
`--vpc-id` 인수에 대한 지원이 AWS ParallelCluster 버전 2.5.0에 추가되었습니다.
**-r *REGION*, --region** *리전*
사용할 AWS 리전 를 지정합니다. 기본값은 [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 AWS 리전 지정된 입니다.
# `pcluster dcv`
헤드 노드에서 실행되는 Amazon DCV 서버와 상호 작용합니다.
```
pcluster dcv [ -h ] ( connect )
```
**`pcluster dcv command`**
가능한 선택: [`connect`](#pcluster-dcv-connect)
**참고**
OS는 다양한 AWS ParallelCluster 버전의 `pcluster dcv` 명령에 대한 변경 사항을 지원합니다.
`centos8`의 `pcluster dcv` 명령에 대한 지원이 AWS ParallelCluster 2.10.0에서 추가되었습니다.
AWS Graviton 기반 인스턴스의 `pcluster dcv` 명령에 대한 지원이 AWS ParallelCluster 버전 2.9.0에 추가되었습니다.
`ubuntu1804`의 `pcluster dcv` 명령에 대한 지원이 AWS ParallelCluster 2.6.0에서 추가되었습니다.
`centos7`의 `pcluster dcv` 명령에 대한 지원이 AWS ParallelCluster 2.5.0에서 추가되었습니다.
## 이름 지정된 인수
**-h, --help**
`pcluster dcv`에 대한 도움말 텍스트를 표시합니다.
## 하위 명령
### `pcluster dcv connect`
```
pcluster dcv connect [ -h ] [ -k SSH_KEY_PATH ] [ -r REGION ] cluster_name
```
**중요**
URL은 발행된 후 30초 지나면 만료됩니다. URL이 만료되기 전에 연결이 이루어지지 않으면 `pcluster dcv connect`를 다시 실행하여 새 URL을 생성합니다.
#### 위치 인수
***cluster\$1name***
연결할 클러스터의 이름을 지정합니다.
#### 이름 지정된 인수
**-h, --help**
`pcluster dcv connect`에 대한 도움말 텍스트를 표시합니다.
**-k *SSH\$1KEY\$1PATH*, --key-path *SSH\$1KEY\$1PATH***
연결에 사용할 SSH 키의 키 경로입니다.
키는 [`key_name`](cluster-definition.md#key-name) 구성 파라미터에서 클러스터 생성 시 지정되어야 합니다. 이 인수는 선택 사항이지만 지정하지 않으면 SSH 클라이언트에 대해 기본적으로 키를 사용할 수 있어야 합니다. 예를 들어 `ssh-agent`를 `ssh-add`와 함께 추가합니다.
**-r *REGION*, --region** *리전*
사용할 AWS 리전 를 지정합니다. 기본값은 [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 AWS 리전 지정된 입니다.
**-s, --show-url**
Amazon DCV 세션에 연결하기 위한 일회성 URL을 표시합니다. 이 옵션을 지정하면 기본 브라우저가 열리지 않습니다.
`--show-url` 인수에 대한 지원이 AWS ParallelCluster 버전 2.5.1에 추가되었습니다.
** AWS ParallelCluster 버전 2.11.7 사용 예제:**
```
$ pcluster dcv connect -k ~/.ssh/id_rsa mycluster
```
기본 브라우저를 열어 헤드 노드에서 실행 중인 Amazon DCV 세션에 연결합니다.
아직 시작되지 않은 경우 새 Amazon DCV 세션이 생성됩니다.
![\[A screenshot of the DCV console.\]](http://docs.aws.amazon.com/ko_kr/parallelcluster/v2/ug/images/Dcv-image.png)
# `pcluster delete`
클러스터를 삭제합니다.
```
pcluster delete [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name
```
## 위치 인수
***cluster\$1name***
삭제할 클러스터의 이름을 지정합니다.
## 이름 지정된 인수
**-h, --help**
`pcluster delete`에 대한 도움말 텍스트를 표시합니다.
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
사용할 대체 구성 파일을 지정합니다.
기본값은 `~/.parallelcluster/config`입니다.
**--keep-logs**
클러스터를 삭제한 후 CloudWatch Logs 데이터를 보관합니다. 로그 그룹은 수동으로 삭제될 때까지 유지되지만 로그 이벤트는 [`retention_days`](cw-log-section.md#cw-log-section-retention-days) 설정에 따라 만료됩니다. 설정 기본값은 14일입니다.
**--keep-logs** 인수에 대한 지원이 AWS ParallelCluster 버전 2.6.0에서 추가되었습니다.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. 기본값은 [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 AWS 리전 지정된 입니다.
명령이 호출되고 해당 호출의 상태에 대한 폴링을 시작하면 안전하게 "Ctrl-C"를 사용하여 종료할 수 있습니다. `pcluster status mycluster`를 호출하여 현재 상태 보기로 돌아갈 수 있습니다.
** AWS ParallelCluster 버전 2.11.7 사용 예제:**
```
$ pcluster delete -c path/to/config -r us-east-1 mycluster
Deleting: mycluster
Status: RootRole - DELETE_COMPLETE
Cluster deleted successfully.
```
VPC에서 네트워크 리소스를 삭제하려면 CloudFormation 네트워킹 스택을 삭제하면 됩니다. 스택 이름은 “parallelclusternetworking-”으로 시작하며 “YYYYMMDDHHMMSS” 형식의 생성 시간을 포함합니다. [list-stacks](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/ListStacks) 명령을 사용하여 스택을 나열할 수 있습니다.
```
$ aws --region us-east-1 cloudformation list-stacks \
--stack-status-filter "CREATE_COMPLETE" \
--query "StackSummaries[].StackName" | \
grep -e "parallelclusternetworking-"
"parallelclusternetworking-pubpriv-20191029205804"
```
스택은 [delete-stack](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/DeleteStack) 명령을 사용하여 삭제할 수 있습니다.
```
$ aws --region us-east-1 cloudformation delete-stack \
--stack-name parallelclusternetworking-pubpriv-20191029205804
```
[`pcluster configure`](pcluster.configure.md)가 사용자를 위해 생성하는 VPC는 CloudFormation 네트워킹 스택에서 생성되지 않습니다. 콘솔에서 또는 AWS CLI를 사용하여 해당 VPC를 수동으로 삭제할 수 있습니다.
```
$ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad
```
# `pcluster instances`
클러스터에 있는 모든 인스턴스의 목록을 표시합니다.
```
pcluster instances [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```
## 위치 인수
***cluster\$1name***
제공된 이름의 클러스터에 대한 인스턴스를 표시합니다.
## 이름 지정된 인수
**-h, --help**
`pcluster instances`에 대한 도움말 텍스트를 표시합니다.
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
사용할 대체 구성 파일을 지정합니다.
기본값은 `~/.parallelcluster/config`입니다.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. 기본값은 [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 AWS 리전 지정된 입니다.
** AWS ParallelCluster 버전 2.11.7 사용 예제:**
```
$ pcluster instances -c path/to/config -r us-east-1 mycluster
MasterServer i-1234567890abcdef0
ComputeFleet i-abcdef01234567890
```
# `pcluster list`
연결된 스택 목록을 표시합니다 AWS ParallelCluster.
```
pcluster list [ -h ] [ -c CONFIG_FILE ] [ -r REGION ]
```
## 이름 지정된 인수
**-h, --help**
`pcluster list`에 대한 도움말 텍스트를 표시합니다.
**--color**
클러스터 상태를 색상으로 표시합니다.
기본값은 `False`입니다.
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
사용할 대체 구성 파일을 지정합니다.
기본값은 `c`입니다.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. 기본값은 [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 AWS 리전 지정된 입니다.
이름이 인 AWS CloudFormation 스택의 이름을 나열합니다`parallelcluster-*`.
** AWS ParallelCluster 버전 2.11.7 사용 예제:**
```
$ pcluster list -c path/to/config -r us-east-1
mycluster CREATE_IN_PROGRESS 2.11.7
myothercluster CREATE_IN_PROGRESS 2.11.7
```
# `pcluster ssh`
클러스터 사용자 이름과 IP 주소가 미리 채워진 상태로 `ssh` 명령을 실행합니다. 임의의 인수가 `ssh` 명령 끝에 추가됩니다. 이 명령은 구성 파일의 별칭 섹션에서 사용자 지정할 수 있습니다.
```
pcluster ssh [ -h ] [ -d ] [ -r REGION ] cluster_name
```
## 위치 인수
***cluster\$1name***
연결할 클러스터의 이름을 지정합니다.
## 이름 지정된 인수
**-h, --help**
`pcluster ssh`에 대한 도움말 텍스트를 표시합니다.
**-d, --dryrun**
실행할 명령을 인쇄하고 종료합니다.
기본값은 `False`입니다.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 지정된 리전이 기본값입니다.
** AWS ParallelCluster 버전 2.11.7을 사용하는 예:**
```
$ pcluster ssh -d mycluster -i ~/.ssh/id_rsa
SSH command: ssh ec2-user@1.1.1.1 -i /home/user/.ssh/id_rsa
```
```
$ pcluster ssh mycluster -i ~/.ssh/id_rsa
```
클러스터의 IP 주소와 사용자 이름이 미리 채워진 상태로 `ssh` 명령을 실행합니다.
```
ssh ec2-user@1.1.1.1 -i ~/.ssh/id_rsa
```
`ssh` 명령은 [`[aliases]` 섹션](aliases.md) 아래의 전역 구성 파일에서 정의되며 다음과 같이 사용자 지정할 수 있습니다.
```
[ aliases ]
ssh = ssh {CFN_USER}@{MASTER_IP} {ARGS}
```
대체된 변수:
`CFN_USER`
선택된 [`base_os`](cluster-definition.md#base-os)의 사용자 이름입니다.
`MASTER_IP`
헤드 노드의 IP 주소입니다.
`ARGS`
`ssh` 명령에 전달할 선택적 인수입니다.
# `pcluster start`
중지된 클러스터에 대한 컴퓨팅 플릿을 시작합니다.
```
pcluster start [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```
## 위치 인수
***cluster\$1name***
제공된 클러스터 이름의 컴퓨팅 플릿을 시작합니다.
## 이름 지정된 인수
**-h, --help**
`pcluster start`에 대한 도움말 텍스트를 표시합니다.
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
사용할 대체 구성 파일을 지정합니다.
기본값은 `~/.parallelcluster/config`입니다.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. 기본값은 [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 AWS 리전 지정된 입니다.
** AWS ParallelCluster 버전 2.11.7 사용 예제:**
```
$ pcluster start mycluster
Compute fleet status is: RUNNING. Submitting status change request.
Request submitted successfully. It might take a while for the transition to complete.
Please run 'pcluster status' if you need to check compute fleet status
```
이 명령은 Auto Scaling 그룹 파라미터를 다음 중 하나로 설정합니다.
+ 클러스터를 생성하는 데 사용된 템플릿의 초기 구성 값(`max_queue_size` 및 `initial_queue_size`)
+ 클러스터가 처음 생성된 이후에 클러스터를 업데이트하는 데 사용된 구성 값
# `pcluster status`
클러스터의 현재 상태를 풀합니다.
```
pcluster status [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name
```
## 위치 인수
**cluster\$1name**
제공된 이름이 있는 클러스터의 상태를 표시합니다.
## 이름 지정된 인수
**-h, --help**
`pcluster status`에 대한 도움말 텍스트를 표시합니다.
**-c *CONFIG\$1FILE*, `--config` *CONFIG\$1FILE***
사용할 대체 구성 파일을 지정합니다.
기본값은 `~/.parallelcluster/config`입니다.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. 기본값은 [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 AWS 리전 지정된 입니다.
**-nw, --nowait**
스택 명령을 처리한 후 스택 이벤트를 기다리지 않습니다.
기본값은 `False`입니다.
** AWS ParallelCluster 버전 2.11.7 사용 예제:**
```
$ pcluster status -c path/to/config -r us-east-1 mycluster
Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS
```
# `pcluster stop`
헤드 노드를 실행 중 상태로 두고 컴퓨팅 플릿을 중지합니다.
```
pcluster stop [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```
## 위치 인수
***cluster\$1name***
제공된 클러스터 이름의 컴퓨팅 플릿을 중지합니다.
** AWS ParallelCluster 버전 2.11.7 사용 예제:**
## 이름 지정된 인수
**-h, --help**
`pcluster stop`에 대한 도움말 텍스트를 표시합니다.
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
사용할 대체 구성 파일을 지정합니다.
기본값은 `~/.parallelcluster/config`입니다.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. 기본값은 [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 AWS 리전 지정된 입니다.
```
$ pcluster stop mycluster
Compute fleet status is: STOPPED. Submitting status change request.
Request submitted successfully. It might take a while for the transition to complete.
Please run 'pcluster status' if you need to check compute fleet status
```
Auto Scaling 그룹 파라미터를 최소/최대/원하는 값 = 0/0/0으로 설정하고 컴퓨팅 플릿을 종료합니다. 헤드는 계속 실행됩니다. 모든 EC2 리소스를 종료하고 EC2 요금을 방지하려면 클러스터를 삭제하는 것이 좋습니다.
# `pcluster update`
구성 파일을 분석하여 클러스터를 안전하게 업데이트할 수 있는지 확인합니다. 분석 결과 클러스터를 업데이트할 수 있는 것으로 확인되면 변경 사항을 확인하라는 메시지가 표시됩니다. 분석 결과 클러스터를 업데이트할 수 없는 것으로 나타나는 경우 충돌의 원인인 구성 설정이 세부 정보와 함께 열거됩니다. 자세한 내용은 [`pcluster update` 사용하기](using-pcluster-update.md) 단원을 참조하십시오.
```
pcluster update [ -h ] [ -c CONFIG_FILE ] [ --force ] [ -r REGION ] [ -nr ]
[ -nw ] [ -t CLUSTER_TEMPLATE ] [ -p EXTRA_PARAMETERS ] [ -rd ]
[ --yes ] cluster_name
```
## 위치 인수
***cluster\$1name***
업데이트할 클러스터의 이름을 지정합니다.
## 이름 지정된 인수
**-h, --help**
`pcluster update`에 대한 도움말 텍스트를 표시합니다.
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
사용할 대체 구성 파일을 지정합니다.
기본값은 `~/.parallelcluster/config`입니다.
**--force**
하나 이상의 설정에 차단 변경이 있거나 업데이트를 진행하기 전에 특별한 조치(예: 컴퓨팅 플릿 중지)가 필요한 경우에도 업데이트를 활성화합니다. 이것을 `--yes` 인수와 함께 사용해서는 안 됩니다.
**-r *REGION*, --region *REGION***
사용할 AWS 리전 를 지정합니다. 기본값은 [`pcluster configure`](pcluster.configure.md) 명령을 사용하여 AWS 리전 지정된 입니다.
**-nr, --norollback**
오류 발생 시 AWS CloudFormation 스택 롤백을 비활성화합니다.
기본값은 `False`입니다.
**-nw, --nowait**
스택 명령을 처리한 후 스택 이벤트를 기다리지 않습니다.
기본값은 `False`입니다.
**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***
사용할 클러스터 템플릿의 섹션을 지정합니다.
**-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS***
스택 업데이트에 파라미터를 추가합니다.
**-rd, --reset-desired**
Auto Scaling 그룹의 현재 용량을 초기 구성 값으로 재설정합니다.
기본값은 `False`입니다.
**--yes**
모든 질문 메시지에 대한 답은 자동적으로 예라고 가정합니다. 이것을 `--force` 인수와 함께 사용해서는 안 됩니다.
```
$ pcluster update -c path/to/config mycluster
Retrieving configuration from CloudFormation for cluster mycluster...
Validating configuration file .parallelcluster/config...
Found Configuration Changes:
# parameter old value new value
--- -------------------------- ----------- -----------
[compute_resource default]
01 min_count 1 2
02 max_count 5 12
Validating configuration update...
Congratulations! The new configuration can be safely applied to your cluster.
Do you want to proceed with the update? - Y/N: Y
Updating: mycluster
Calling update_stack
Status: parallelcluster-mycluster - UPDATE_COMPLETE
```
명령이 호출되고 해당 호출의 상태에 대한 폴링을 시작하면 안전하게 "Ctrl-C"를 사용하여 종료할 수 있습니다. `pcluster status mycluster`를 호출하여 현재 상태 보기로 돌아갈 수 있습니다.
# `pcluster version`
AWS ParallelCluster 버전을 표시합니다.
```
pcluster version [ -h ]
```
명령별 플래그를 보려면 `pcluster [command] –-help`를 실행하세요.
## 이름 지정된 인수
**-h, --help**
`pcluster version`에 대한 도움말 텍스트를 표시합니다.
명령이 호출되고 해당 호출의 상태에 대한 폴링을 시작하면 안전하게 "Ctrl-C"를 사용하여 종료할 수 있습니다. `pcluster status mycluster`를 호출하여 현재 상태 보기로 돌아갈 수 있습니다.
```
$ pcluster version
2.11.7
```