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

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

分析配置文件以确定是否可以安全地更新集群。如果分析后确定可以更新集群，系统会提示您确认更改。如果分析结果显示无法更新集群，则会枚举导致冲突的配置设置并显示详细信息。有关更多信息，请参阅 [使用 `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}}
```

## 定位参数
<a name="pcluster.update.arg"></a>

**{{cluster\_name}}**  
指定要更新的集群的名称。

## 命名的参数
<a name="pcluster.update.namedarg"></a>

**-h, --help**  
显示 `pcluster update` 的帮助文本。

**-c {{CONFIG\_FILE}}, --config {{CONFIG\_FILE}}**  
指定要使用的替代配置文件。  
默认值为 `~/.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\_TEMPLATE}}, --cluster-template {{CLUSTER\_TEMPLATE}}**  
指定集群部分使用的模板。

**-p {{EXTRA\_PARAMETERS}}, --extra-parameters {{EXTRA\_PARAMETERS}}**  
向堆栈更新添加额外的参数。

**-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` 返回以查看当前状态。