기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# `pcluster update-cluster`
<a name="pcluster.update-cluster-v3"></a>

지정된 구성 파일의 설정과 일치하도록 기존 클러스터를 업데이트합니다.

**참고**  
 클러스터 업데이트는 모든 클러스터 노드가 업데이트를 성공적으로 적용한 경우에만 성공합니다. 업데이트에 실패하면 [`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}]
```

## 이름 지정된 인수
<a name="pcluster-v3.update-cluster.namedargs"></a>

**-h, --help**  
`pcluster update-cluster`에 대한 도움말 텍스트를 표시합니다.

**--cluster-configuration, -c {{CLUSTER\_CONFIGURATION}}**  
YAML 클러스터 구성 파일을 지정합니다.

**--cluster-name, -n {{CLUSTER\_NAME}}**  
클러스터의 이름을 지정합니다.

**--debug**  
디버깅 로깅을 활성화합니다.

**--dryrun {{DRYRUN}}**  
`true`면 클러스터를 업데이트하거나 리소스를 생성하지 않고 검증을 수행합니다. 이미지 구성을 검증하고 요구 사항을 업데이트하는 데 사용할 수 있습니다. (`false`로 디폴트됩니다.)

**--force-update {{FORCE\_UPDATE}}**  
`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\_VALIDATORS}} [{{SUPPRESS\_VALIDATORS ...}}]**  
억제할 구성 유효성 검사기를 하나 이상 식별하세요.  
형식: (`ALL`\|`type:[A-Za-z0-9]+`)

**--validation-failure-level {{{INFO,WARNING,ERROR}}}**  
업데이트에 대해 보고되는 유효성 검사 실패 수준을 지정합니다.

** 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
      }
    }
  ]
}
```