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

# `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\$1name***  
指定要更新的集群的名称。

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

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

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
指定要使用的替代配置文件。  
默认值为 `~/.parallelcluster/config`。

**--force**  
即使一个或多个设置存在阻止更新的更改，或者需要执行尚未执行的操作（例如停止计算实例集）才能继续更新，也会启用更新。此参数不应与 `--yes` 参数结合使用。

**-r *REGION*, --region *REGION***  
指定 Amazon Web Services 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 Amazon Web Services 区域 指定的值。

**-nr, --norollback**  
出错时禁用 Amazon 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` 返回以查看当前状态。