기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS ParallelCluster CLI 명령
`pcluster`는 기본 AWS ParallelCluster CLI 명령입니다. `pcluster`를 사용하여에서 HPC 클러스터를 시작 및 관리하고 AWS 클라우드 를 사용하여 사용자 지정 AMI 이미지를 생성하고 관리합니다.
`pcluster3-config-converter`는 버전 2 형식의 AWS ParallelCluster 클러스터 구성을 AWS ParallelCluster 버전 3 형식으로 변환하는 데 사용됩니다.
```
pcluster [-h] ( build-image | configure |
create-cluster | dcv-connect |
delete-cluster | delete-cluster-instances | delete-image |
describe-cluster | describe-cluster-instances |
describe-compute-fleet | describe-image |
export-cluster-logs | export-image-logs |
get-cluster-log-events | get-cluster-stack-events |
get-image-log-events | get-image-stack-events |
list-cluster-log-streams | list-clusters |
list-images | list-image-log-streams | list-official-images |
ssh | update-cluster |
update-compute-fleet | version ) ...
pcluster3-config-converter [-h] [-t CLUSTER_TEMPLATE]
[-c CONFIG_FILE]
[--force-convert]
[-o OUTPUT_FILE]
```
**Topics**
+ [`pcluster`](pcluster-v3.md)
+ [`pcluster3-config-converter`](pcluster3-config-converter.md)
# `pcluster`
`pcluster`는 기본 AWS ParallelCluster CLI 명령입니다. `pcluster`를 사용하여 AWS 클라우드에서 HPC 클러스터를 시작하고 관리할 수 있습니다.
`pcluster`은 명령 로그를 `/home/user/.parallelcluster/` 내의 `pcluster.log.#` 파일에 기록합니다. 자세한 내용은 [`pcluster` CLI 로그](troubleshooting-v3-pc-cli-logs.md) 항목을 참조하세요.
`pcluster`를 사용하려면 실행에 필요한 [권한](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-example-user-policies)이 있는 IAM 역할이 있어야 합니다.
```
pcluster [-h]
```
## 인수
**`pcluster command`**
가능한 선택: [`build-image`](pcluster.build-image-v3.md) \$1 [`configure`](pcluster.configure-v3.md) \$1 [`create-cluster`](pcluster.create-cluster-v3.md) \$1 [`dcv-connect`](pcluster.dcv-connect-v3.md) \$1 [`delete-cluster`](pcluster.delete-cluster-v3.md) \$1 \$1 [`delete-cluster-instances`](pcluster.delete-cluster-instances-v3.md) \$1 [`delete-image`](pcluster.delete-image-v3.md) \$1 [`describe-cluster`](pcluster.describe-cluster-v3.md) \$1 [`describe-cluster-instances`](pcluster.describe-cluster-instances-v3.md) \$1 [`describe-compute-fleet`](pcluster.describe-compute-fleet-v3.md) \$1 \$1 [`describe-image`](pcluster.describe-image-v3.md) \$1 [`export-cluster-logs`](pcluster.export-cluster-logs-v3.md) \$1 [`export-image-logs`](pcluster.export-image-logs-v3.md) \$1 [`get-cluster-log-events`](pcluster.get-cluster-log-events-v3.md) \$1 [`get-cluster-stack-events`](pcluster.get-cluster-stack-events-v3.md) \$1 \$1 [`get-image-log-events`](pcluster.get-image-log-events-v3.md) \$1 [`get-image-stack-events`](pcluster.get-image-stack-events-v3.md) \$1 [`list-clusters`](pcluster.list-clusters-v3.md) \$1 [`list-cluster-log-streams`](pcluster.list-cluster-log-streams-v3.md) \$1 \$1 \$1 \$1 [`list-images`](pcluster.list-images-v3.md) [`list-image-log-streams`](pcluster.list-image-log-streams-v3.md) [`list-official-images`](pcluster.list-official-images-v3.md) [`ssh`](pcluster.ssh-v3.md) [`update-cluster`](pcluster.update-cluster-v3.md) [`update-compute-fleet`](pcluster.update-compute-fleet-v3.md) [`version`](pcluster.version-v3.md)
**하위 명령:**
**Topics**
+ [인수](#pcluster.arguments-v3)
+ [`pcluster build-image`](pcluster.build-image-v3.md)
+ [`pcluster configure`](pcluster.configure-v3.md)
+ [`pcluster create-cluster`](pcluster.create-cluster-v3.md)
+ [`pcluster dcv-connect`](pcluster.dcv-connect-v3.md)
+ [`pcluster delete-cluster`](pcluster.delete-cluster-v3.md)
+ [`pcluster delete-cluster-instances`](pcluster.delete-cluster-instances-v3.md)
+ [`pcluster delete-image`](pcluster.delete-image-v3.md)
+ [`pcluster describe-cluster`](pcluster.describe-cluster-v3.md)
+ [`pcluster describe-cluster-instances`](pcluster.describe-cluster-instances-v3.md)
+ [`pcluster describe-compute-fleet`](pcluster.describe-compute-fleet-v3.md)
+ [`pcluster describe-image`](pcluster.describe-image-v3.md)
+ [`pcluster export-cluster-logs`](pcluster.export-cluster-logs-v3.md)
+ [`pcluster export-image-logs`](pcluster.export-image-logs-v3.md)
+ [`pcluster get-cluster-log-events`](pcluster.get-cluster-log-events-v3.md)
+ [`pcluster get-cluster-stack-events`](pcluster.get-cluster-stack-events-v3.md)
+ [`pcluster get-image-log-events`](pcluster.get-image-log-events-v3.md)
+ [`pcluster get-image-stack-events`](pcluster.get-image-stack-events-v3.md)
+ [`pcluster list-clusters`](pcluster.list-clusters-v3.md)
+ [`pcluster list-cluster-log-streams`](pcluster.list-cluster-log-streams-v3.md)
+ [`pcluster list-images`](pcluster.list-images-v3.md)
+ [`pcluster list-image-log-streams`](pcluster.list-image-log-streams-v3.md)
+ [`pcluster list-official-images`](pcluster.list-official-images-v3.md)
+ [`pcluster ssh`](pcluster.ssh-v3.md)
+ [`pcluster update-cluster`](pcluster.update-cluster-v3.md)
+ [`pcluster update-compute-fleet`](pcluster.update-compute-fleet-v3.md)
+ [`pcluster version`](pcluster.version-v3.md)
# `pcluster build-image`
지정된 리전에서 사용자 지정 AWS ParallelCluster 이미지를 생성합니다.
```
pcluster build-image [-h]
--image-configuration IMAGE_CONFIGURATION
--image-id IMAGE_ID
[--debug]
[--dryrun DRYRUN]
[--query QUERY]
[--region REGION]
[--rollback-on-failure ROLLBACK_ON_FAILURE]
[--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
[--validation-failure-level {INFO,WARNING,ERROR}]
```
## 이름 지정된 인수
**-h, --help**
`pcluster build-image`에 대한 도움말 텍스트를 표시합니다.
**--image-configuration, -c *IMAGE\$1CONFIGURATION***
이미지 구성 파일을 YAML 문서로 지정합니다.
**--image-id, -i *IMAGE\$1ID***
빌드될 이미지의 ID를 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--dryrun *DRYRUN***
`true`면 명령이 리소스를 만들지 않고 유효성 검사를 수행합니다. 이를 사용하여 이미지 구성을 검증할 수 있습니다. (`false`로 디폴트됩니다.)
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리입니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. 이미지 구성 파일의 [리전](image-builder-configuration-file-v3.md#yaml-build-image-Region) 설정, `AWS_DEFAULT_REGION` 환경 변수, 파일 `[default]` 섹션의 `region` 설정 `~/.aws/config` 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***
`true`인 경우 실패 시 이미지 스택 롤백이 자동으로 시작됩니다. (기본값은 `false`입니다.)
**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**
억제할 구성 유효성 검사기를 하나 이상 식별하세요.
형식: (`ALL`\$1`type:[A-Za-z0-9]+`)
**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**
생성 실패의 원인이 되는 최소 유효성 검사 수준을 지정합니다. (`ERROR`로 디폴트됩니다.)
** AWS ParallelCluster 버전 3.1.2 사용 예제:**
```
$ pcluster build-image --image-configuration image-config.yaml --image-id custom-alinux2-image
{
"image": {
"imageId": "custom-alinux2-image",
"imageBuildStatus": "BUILD_IN_PROGRESS",
"cloudformationStackStatus": "CREATE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-alinux2-image/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.2"
}
}
```
**주의**
`pcluster build-image`는 기본 VPC를 사용합니다. AWS Control Tower 또는 AWS 랜딩 영역을 사용하여 기본 VPC를 삭제한 경우 이미지 구성 파일에 서브넷 ID를 지정해야 합니다. 자세한 내용은 [SubNetID](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId)를 참조하세요.
# `pcluster configure`
AWS ParallelCluster 버전 3에 대한 대화형 구성 마법사를 시작합니다. 자세한 내용은 [AWS ParallelCluster 명령줄 인터페이스를 사용하여 클러스터 구성 및 생성](install-v3-configuring.md) 단원을 참조하십시오.
```
pcluster configure [-h]
--config CONFIG
[--debug]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster configure`에 대한 도움말 텍스트를 표시합니다.
**--config *CONFIG***
생성된 구성 파일을 출력할 경로입니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. 이미지 구성 파일의 [리전](image-builder-configuration-file-v3.md#yaml-build-image-Region) 설정, `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여 리전을 지정해야 합니다.
# `pcluster create-cluster`
AWS ParallelCluster 클러스터를 생성합니다.
```
pcluster create-cluster [-h]
--cluster-configuration CLUSTER_CONFIGURATION
--cluster-name CLUSTER_NAME
[--debug]
[--dryrun DRYRUN]
[--query QUERY]
[--region REGION]
[--rollback-on-failure ROLLBACK_ON_FAILURE]
[--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
[--validation-failure-level {INFO,WARNING,ERROR}]
```
## 이름 지정된 인수
**-h, --help**
`pcluster create-cluster`에 대한 도움말 텍스트를 표시합니다.
**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***
YAML 클러스터 구성 파일을 지정합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
생성될 클러스터의 이름을 지정합니다.
이름은 영문자로 시작해야 합니다. 계획 이름은 최대 60자까지 가능합니다. Slurm 회계가 활성화된 경우 이름은 최대 40자까지 사용할 수 있습니다.
유효한 문자는 A-Z, a-z, 0-9 및 -(하이픈)입니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--dryrun *DRYRUN***
`true`면 명령이 리소스를 만들지 않고 유효성 검사를 수행합니다. 이를 사용하여 클러스터 구성을 검증할 수 있습니다. (`false`로 디폴트됩니다.)
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. 클러스터 구성 파일의 [`Region`](cluster-configuration-file-v3.md#yaml-Region) 설정, `AWS_DEFAULT_REGION` 환경 변수, 파일 `[default]` 섹션의 `region` 설정 `~/.aws/config` 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***
`true`인 경우, 실패 시 클러스터 스택 롤백을 자동으로 시작합니다. (`true`로 디폴트됩니다.)
**--suppress-validators *SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS* ...]**
억제할 구성 유효성 검사기를 하나 이상 식별하세요.
형식: (`ALL`\$1유형:`[A-Za-z0-9]+`)
**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**
생성 실패의 원인이 되는 최소 유효성 검사 수준을 지정합니다. (`ERROR`로 디폴트됩니다.)
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster create-cluster -c cluster-config.yaml -n cluster-v3
{
"cluster": {
"clusterName": "cluster-v3",
"cloudformationStackStatus": "CREATE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "CREATE_IN_PROGRESS"
}
}
```
# `pcluster dcv-connect`
Amazon DCV를 사용하여 대화형 세션을 통해 헤드 노드에 연결할 수 있습니다.
```
pcluster dcv-connect [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--key-path KEY_PATH]
[--login-node-ip LOGIN_NODE_IP]
[--region REGION]
[--show-url]
```
## 이름 지정된 인수
**-h, --help**
`pcluster dcv-connect`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--key-path *KEY\$1PATH***
연결에 사용할 SSH 키의 경로입니다.
**--login-node-ip**
클러스터에 있는 로그인 노드의 퍼블릭 또는 프라이빗 IP 주소를 지정합니다. 이 인수를 사용하면 DCV가 활성화된 클러스터의 로그인 노드에 연결할 수 있습니다.
이 인수는 AWS ParallelCluster 버전 3.11.0에 추가되었습니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
**--show-url**
DCV 연결에 사용할 URL을 인쇄하고 종료합니다.
** AWS ParallelCluster 버전 3.11 사용 예제**
```
$ pcluster dcv-connect -n cluster-3Dcv --login-node-ip 198.51.100.44 -r us-east-1 --key-path /home/user/.ssh/key.pem
```
![\[A screenshot of the DCV console.\]](http://docs.aws.amazon.com/ko_kr/parallelcluster/latest/ug/images/Dcv-image.png)
# `pcluster delete-cluster`
클러스터 삭제를 시작합니다.
```
pcluster delete-cluster [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster delete-cluster`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. 리전은 `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여 지정해야 합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster delete-cluster -n cluster-v3
{
"cluster": {
"clusterName": "cluster-v3",
"cloudformationStackStatus": "DELETE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "DELETE_IN_PROGRESS"
}
}
```
# `pcluster delete-cluster-instances`
모든 클러스터 컴퓨팅 노드의 강제 종료를 시작합니다. AWS Batch 클러스터에서는 작동하지 않습니다.
```
pcluster delete-cluster-instances [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--force FORCE]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster delete-cluster-instances`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--force *FORCE***
`true`면 유효성 검사 오류를 무시하여 강제로 삭제합니다. (`false`로 디폴트됩니다.)
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
```
$ pcluster delete-cluster-instances -n cluster-v3
```
# `pcluster delete-image`
사용자 지정 AWS ParallelCluster 이미지 삭제를 시작합니다.
```
pcluster delete-image [-h]
--image-id IMAGE_ID
[--debug]
[--force FORCE]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster delete-image`에 대한 도움말 텍스트를 표시합니다.
**--image-id, -i *IMAGE\$1ID***
삭제될 이미지의 ID를 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--force *FORCE***
`true`면 AMI를 사용하는 인스턴스가 있거나 AMI를 공유하는 경우 강제로 삭제합니다. (`false`로 디폴트됩니다.)
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster delete-image --image-id custom-alinux2-image
{
"image": {
"imageId": "custom-alinux2-image",
"imageBuildStatus": "DELETE_IN_PROGRESS",
"region": "us-east-1",
"version": "3.1.4"
}
}
```
# `pcluster describe-cluster`
클러스터에 관한 자세한 정보를 가져옵니다.
```
pcluster describe-cluster [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster describe-cluster`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.4를 사용하는 예:**
클러스터 세부 정보 설명:
```
$ pcluster describe-cluster -n cluster-v3
{
"creationTime": "2022-07-12T17:19:16.101Z",
"headNode": {
"launchTime": "2022-07-12T17:22:21.000Z",
"instanceId": "i-1234567890abcdef0",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "running",
"privateIpAddress": "192.0.2.0.196"
},
"loginNodes": [
{
"status": "active",
"poolName": "pool1",
"address": "cluster-v3-eMr9BYRKZVDa-e5bb34f40b24f51d.elb.us-east-1.amazonaws.com",
"scheme": "internet-facing",
"healthyNodes": 1,
"unhealthyNodes": 0
},
{
"status": "active",
"poolName": "pool2",
"address": "cluster-v3-PaQ7GgC27sic-aba10c890247b36b.elb.us-east-1.amazonaws.com",
"scheme": "internet-facing",
"healthyNodes": 1,
"unhealthyNodes": 0
}
],
"version": "3.1.4",
"clusterConfiguration": {
"url": "https://parallelcluster-e5ca74255d6c3886-v1-do-not-delete..."
},
"tags": [
{
"value": "3.11",
"key": "parallelcluster:version"
}
],
"cloudFormationStackStatus": "CREATE_COMPLETE",
"clusterName": "cluster-v3",
"computeFleetStatus": "RUNNING",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"lastUpdatedTime": "2022-07-12T17:19:16.101Z",
"region": "us-east-1",
"clusterStatus": "CREATE_COMPLETE"
}
```
`describe-cluster`를 사용하여 클러스터 구성을 검색합니다.
```
$ curl -o - $(pcluster describe-cluster -n cluster-v3 --query clusterConfiguration.url | xargs echo)
Region: us-east-1
Image:
Os: alinux2
HeadNode:
InstanceType: t2.micro
Networking:
SubnetId: subnet-abcdef01234567890
Ssh:
KeyName: adpc
Iam:
S3Access:
- BucketName: cluster-v3-bucket
KeyName: logs
EnableWriteAccess: true
Scheduling:
Scheduler: slurm
SlurmQueues:
- Name: queue1
ComputeResources:
- Name: t2micro
InstanceType: t2.micro
MinCount: 0
MaxCount: 10
Networking:
SubnetIds:
- subnet-021345abcdef6789
```
# `pcluster describe-cluster-instances`
클러스터의 인스턴스를 설명하세요.
```
pcluster describe-cluster-instances [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--next-token NEXT_TOKEN]
[--node-type {HeadNode,ComputeNode,LoginNode}]
[--query QUERY]
[--queue-name QUEUE_NAME]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster describe-cluster-instances`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--next-token *NEXT\$1TOKEN***
다음 결과 집합에 대한 토큰입니다.
**--node-type \$1`HeadNode`,`ComputeNode`,`LoginNode`\$1**
나열할 노드 유형을 지정합니다. 지원되는 값은 `HeadNode`, `ComputeNode` 및 `LoginNode`입니다. 이 파라미터를 지정하지 않으면 `HeadNode`, `ComputeNode` 및 `LoginNode` 인스턴스가 설명됩니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--queue-name *QUEUE\$1NAME***
나열할 대기열의 이름을 지정합니다. 이 파라미터를 지정하지 않으면 모든 대기열의 인스턴스가 설명됩니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster describe-cluster-instances -n cluster-v3
{
"instances": [
{
"launchTime": "2022-07-12T17:22:21.000Z",
"instanceId": "i-1234567890abcdef0",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "running",
"nodeType": "HeadNode",
"privateIpAddress": "192.0.2.0.196"
},
{
"launchTime": "2022-07-12T17:37:42.000Z",
"instanceId": "i-021345abcdef6789",
"queueName": "queue1",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "pending",
"nodeType": "ComputeNode",
"privateIpAddress": "192.0.2.0.196"
},
{
"launchTime": "2022-07-12T17:37:42.000Z",
"instanceId": "i-021345abcdef6789",
"poolName": "pool1",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "pending",
"nodeType": "loginNode",
"privateIpAddress": "192.0.2.0.196"
}
]
}
```
# `pcluster describe-compute-fleet`
컴퓨팅 플릿의 상태를 설명합니다.
```
pcluster describe-compute-fleet [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster describe-compute-fleet`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster describe-compute-fleet -n pcluster-v3
{
"status": "RUNNING",
"lastStatusUpdatedTime": "2022-07-12T17:24:26.000Z"
}
```
# `pcluster describe-image`
이미지에 대한 세부 정보를 가져옵니다.
```
pcluster describe-image [-h]
--image-id IMAGE_ID
[--debug]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster describe-image`에 대한 도움말 텍스트를 표시합니다.
**--image-id, -i *IMAGE\$1ID***
이미지의 ID를 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.2 사용 예제:**
```
$ pcluster describe-image --image-id custom-alinux2-image
{
"imageConfiguration: {
"url": "https://parallelcluster-1234abcd5678-v1-do-not-delete.../configs/image-config.yaml"
},
"imageId": "custom-alinux2-image",
"creationTime": "2022-04-05T20:23:07.000Z"
"imageBuildStatus": "BUILD_COMPLETE",
"region": "us-east-1",
"ec2AmiInfo": {
"amiName": "custom-alinux2-image 2022-04-05T19-55-22.518Z",
"amiId": "ami-1234abcd5678efgh",
"description": "AWS ParallelCluster AMI for alinux2, kernel-4.14.268-205.500.amzn2.x86_64, lustre-2.10.8-5.amzn2.x86_64, efa-1.14.2-1.amzn2.x86_64, dcv-2021.3.11591-1.el7.x86_64, slurm-21-08-6-1",
"state": "AVAILABLE",
"tags": [
{
"value": "arn:aws:imagebuilder:us-east-1:123456789012:image/parallelclusterimage-custom-alinux2-image/3.1.2/1",
"key": "Ec2ImageBuilderArn"
},
{
"value": "parallelcluster-1234abcd5678efgh-v1-do-not-delete",
"key": "parallelcluster:amzn-s3-demo-bucket"
},
{
"value": "custom-alinux2-image",
"key": "parallelcluster:image_name"
},
{
"value": "available",
"key": "parallelcluster:build_status"
},
{
"value": "s3://amzn-s3-demo-bucket/parallelcluster/3.1.2/images/custom-alinux2-image-1234abcd5678efgh/configs/image-config.yaml",
"key": "parallelcluster:build_config"
},
{
"value": "Amazon EC2 Image Builder",
"key": "CreatedBy"
},
{
"value": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/imagebuilder/ParallelClusterImage-custom-alinux2-image",
"key": "parallelcluster:build_log"
},
{
"value": "4.14.268-205.500.amzn2.x86_64",
"key": "parallelcluster:kernel_version"
},
{
"value": "arn:aws:imagebuilder:us-east-1:444455556666:image/amazon-linux-2-x86/2022.3.16/1",
"key": "parallelcluster:parent_image"
},
{
"value": "3.1.2",
"key": "parallelcluster:version"
},
{
"value": "0.5.14",
"key": "parallelcluster:munge_version"
},
{
"value": "21-08-6-1",
"key": "parallelcluster:slurm_version"
},
{
"value": "2021.3.11591-1.el7.x86_64",
"key": "parallelcluster:dcv_version"
},
{
"value": "alinux2-image",
"key": "parallelcluster:image_id"
},
{
"value": "3.2.3",
"key": "parallelcluster:pmix_version"
},
{
"value": "parallelcluster/3.15.0/images/alinux2-image-abcd1234efgh56781234",
"key": "parallelcluster:s3_image_dir"
},
{
"value": "1.14.2-1.amzn2.x86_64",
"key": "parallelcluster:efa_version"
},
{
"value": "alinux2",
"key": "parallelcluster:os"
},
{
"value": "aws-parallelcluster-cookbook-3.1.2",
"key": "parallelcluster:bootstrap_file"
},
{
"value": "1.8.23-10.amzn2.1.x86_64",
"key": "parallelcluster:sudo_version"
},
{
"value": "2.10.8-5.amzn2.x86_64",
"key": "parallelcluster:lustre_version"
}
],
"architecture": "x86_64"
},
"version": "3.1.2"
}
```
# `pcluster export-cluster-logs`
Amazon S3 버킷을 통과하여 클러스터의 로그를 로컬 `tar.gz` 아카이브로 내보냅니다.
```
pcluster export-cluster-logs [-h]
--cluster-name CLUSTER_NAME
[--bucket BUCKET_NAME]
[--bucket-prefix BUCKET_PREFIX]
[--debug]
[--end-time END_TIME]
[--filters FILTER [FILTER ...]]
[--keep-s3-objects KEEP_S3_OBJECTS]
[--output-file OUTPUT_FILE]
[--region REGION]
[--start-time START_TIME]
```
**참고**
`export-cluster-logs` 명령은 CloudWatch Logs가 로그 내보내기를 완료할 때까지 대기하므로 출력 없이 일정 시간이 걸릴 것으로 예상됩니다.
## 이름 지정된 인수
**-h, --help**
`pcluster export-cluster-logs`에 대한 도움말 텍스트를 표시합니다.
**--bucket *BUCKET\$1NAME***
클러스터 로그 데이터를 내보낼 Amazon S3 버킷의 이름을 지정합니다. 그것은 클러스터와 같은 리전에 있어야 합니다.
+ CloudWatch 액세스 권한을 부여하려면 Amazon S3 버킷 정책에 권한을 추가해야 합니다. 자세한 내용은 CloudWatch Logs 사용 설명서의 [ Amazon S3 버킷에 대한 권한 설정을](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) 참조하세요. *CloudWatch *
+ AWS ParallelCluster 버전 **3.12.0**부터 `--bucket` 옵션은 **선택 사항**입니다. 옵션을 지정 AWS ParallelCluster 하지 않으면 리전 기본 버킷(`parallelcluster-hash-v1-DO-NOT-DELETE`)이 사용되거나 클러스터 구성에가 가리키는 Amazon S3 버킷`CustomS3Bucket`이 지정되어 사용됩니다. `--bucket` 옵션을 지정하지 않고 기본 AWS ParallelCluster 버킷을 사용하는 경우 로그는 내부용으로 예약된 보호`parallelcluster/`된 폴더이므로 폴더로 내보낼 수 없습니다.
AWS ParallelCluster 기본 버킷을 사용하는 경우 pcluster가 버킷 정책을 구성합니다. 버킷 정책을 사용자 지정한 다음 버전 **3.12.0**으로 AWS ParallelCluster 업그레이드하면 버킷 정책이 재정의되므로 변경 사항을 다시 적용해야 합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--bucket-prefix *BUCKET\$1PREFIX***
내보낸 로그 데이터가 저장되는 Amazon S3 버킷의 경로를 지정합니다.
기본적으로 버킷 접두사는 다음과 같습니다.
```
cluster-name-logs-202209061743.tar.gz
```
`202209061743`는 `%Y%m%d%H%M` 형식의 시간 예제입니다.
AWS ParallelCluster 버전 **3.12.0**부터는 `--bucket` 옵션을 지정하지 않고 기본 AWS ParallelCluster 버킷을 사용하는 경우 내부용으로 예약된 보호`parallelcluster/`된 폴더이므로 폴더로 로그를 내보낼 수 없습니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--end-time *END\$1TIME***
로그 이벤트를 수집할 시간 범위의 끝을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`‘)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트는 포함되지 않습니다. 시간 요소(예: 분 및 초)는 생략될 수 있습니다. 기본값은 현재 시간입니다.
**--filters *FILTER* [*FILTER* ...]**
로그의 필터를 지정합니다. 형식: `Name=a,Values=1 Name=b,Values=2,3` 지원되는 필터는 다음과 같습니다.
`private-dns-name`
인스턴스의 프라이빗 DNS 이름의 약식을 지정합니다(예:`ip-10-0-0-101`).
`node-type`
노드 유형을 지정합니다. 이 필터에 허용되는 유일한 값은 `HeadNode`입니다.
**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***
`true`면 내보낸 객체를 아마존 S3로 내보낸 것을 보관합니다. (`false`로 디폴트됩니다.)
**--output-file *OUTPUT\$1FILE***
로그 아카이브를 저장할 파일 경로를 지정합니다. 이 정보가 제공되면 로그가 로컬에 저장됩니다. 그렇지 않으면 출력에 반환된 URL과 함께 Amazon S3에 업로드됩니다. Amazon S3로 업로드하는 것이 기본값입니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
**--start-time *START\$1TIME***
시간 범위의 시작을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 로그 이벤트가 포함됩니다. 지정하지 않을 경우 기본값은 클러스터가 생성된 시간입니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster export-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
"url": "https://cluster-v3-bucket..."
}
```
## 로그를 검색할 수 없습니까?
`export-cluster-logs` 명령을 사용하여 로그를 검색할 수 없는 경우 다음 중 하나를 수행합니다.
+ 클러스터의 CloudWatch 로그 그룹에서 로그를 수동으로 검색합니다.
+ 로그 그룹이 비어 있는 경우 클러스터 노드에 SSH를 넣고에 나열된 로그를 검색합니다[노드 초기화 문제 해결](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-node-init).
+ 클러스터가 생성되지 않아 클러스터 노드에 액세스할 수 없는 경우 옵션으로 클러스터를 다시 생성하고 노드에서 로그를 `--rollback-on-failure false` 검색합니다.
# `pcluster export-image-logs`
Amazon S3 버킷을 통과하여 이미지 빌더 스택의 로그를 로컬 `tar.gz` 아카이브로 내보냅니다.
```
pcluster export-image-logs [-h]
--image-id IMAGE_ID
[--bucket BUCKET]
[--bucket-prefix BUCKET_PREFIX]
[--debug]
[--end-time END_TIME]
[--keep-s3-objects KEEP_S3_OBJECTS]
[--output-file OUTPUT_FILE]
[--region REGION]
[--start-time START_TIME]
```
**참고**
`export-image-logs` 명령은 CloudWatch Logs가 로그 내보내기를 완료할 때까지 대기하므로 출력 없이 일정 시간이 걸릴 것으로 예상됩니다.
## 이름 지정된 인수
**-h, --help**
`pcluster export-image-logs`에 대한 도움말 텍스트를 표시합니다.
**--bucket *BUCKET\$1NAME***
이미지 빌드 로그를 내보낼 Amazon S3 버킷 이름을 지정합니다. 그것은 이미지와 같은 리전에 있어야 합니다.
+ CloudWatch 액세스 권한을 부여하려면 Amazon S3 버킷 정책에 권한을 추가해야 합니다. 자세한 내용은 CloudWatch Logs 사용 설명서의 [ Amazon S3 버킷에 대한 권한 설정을](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) 참조하세요. *CloudWatch *
+ AWS ParallelCluster 버전 **3.12.0**부터 `--bucket` 옵션은 **선택 사항**입니다. 옵션을 지정하지 않으면 리전 기본 버킷(`parallelcluster-hash-v1-DO-NOT-DELETE`)이 AWS ParallelCluster 사용되거나 `CustomS3Bucket`가 이미지 구성에 지정된 경우 해당 버킷이 사용됩니다.
AWS ParallelCluster 기본 버킷을 사용하는 경우 pcluster가 버킷 정책을 구성합니다. AWS ParallelCluster 버전 **3.12.0**으로 업그레이드하기 전에 버킷 정책을 사용자 지정하면 버킷 정책이 재정의되므로 변경 사항을 다시 적용해야 합니다.
**--image-id, -i *IMAGE\$1ID***
로그를 내보낼 이미지 ID입니다.
**--bucket-prefix *BUCKET\$1PREFIX***
내보낸 로그 데이터가 저장되는 Amazon S3 버킷의 경로를 지정합니다.
기본적으로 버킷 접두사는 다음과 같습니다.
```
ami-id-logs-202209061743.tar.gz
```
`202209061743`는 현재 시간을 `%Y%m%d%H%M` 형식으로 나타낸 것입니다.
AWS ParallelCluster 버전 **3.12.0**부터는 `--bucket` 옵션을 지정하지 않고 기본 AWS ParallelCluster 버킷을 사용하는 경우 내부용으로 예약된 보호`parallelcluster/`된 폴더이므로 폴더로 로그를 내보낼 수 없습니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--end-time *END\$1TIME***
로그 이벤트를 수집할 시간 범위의 끝을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`‘)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트는 포함되지 않습니다. 시간 요소(예: 분 및 초)는 생략될 수 있습니다. 기본값은 현재 시간입니다.
**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***
`true`면 내보낸 객체를 아마존 S3로 내보낸 것을 보관합니다. (`false`로 디폴트됩니다.)
**--output-file *OUTPUT\$1FILE***
로그 아카이브를 저장할 파일 경로를 지정합니다. 이 정보가 제공되면 로그가 로컬에 저장됩니다. 그렇지 않으면 출력에 반환된 URL과 함께 Amazon S3에 업로드됩니다. Amazon S3로 업로드하는 것이 기본값입니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
**--start-time *START\$1TIME***
시간 범위의 시작을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 로그 이벤트가 포함됩니다. 지정하지 않을 경우 기본값은 클러스터가 생성된 시간입니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster export-image-logs --bucket image-v3-bucket --image-id ami-1234abcd5678efgh
{
"url": "https://image-v3-bucket..."
}
```
# `pcluster get-cluster-log-events`
로그 스트림과 관련된 이벤트를 검색합니다.
```
pcluster get-cluster-log-events [-h]
--cluster-name CLUSTER_NAME
--log-stream-name LOG_STREAM_NAME
[--debug]
[--end-time END_TIME]
[--limit LIMIT]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
[--start-from-head START_FROM_HEAD]
[--start-time START_TIME]
```
## 이름 지정된 인수
**-h, --help**
`pcluster get-cluster-log-events`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--log-stream-name *LOG\$1STREAM\$1NAME***
로그 스트림의 이름을 지정합니다. `list-cluster-log-streams` 명령을 사용하여 이벤트 또는 이벤트와 관련된 로그 스트림을 검색할 수 있습니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--end-time *END\$1TIME***
시간 범위의 끝을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트는 포함되지 않습니다.
**--limit *LIMIT***
반환된 로그 이벤트의 최대 수를 지정합니다. 값이 지정되지 않는 경우 최대값은 1MB의 응답 크기에 들어갈 수 있는 로그 이벤트 수(최대 10,000개의 로그 이벤트)입니다.
**--next-token *NEXT\$1TOKEN***
다음 결과 집합에 대한 토큰입니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
**--start-from-head *START\$1FROM\$1HEAD***
값이 `true`인 경우 가장 이른 로그 이벤트가 먼저 반환됩니다. 값이 `false`인 경우 가장 최근의 로그 이벤트가 먼저 반환됩니다. (`false`로 디폴트됩니다.)
**--start-time *START\$1TIME***
시간 범위의 시작을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트가 포함됩니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster get-cluster-log-events \
-c cluster-v3 \
-r us-east-1 \
--log-stream-name ip-198-51-100-44.i-1234567890abcdef0.clustermgtd \
--limit 3
{
"nextToken": "f/36966906399261933213029082268132291405859205452101451780/s",
"prevToken": "b/36966906399239632467830551644990755687586557090595471362/s",
"events": [
{
"message": "2022-07-12 19:16:53,379 - [slurm_plugin.clustermgtd:_maintain_nodes] - INFO - Performing node maintenance actions",
"timestamp": "2022-07-12T19:16:53.379Z"
},
{
"message": "2022-07-12 19:16:53,380 - [slurm_plugin.clustermgtd:_maintain_nodes] - INFO - Following nodes are currently in replacement: (x0) []",
"timestamp": "2022-07-12T19:16:53.380Z"
},
{
"message": "2022-07-12 19:16:53,380 - [slurm_plugin.clustermgtd:_terminate_orphaned_instances] - INFO - Checking for orphaned instance",
"timestamp": "2022-07-12T19:16:53.380Z"
}
]
}
```
# `pcluster get-cluster-stack-events`
지정된 클러스터의 스택과 관련된 이벤트를 검색합니다.
**참고**
버전 3.6.0부터는 중첩 스택을 AWS ParallelCluster 사용하여 대기열 및 컴퓨팅 리소스와 연결된 리소스를 생성합니다. `GetClusterStackEvents` API와 `pcluster get-cluster-stack-events` 명령은 클러스터 메인 스택 이벤트만 반환합니다. CloudFormation 콘솔에서 대기열 및 컴퓨팅 리소스와 관련된 이벤트를 비롯한 클러스터 스택 이벤트를 볼 수 있습니다.
```
pcluster get-cluster-stack-events [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster get-cluster-stack-events`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--next-token *NEXT\$1TOKEN***
다음 결과 집합에 대한 토큰입니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster get-cluster-stack-events \
-n cluster-v3 \
-r us-east-1 \
--query "events[0]"
{
"eventId": "1234abcd-56ef-78gh-90ij-abcd1234efgh",
"physicalResourceId": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"resourceStatus": "CREATE_COMPLETE",
"stackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"stackName": "cluster-v3",
"logicalResourceId": "cluster-v3",
"resourceType": "AWS::CloudFormation::Stack",
"timestamp": "2022-07-12T18:29:12.140Z"
}
```
# `pcluster get-image-log-events`
이미지 빌드와 연결된 로그 이벤트를 검색합니다.
```
pcluster get-image-log-events [-h]
--image-id IMAGE_ID
--log-stream-name LOG_STREAM_NAME
[--debug]
[--end-time END_TIME]
[--limit LIMIT]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
[--start-from-head START_FROM_HEAD]
[--start-time START_TIME]
```
## 이름 지정된 인수
**-h, --help**
`pcluster get-image-log-events`에 대한 도움말 텍스트를 표시합니다.
**--image-id, -i *IMAGE\$1ID***
이미지의 ID를 지정합니다.
**--log-stream-name *LOG\$1STREAM\$1NAME***
로그 스트림의 이름을 지정합니다. `list-image-log-streams` 명령을 사용하여 이벤트 또는 이벤트와 관련된 로그 스트림을 검색할 수 있습니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--end-time *END\$1TIME***
시간 범위의 끝을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트는 포함되지 않습니다.
**--limit *LIMIT***
반환된 로그 이벤트의 최대 수를 지정합니다. 값이 지정되지 않는 경우 최대값은 1MB의 응답 크기에 들어갈 수 있는 로그 이벤트 수(최대 10,000개의 로그 이벤트)입니다.
**--next-token *NEXT\$1TOKEN***
다음 결과 집합에 대한 토큰입니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
**--start-from-head *START\$1FROM\$1HEAD***
값이 `true`인 경우 가장 이른 로그 이벤트가 먼저 반환됩니다. 값이 `false`인 경우 가장 최근의 로그 이벤트가 먼저 반환됩니다. (`false`로 디폴트됩니다.)
**--start-time *START\$1TIME***
시간 범위의 시작을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트가 포함됩니다.
** AWS ParallelCluster 버전 3.1.2 사용 예제:**
```
$ pcluster get-image-log-events --image-id custom-alinux2-image --region us-east-1 --log-stream-name 3.1.2/1 --limit 3
{
"nextToken": "f/36778317771100849897800729464621464113270312017760944178/s",
"prevToken": "b/36778317766952911290874033560295820514557716777648586800/s",
"events": [
{
"message": "ExecuteBash: FINISHED EXECUTION",
"timestamp": "2022-04-05T22:13:26.633Z"
},
{
"message": "Document arn:aws:imagebuilder:us-east-1:123456789012:component/parallelclusterimage-test-1234abcd-56ef-78gh-90ij-abcd1234efgh/3.1.2/1",
"timestamp": "2022-04-05T22:13:26.741Z"
},
{
"message": "TOE has completed execution successfully",
"timestamp": "2022-04-05T22:13:26.819Z"
}
]
}
```
# `pcluster get-image-stack-events`
지정된 이미지 빌드의 스택과 관련된 이벤트를 검색합니다.
```
pcluster get-image-stack-events [-h]
--image-id IMAGE_ID
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster get-image-stack-events`에 대한 도움말 텍스트를 표시합니다.
**--image-id, -i *IMAGE\$1ID***
이미지의 ID를 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--next-token *NEXT\$1TOKEN***
다음 결과 집합에 대한 토큰입니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.2 사용 예제:**
```
$ pcluster get-image-stack-events --image-id custom-alinux2-image --region us-east-1 --query "events[0]"
{
"eventId": "ParallelClusterImage-CREATE_IN_PROGRESS-2022-04-05T21:39:24.725Z",
"physicalResourceId": "arn:aws:imagebuilder:us-east-1:123456789012:image/parallelclusterimage-custom-alinux2-image/3.1.2/1",
"resourceStatus": "CREATE_IN_PROGRESS",
"resourceStatusReason": "Resource creation Initiated",
"resourceProperties": "{\"InfrastructureConfigurationArn\":\"arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/parallelclusterimage-1234abcd-56ef-78gh-90ij-abcd1234efgh\",\"ImageRecipeArn\":\"arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/parallelclusterimage-custom-alinux2-image/3.1.2\",\"DistributionConfigurationArn\":\"arn:aws:imagebuilder:us-east-1:123456789012:distribution-configuration/parallelclusterimage-1234abcd-56ef-78gh-90ij-abcd1234efgh\",\"EnhancedImageMetadataEnabled\":\"false\",\"Tags\":{\"parallelcluster:image_name\":\"custom-alinux2-image\",\"parallelcluster:image_id\":\"custom-alinux2-image\"}}",
"stackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-alinux2-image/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"stackName": "custom-alinux2-image",
"logicalResourceId": "ParallelClusterImage",
"resourceType": "AWS::ImageBuilder::Image",
"timestamp": "2022-04-05T21:39:24.725Z"
}
```
# `pcluster list-clusters`
기존 클러스터의 목록을 가져옵니다.
```
pcluster list-clusters [-h]
[--cluster-status {CREATE_IN_PROGRESS,CREATE_FAILED,CREATE_COMPLETE,
DELETE_IN_PROGRESS,DELETE_FAILED,UPDATE_IN_PROGRESS,
UPDATE_COMPLETE,UPDATE_FAILED}
[{CREATE_IN_PROGRESS,CREATE_FAILED,CREATE_COMPLETE,
DELETE_IN_PROGRESS,DELETE_FAILED,UPDATE_IN_PROGRESS,
UPDATE_COMPLETE,UPDATE_FAILED} ...]]
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster list-clusters`에 대한 도움말 텍스트를 표시합니다.
**--cluster-status \$1`CREATE_IN_PROGRESS`, `CREATE_FAILED`, `CREATE_COMPLETE`, `DELETE_IN_PROGRESS`, `DELETE_FAILED`, `UPDATE_IN_PROGRESS`, `UPDATE_COMPLETE`, `UPDATE_FAILED`\$1 [\$1`CREATE_IN_PROGRESS`, `CREATE_FAILED`, `CREATE_COMPLETE`, `DELETE_IN_PROGRESS`, `DELETE_FAILED`, `UPDATE_IN_PROGRESS`, `UPDATE_COMPLETE`, `UPDATE_FAILED`\$1 ...]**
필터링할 클러스터 상태 목록을 지정합니다. (`all`로 디폴트됩니다.)
**--debug**
디버깅 로깅을 활성화합니다.
**--next-token *NEXT\$1TOKEN***
다음 결과 집합에 대한 토큰입니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster list-clusters
{
"clusters": [
{
"clusterName": "cluster-v3",
"cloudformationStackStatus": "CREATE_COMPLETE",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "CREATE_COMPLETE"
}
]
}
```
# `pcluster list-cluster-log-streams`
클러스터와 관련된 로그 스트림의 목록을 검색합니다.
```
pcluster list-cluster-log-streams [-h]
--cluster-name CLUSTER_NAME
[--filters FILTERS [FILTERS ...]]
[--next-token NEXT_TOKEN] [--debug]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster list-cluster-log-streams`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--filters *FILTERS* [*FILTERS* ...]**
로그 스트림의 필터를 지정합니다. 형식: `Name=a,Values=1 Name=b,Values=2,3` 지원되는 필터는 다음과 같습니다.
`private-dns-name`
인스턴스의 프라이빗 DNS 이름의 약식을 지정합니다(예:`ip-10-0-0-101`).
`node-type`
노드 유형을 지정합니다. 이 필터에 허용되는 유일한 값은 `HeadNode`입니다.
**--next-token *NEXT\$1TOKEN***
다음 결과 집합에 대한 토큰입니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster list-cluster-log-streams \
-n cluster-v3 \
-r us-east-1 \
--query 'logStreams[*].logStreamName'
[
"ip-172-31-58-205.i-1234567890abcdef0.cfn-init",
"ip-172-31-58-205.i-1234567890abcdef0.chef-client",
"ip-172-31-58-205.i-1234567890abcdef0.cloud-init",
"ip-172-31-58-205.i-1234567890abcdef0.clustermgtd",
"ip-172-31-58-205.i-1234567890abcdef0.slurmctld",
"ip-172-31-58-205.i-1234567890abcdef0.supervisord",
"ip-172-31-58-205.i-1234567890abcdef0.system-messages"
]
```
# `pcluster list-images`
기존 사용자 지정 이미지 목록을 검색합니다.
```
pcluster list-images [-h]
--image-status {AVAILABLE,PENDING,FAILED}
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster list-images`에 대한 도움말 텍스트를 표시합니다.
**--image-status \$1`AVAILABLE`,`PENDING`,`FAILED`\$1**
제공된 상태를 기준으로 반환된 이미지를 필터링합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--next-token *NEXT\$1TOKEN***
다음 결과 집합에 대한 토큰입니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.2 사용 예제:**
```
$ pcluster list-images --image-status AVAILABLE
{
"images": [
{
"imageId": "custom-alinux2-image",
"imageBuildStatus": "BUILD_COMPLETE",
"ec2AmiInfo": {
"amiId": "ami-1234abcd5678efgh"
},
"region": "us-east-1",
"version": "3.1.2"
}
]
}
```
# `pcluster list-image-log-streams`
이미지와 관련된 로그 스트림 목록을 검색합니다.
```
pcluster list-image-log-streams [-h]
--image-id IMAGE_ID
[--next-token NEXT_TOKEN] [--debug]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster list-image-log-streams`에 대한 도움말 텍스트를 표시합니다.
**--image-id, -i *IMAGE\$1ID***
이미지의 ID를 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--next-token *NEXT\$1TOKEN***
다음 결과 집합에 대한 토큰입니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.2 사용 예제:**
```
$ pcluster list-image-log-streams --image-id custom-alinux2-image --region us-east-1 --query 'logStreams[*].logStreamName'
[
"3.0.0/1",
"3.1.2/1"
]
```
# `pcluster list-official-images`
공식 AWS ParallelCluster AMIs 설명합니다.
```
pcluster list-official-images [-h]
[--architecture ARCHITECTURE]
[--debug]
[--os OS]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster list-official-images`에 대한 도움말 텍스트를 표시합니다.
**--architecture *ARCHITECTURE***
결과를 필터링하는 데 사용할 아키텍처를 지정합니다. 이 파라미터를 지정하지 않으면 모든 아키텍처가 반환됩니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--os *OS***
결과를 필터링하는 데 사용할 운영 체제를 지정합니다. 이 파라미터를 지정하지 않으면 모든 운영 체제가 반환됩니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. 이미지 구성 파일의 [리전](image-builder-configuration-file-v3.md#yaml-build-image-Region) 설정, `AWS_DEFAULT_REGION` 환경 변수, 파일 `[default]` 섹션의 `region` 설정 `~/.aws/config` 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.2 사용 예제:**
```
$ pcluster list-official-images
{
"images": [
{
"amiId": "ami-015cfeb4e0d6306b2",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-2204-lts-hvm-x86_64-202202261505 2022-02-26T15-08-34.759Z",
"version": "3.1.2",
"architecture": "x86_64"
},
{
"amiId": "ami-036f23237ce49d25b",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-1804-lts-hvm-x86_64-202202261505 2022-02-26T15-08-17.558Z",
"version": "3.1.2",
"architecture": "x86_64"
},
{
"amiId": "ami-09e5327e694d89ef4",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-2204-lts-hvm-arm64-202202261505 2022-02-26T15-08-45.736Z",
"version": "3.1.2",
"architecture": "arm64"
},
{
"amiId": "ami-0b9b0874c35f626ae",
"os": "alinux2",
"name": "aws-parallelcluster-3.1.2-amzn2-hvm-x86_64-202202261505 2022-02-26T15-08-31.311Z",
"version": "3.1.2",
"architecture": "x86_64"
},
{
"amiId": "ami-0d0de4f95f56374bc",
"os": "alinux2",
"name": "aws-parallelcluster-3.1.2-amzn2-hvm-arm64-202202261505 2022-02-26T15-08-46.088Z",
"version": "3.1.2",
"architecture": "arm64"
},
{
"amiId": "ami-0ebf7bc54b8740dc6",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-1804-lts-hvm-arm64-202202261505 2022-02-26T15-08-45.293Z",
"version": "3.1.2",
"architecture": "arm64"
}
]
}
```
# `pcluster ssh`
클러스터 사용자 이름과 IP 주소가 미리 채워진 상태로 `ssh` 명령을 실행합니다. 임의의 인수가 `ssh` 명령줄 끝에 추가됩니다.
```
pcluster ssh [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--dryrun DRYRUN]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster ssh`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
연결할 클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--dryrun *DRYRUN***
`true`면 실행할 명령줄을 인쇄하고 종료합니다. (`false`로 디폴트됩니다.)
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
예제:
```
$ pcluster ssh --cluster-name mycluster -i ~/.ssh/id_rsa
```
클러스터의 IP 주소와 사용자 이름이 미리 채워진 상태로 `ssh` 명령을 실행합니다.
```
ssh ec2-user@1.1.1.1 -i ~/.ssh/id_rsa
```
# `pcluster update-cluster`
지정된 구성 파일의 설정과 일치하도록 기존 클러스터를 업데이트합니다.
**참고**
클러스터 업데이트는 모든 클러스터 노드가 업데이트를 성공적으로 적용한 경우에만 성공합니다. 업데이트에 실패하면 [`pcluster describe-cluster` 명령으로 `clusterStatus`가 `UPDATE_FAILED`로 표시되는 경우](troubleshooting-fc-v3-update-cluster.md#update-cluster-failure-v3) 섹션의 문제 해결 지침을 참조하세요.
```
pcluster update-cluster [-h]
--cluster-configuration CLUSTER_CONFIGURATION
--cluster-name CLUSTER_NAME
[--debug]
[--dryrun DRYRUN]
[--force-update FORCE_UPDATE]
[--query QUERY]
[--region REGION]
[--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
[--validation-failure-level {INFO,WARNING,ERROR}]
```
## 이름 지정된 인수
**-h, --help**
`pcluster update-cluster`에 대한 도움말 텍스트를 표시합니다.
**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***
YAML 클러스터 구성 파일을 지정합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--dryrun *DRYRUN***
`true`면 클러스터를 업데이트하거나 리소스를 생성하지 않고 검증을 수행합니다. 이미지 구성을 검증하고 요구 사항을 업데이트하는 데 사용할 수 있습니다. (`false`로 디폴트됩니다.)
**--force-update *FORCE\$1UPDATE***
`true`면 업데이트 유효성 검사 오류를 무시하여 업데이트를 강제로 실행합니다. (`false`로 디폴트됩니다.)
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. 클러스터 구성 파일의 [`Region`](cluster-configuration-file-v3.md#yaml-Region) 설정, `AWS_DEFAULT_REGION` 환경 변수, 파일 `[default]` 섹션의 `region` 설정 `~/.aws/config` 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**
억제할 구성 유효성 검사기를 하나 이상 식별하세요.
형식: (`ALL`\$1`type:[A-Za-z0-9]+`)
**--validation-failure-level *\$1INFO,WARNING,ERROR\$1***
업데이트에 대해 보고되는 유효성 검사 실패 수준을 지정합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster update-cluster -c cluster-config.yaml -n cluster-v3 -r us-east-1
{
"cluster": {
"clusterName": "cluster-v3",
"cloudformationStackStatus": "UPDATE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "UPDATE_IN_PROGRESS"
},
"changeSet": [
{
"parameter": "HeadNode.Iam.S3Access",
"requestedValue": {
"BucketName": "amzn-s3-demo-bucket1",
"KeyName": "output",
"EnableWriteAccess": false
}
},
{
"parameter": "HeadNode.Iam.S3Access",
"currentValue": {
"BucketName": "amzn-s3-demo-bucket2",
"KeyName": "logs",
"EnableWriteAccess": true
}
}
]
}
```
# `pcluster update-compute-fleet`
클러스터 컴퓨팅 플릿의 상태를 업데이트합니다.
```
pcluster update-compute-fleet [-h]
--cluster-name CLUSTER_NAME
--status {START_REQUESTED,STOP_REQUESTED,ENABLED,DISABLED}
[--debug]
[--query QUERY]
[--region REGION]
```
## 이름 지정된 인수
**-h, --help**
`pcluster update-compute-fleet`에 대한 도움말 텍스트를 표시합니다.
**--cluster-name, -n *CLUSTER\$1NAME***
클러스터의 이름을 지정합니다.
**--status \$1START\$1REQUESTED,STOP\$1REQUESTED,ENABLED,DISABLED\$1**
클러스터 컴퓨팅 플릿에 적용되는 상태를 지정합니다. 및 상태는 Slurm 스케줄러에 `START_REQUESTED` `STOP_REQUESTED` 해당하는 반면 `ENABLED` 및 상태는 AWS Batch 스케줄러에 `DISABLED` 해당합니다.
**--debug**
디버깅 로깅을 활성화합니다.
**--query *QUERY***
출력에서 수행할 JMESPath 쿼리를 지정합니다.
**--region, -r *REGION***
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster update-compute-fleet -n cluster-v3 --status STOP_REQUESTED
{
"status": "STOP_REQUESTED",
"lastStatusUpdatedTime": "2022-07-12T20:19:47.653Z"
}
```
# `pcluster version`
의 버전을 표시합니다 AWS ParallelCluster.
```
pcluster version [-h] [--debug]
```
## 이름 지정된 인수
**-h, --help**
`pcluster version`에 대한 도움말 텍스트를 표시합니다.
**--debug**
디버깅 로깅을 활성화합니다.
** AWS ParallelCluster 버전 3.1.4 사용 예제:**
```
$ pcluster version
{
"version": "3.1.4"
}
```
# `pcluster3-config-converter`
AWS ParallelCluster 버전 2 구성 파일을 읽고 AWS ParallelCluster 버전 3 구성 파일을 작성합니다.
```
pcluster3-config-converter [-h]
[-t CLUSTER_TEMPLATE]
[-c CONFIG_FILE]
[--force-convert]
[-o OUTPUT_FILE]
```
## 이름 지정된 인수
**-h, --help**
`pcluster3-config-converter`에 대한 도움말 텍스트를 표시합니다.
**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***
변환할 구성 파일의 [`[cluster]`섹션](https://docs.aws.amazon.com/parallelcluster/v2/ug/cluster-definition.html)을 지정합니다. 지정하지 않으면 스크립트는 [`[global]`섹션](https://docs.aws.amazon.com/parallelcluster/v2/ug/global.html)에서 [cluster-template](https://docs.aws.amazon.com/parallelcluster/v2/ug/global.html#cluster-template) 파라미터를 찾거나 `[cluster default]`를 검색합니다.
**-c *CONFIG\$1FILE*, --config-file *CONFIG\$1FILE***
읽을 AWS ParallelCluster 버전 2 구성 파일을 지정합니다.
**--force-convert**
하나 이상의 설정이 지원되지 않고 권장되지 않는 경우에도 변환할 수 있습니다.
**-o *OUTPUT\$1FILE*, --output-file *OUTPUT\$1FILE***
작성할 AWS ParallelCluster 버전 3 구성 파일을 지정합니다. 이 파라미터를 지정하지 않으면 구성이 stdout에 기록됩니다.
**참고**
`pcluster3-config-converter` 명령이 AWS ParallelCluster 버전 3.0.1에 추가되었습니다.