本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `pcluster 更新集群`
<a name="pcluster.update-cluster-v3"></a>

更新现有集群以匹配指定配置文件的设置。

**注意**  
 只有当所有群集节点都成功应用更新时，群集更新才会成功。如果更新失败，请参阅故障排除指南[`集群状态为` `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}}**  
指定 Amazon Web Services 区域 要使用的。 Amazon Web Services 区域 必须使用群集配置文件中的[`Region`](cluster-configuration-file-v3.md#yaml-Region)设置、`AWS_DEFAULT_REGION`环境变量、`~/.aws/config`文件`[default]`部分的`region`设置或`--region`参数来指定。

**--suppress-validators {{ SUPPRESS\_VALIDATORS}} [{{SUPPRESS\_VALIDATORS ...}}]**  
标识一个或多个要禁止的配置验证器。  
格式：(`ALL`\|`type:[A-Za-z0-9]+`)

**--validation-failure-level {{{INFO,WARNING,ERROR}}}**  
指定为更新报告的验证失败级别。

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