本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# `pcluster`
`pcluster`是主要 AWS ParallelCluster CLI 命令。使用 `pcluster` 可以在 AWS 云中启动和管理 HPC 集群。
```
pcluster [ -h ] ( create | update | delete | start | stop | status | list |
instances | ssh | dcv | createami | configure | version ) ...
```
## 参数
**`pcluster command`**
可能的选项：[`configure`](pcluster.configure.md)、[`create`](pluster.create.md)、[`createami`](pcluster.createami.md)、[`dcv`](pcluster.dcv.md)、[`delete`](pcluster.delete.md)、[`instances`](pcluster.instances.md)、[`list`](pcluster.list.md)、[`ssh`](pcluster.ssh.md)、[`start`](pcluster.start.md)、[`status`](pcluster.status.md)、[`stop`](pcluster.stop.md)、[`update`](pcluster.update.md)、[`version`](pcluster.version.md)
## 子命令：
**Topics**
+ [参数](#pcluster.arguments)
+ [子命令：](#pcluster.subcommands)
+ [`pcluster configure`](pcluster.configure.md)
+ [`pcluster create`](pluster.create.md)
+ [`pcluster createami`](pcluster.createami.md)
+ [`pcluster dcv`](pcluster.dcv.md)
+ [`pcluster delete`](pcluster.delete.md)
+ [`pcluster instances`](pcluster.instances.md)
+ [`pcluster list`](pcluster.list.md)
+ [`pcluster ssh`](pcluster.ssh.md)
+ [`pcluster start`](pcluster.start.md)
+ [`pcluster status`](pcluster.status.md)
+ [`pcluster stop`](pcluster.stop.md)
+ [`pcluster update`](pcluster.update.md)
+ [`pcluster version`](pcluster.version.md)
# `pcluster configure`
开始 AWS ParallelCluster 配置。有关更多信息，请参阅 [正在配置 AWS ParallelCluster](getting-started-configuring-parallelcluster.md)。
```
pcluster configure [ -h ] [ -c CONFIG_FILE ] [ -r REGION ]
```
## 命名的参数
**-h, --help**
显示 `pcluster configure` 的帮助文本。
**-c * CONFIG\$1FILE*, --config *CONFIG\$1FILE***
指定要使用的替代配置文件的完整路径。
默认值为 `~/.parallelcluster/config`。
有关更多信息，请参阅 [正在配置 AWS ParallelCluster](getting-started-configuring-parallelcluster.md)。
**-r *REGION*, --region *REGION***
指定 AWS 区域 要使用的。如果指定了此选项，则配置将跳过 AWS 区域 检测。
要删除 VPC 中的网络资源，您可以删除 CloudFormation 网络堆栈。堆栈名称以” 开头parallelclusternetworking-“并包含 “YYYYMMDDHHMSS” 格式的创建时间。您可以使用 [list-stacks](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/ListStacks) 命令列出堆栈。
```
$ aws --region us-east-1 cloudformation list-stacks \
--stack-status-filter "CREATE_COMPLETE" \
--query "StackSummaries[].StackName" | \
grep -e "parallelclusternetworking-"
"parallelclusternetworking-pubpriv-20191029205804"
```
可以使用 [delete-stack](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/DeleteStack) 命令删除堆栈。
```
$ aws --region us-east-1 cloudformation delete-stack \
--stack-name parallelclusternetworking-pubpriv-20191029205804
```
为您[`pcluster configure`](#pcluster.configure)创建的 VPC 不是在 CloudFormation 网络堆栈中创建的。您可以在控制台中或者通过使用 AWS CLI，手动删除该 VPC。
```
$ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad
```
# `pcluster create`
创建新集群。
```
pcluster create [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] [ -nr ]
[ -u TEMPLATE_URL ] [ -t CLUSTER_TEMPLATE ]
[ -p EXTRA_PARAMETERS ] [ -g TAGS ]
cluster_name
```
## 定位参数
***cluster\$1name***
定义集群的名称。 AWS CloudFormation 堆栈名称是`parallelcluster-cluster_name`。
## 命名的参数
**-h, --help**
显示 `pcluster create` 的帮助文本。
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
指定要使用的替代配置文件。
默认值为 `~/.parallelcluster/config`。
**-r *REGION*, --region *REGION***
指定 AWS 区域 要使用的。用于为新集群选择 AWS 区域 的优先级顺序如下：
1. [`pcluster create`](#pluster.create) 的 `-r` 或 `--region` 参数。
1. `AWS_DEFAULT_REGION` 环境变量。
1. `aws_region_name`在 AWS ParallelCluster 配置文件`[aws]`部分进行设置（默认位置为`~/.parallelcluster/config`.） 这是由 [`pcluster configure`](pcluster.configure.md) 命令更新的位置。
1. `region`在 AWS CLI 配置文件`[default]`部分设置 (`~/.aws/config`.)
**-nw, --nowait**
指示在运行堆栈命令后不等待堆栈事件。
默认值为 `False`。
**-nr, --norollback**
禁止在出现错误时回滚 堆栈。
默认值为 `False`。
**-u *TEMPLATE\$1URL*, --template-url *TEMPLATE\$1URL***
如果创建时使用了自定义 AWS CloudFormation 模板，则指定该模板的 URL。
**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***
指示要使用的集群模板。
**-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS***
向堆栈创建添加额外的参数。
**-g *TAGS*, --tags *TAGS***
指定要添加到堆栈的其他标签。
当命令被调用并开始轮询该调用的状态时，可以安全地使用“Ctrl-C”退出。您可以通过调用 `pcluster status mycluster` 返回以查看当前状态。
**使用 2.11.7 AWS ParallelCluster 版本的示例：**
```
$ pcluster create mycluster
Beginning cluster creation for cluster: mycluster
Info: There is a newer version 3.1.4 of AWS ParallelCluster available.
Creating stack named: parallelcluster-mycluster
Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS
$ pcluster create mycluster --tags '{ "Key1" : "Value1" , "Key2" : "Value2" }'
```
# `pcluster createami`
(Linux/macOS) 创建用于的自定义 AMI。 AWS ParallelCluster
```
pcluster createami [ -h ] -ai BASE_AMI_ID -os BASE_AMI_OS
[ -i INSTANCE_TYPE ] [ -ap CUSTOM_AMI_NAME_PREFIX ]
[ -cc CUSTOM_AMI_COOKBOOK ] [--no-public-ip]
[ -post-install POST_INSTALL_SCRIPT ]
[ -c CONFIG_FILE ] [-t CLUSTER_TEMPLATE]
[--vpc-id VPC_ID] [--subnet-id SUBNET_ID]
[ -r REGION ]
```
## 必需的依赖项
除了 AWS ParallelCluster CLI 之外，还需要以下依赖项才能运行`pcluster createami`：
+ **Packer**：从 [https://developer.hashicorp.com/packer/downloads](https://developer.hashicorp.com/packer/downloads) 下载最新版本。
**注意**
在 2.8.0 AWS ParallelCluster 版本之前，必须使用 [Berkshelf](https://github.com/berkshelf/berkshelf)（使用安装的`gem install berkshelf`）。`pcluster createami`
## 命名的参数
**-h, --help**
显示 `pcluster createami` 的帮助文本。
**-ai *BASE\$1AMI\$1ID*, --ami-id *BASE\$1AMI\$1ID***
指定用于构建 AMI 的基础 AWS ParallelCluster AMI。
**-os *BASE\$1AMI\$1OS*, --os *BASE\$1AMI\$1OS***
指定基本 AMI 的操作系统。有效的选项为：`alinux2`、`ubuntu1804`、`ubuntu2004` 和 `centos7`。
操作系统支持不同 AWS ParallelCluster 版本的更改：
+ 在 2.10.4 AWS ParallelCluster 版本中删除`centos8`了对 Support 的支持。
+ 在 AWS ParallelCluster 版本 2.10.0 中增加了对 `centos8` 的支持，并删除了对 `centos6` 的支持。
+ 2.6.0 版本中增加了对 alinux2 的 AWS ParallelCluster 支持。
+ 2.5.0 版本中增加了对 ubuntu1804 的支持。 AWS ParallelCluster
**-i *INSTANCE\$1TYPE*, --instance-type *INSTANCE\$1TYPE***
指定用于创建 AMI 的实例类型。
默认值为 `t2.xlarge`。
在 2.4.1 AWS ParallelCluster 版本中增加了对该`--instance-type`参数的支持。
**-ap *CUSTOM\$1AMI\$1NAME\$1PREFIX*, --ami-name-prefix *CUSTOM\$1AMI\$1NAME\$1PREFIX***
指定生成的 AWS ParallelCluster AMI 的前缀名称。
默认值为 `custom-ami-`。
**-cc *CUSTOM\$1AMI\$1COOKBOOK*, --custom-cookbook *CUSTOM\$1AMI\$1COOKBOOK***
指定用于构建 AWS ParallelCluster AMI 的食谱。
**--post-install *POST\$1INSTALL\$1SCRIPT***
指定安装后脚本的路径。路径必须使用 `s3://`、`https://` 或 `file://` URL 方案。示例包括：
+ `https://bucket-name.s3.region.amazonaws.com/path/post_install.sh`
+ `s3://bucket-name/post_install.sh`
+ `file:///opt/project/post_install.sh`
2.10.0 AWS ParallelCluster 版本中增加了对该`--post-install`参数的支持。
**--no-public-ip**
请勿将公有 IP 地址与用于创建 AMI 的实例关联。默认情况下，公有 IP 地址与该实例关联。
在 2.5.0 AWS ParallelCluster 版本中添加了对该`--no-public-ip`参数的支持。
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
指定要使用的替代配置文件。
默认值为 `~/.parallelcluster/config`。
**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***
指定用于检索 VPC 和子网设置的 [[`cluster`] 部分](cluster-definition.md)。*CONFIG\$1FILE*
在 2.4.0 AWS ParallelCluster 版本中添加了对该`--cluster-template`参数的支持。
**--vpc-id *VPC\$1ID***
指定用于构建 AWS ParallelCluster AMI 的 VPC 的 ID。
在 2.5.0 AWS ParallelCluster 版本中添加了对该`--vpc-id`参数的支持。
**--subnet-id *SUBNET\$1ID***
指定用于构建 AWS ParallelCluster AMI 的子网的 ID。
在 2.5.0 AWS ParallelCluster 版本中添加了对该`--vpc-id`参数的支持。
**-r *REGION*, --region** *REGION*
指定 AWS 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 AWS 区域 指定的值。
# `pcluster dcv`
与头节点上运行的 Amazon DCV 服务器进行交互。
```
pcluster dcv [ -h ] ( connect )
```
**`pcluster dcv command`**
可能的选项：[`connect`](#pcluster-dcv-connect)
**注意**
操作系统支持在不同 AWS ParallelCluster 版本中对该`pcluster dcv`命令进行更改：
在 AWS ParallelCluster 版本 2.10.0 中增加了对 `centos8` 上 `pcluster dcv` 命令的支持。
2.9.0 版本中增加了对 AWS 基于 Graviton 的实例上的`pcluster dcv`命令的 AWS ParallelCluster 支持。
在 AWS ParallelCluster 版本 2.6.0 中增加了对 `ubuntu1804` 上 `pcluster dcv` 命令的支持。
在 AWS ParallelCluster 版本 2.5.0 中增加了对 `centos7` 上 `pcluster dcv` 命令的支持。
## 命名的参数
**-h, --help**
显示 `pcluster dcv` 的帮助文本。
## 子命令
### `pcluster dcv connect`
```
pcluster dcv connect [ -h ] [ -k SSH_KEY_PATH ] [ -r REGION ] cluster_name
```
**重要**
此 URL 在发布 30 秒后过期。如果在 URL 过期之前没有建立连接，请重新运行 `pcluster dcv connect` 以生成新的 URL。
#### 定位参数
***cluster\$1name***
指定要连接到的集群的名称。
#### 命名的参数
**-h, --help**
显示 `pcluster dcv connect` 的帮助文本。
**-k *SSH\$1KEY\$1PATH*, --key-path *SSH\$1KEY\$1PATH***
用于连接的 SSH 密钥的密钥路径。
此键必须是在创建集群时在 [`key_name`](cluster-definition.md#key-name) 配置参数中指定的键。此参数是可选的，但如果未指定该参数，则默认情况下此键必须可用于 SSH 客户端。例如，使用 `ssh-add` 将其添加到 `ssh-agent`。
**-r *REGION*, --region** *REGION*
指定 AWS 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 AWS 区域 指定的值。
**-s, --show-url**
显示用于连接到 Amazon DCV 会话的一次性 URL。指定此选项时，不打开默认浏览器。
2.5.1 AWS ParallelCluster 版本中增加了对该`--show-url`参数的支持。
**使用 AWS ParallelCluster 版本 2.11.7 的示例：**
```
$ pcluster dcv connect -k ~/.ssh/id_rsa mycluster
```
打开默认浏览器以连接到在头节点上运行的 Amazon DCV 会话。
如果尚未启动 Amazon DCV 会话，则会创建新会话。
![\[A screenshot of the DCV console.\]](http://docs.aws.amazon.com/zh_cn/parallelcluster/v2/ug/images/Dcv-image.png)
# `pcluster delete`
删除集群。
```
pcluster delete [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name
```
## 定位参数
***cluster\$1name***
指定要删除的集群的名称。
## 命名的参数
**-h, --help**
显示 `pcluster delete` 的帮助文本。
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
指定要使用的替代配置文件。
默认值为 `~/.parallelcluster/config`。
**--keep-logs**
删除集群后保留 CloudWatch 日志数据。日志组将一直保留，直至手动删除，但日志事件将根据 [`retention_days`](cw-log-section.md#cw-log-section-retention-days) 设置过期。该设置默认为 14 天。
在 AWS ParallelCluster 版本 2.6.0 中增加了对 **--keep-logs** 参数的支持。
**-r *REGION*, --region *REGION***
指定 AWS 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 AWS 区域 指定的值。
当命令被调用并开始轮询该调用的状态时，可以安全地使用“Ctrl-C”退出。您可以通过调用 `pcluster status mycluster` 返回以查看当前状态。
**使用 AWS ParallelCluster 版本 2.11.7 的示例：**
```
$ pcluster delete -c path/to/config -r us-east-1 mycluster
Deleting: mycluster
Status: RootRole - DELETE_COMPLETE
Cluster deleted successfully.
```
要删除 VPC 中的网络资源，您可以删除 CloudFormation 网络堆栈。堆栈名称以” 开头parallelclusternetworking-“并包含 “YYYYMMDDHHMSS” 格式的创建时间。您可以使用 [list-stacks](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/ListStacks) 命令列出堆栈。
```
$ aws --region us-east-1 cloudformation list-stacks \
--stack-status-filter "CREATE_COMPLETE" \
--query "StackSummaries[].StackName" | \
grep -e "parallelclusternetworking-"
"parallelclusternetworking-pubpriv-20191029205804"
```
可以使用 [delete-stack](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/DeleteStack) 命令删除堆栈。
```
$ aws --region us-east-1 cloudformation delete-stack \
--stack-name parallelclusternetworking-pubpriv-20191029205804
```
为您[`pcluster configure`](pcluster.configure.md)创建的 VPC 不是在 CloudFormation 网络堆栈中创建的。您可以在控制台中或者通过使用 AWS CLI，手动删除该 VPC。
```
$ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad
```
# `pcluster instances`
显示集群中所有实例的列表。
```
pcluster instances [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```
## 定位参数
***cluster\$1name***
显示具有所提供名称的集群的实例。
## 命名的参数
**-h, --help**
显示 `pcluster instances` 的帮助文本。
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
指定要使用的替代配置文件。
默认值为 `~/.parallelcluster/config`。
**-r *REGION*, --region *REGION***
指定 AWS 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 AWS 区域 指定的值。
**使用 AWS ParallelCluster 版本 2.11.7 的示例：**
```
$ pcluster instances -c path/to/config -r us-east-1 mycluster
MasterServer i-1234567890abcdef0
ComputeFleet i-abcdef01234567890
```
# `pcluster list`
显示与之关联 AWS ParallelCluster的堆栈列表。
```
pcluster list [ -h ] [ -c CONFIG_FILE ] [ -r REGION ]
```
## 命名的参数
**-h, --help**
显示 `pcluster list` 的帮助文本。
**--color**
用颜色显示集群状态。
默认值为 `False`。
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
指定要使用的替代配置文件。
默认值为 `c`。
**-r *REGION*, --region *REGION***
指定 AWS 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 AWS 区域 指定的值。
列出任何名为的 AWS CloudFormation 堆栈的名称。`parallelcluster-*`
**使用 AWS ParallelCluster 版本 2.11.7 的示例：**
```
$ pcluster list -c path/to/config -r us-east-1
mycluster CREATE_IN_PROGRESS 2.11.7
myothercluster CREATE_IN_PROGRESS 2.11.7
```
# `pcluster ssh`
将 `ssh` 命令与预先填充的集群用户名和 IP 地址一起运行 。将任意参数附加到 `ssh` 命令的结尾。可以在配置文件的别名部分中自定义此命令。
```
pcluster ssh [ -h ] [ -d ] [ -r REGION ] cluster_name
```
## 定位参数
***cluster\$1name***
指定要连接到的集群的名称。
## 命名的参数
**-h, --help**
显示 `pcluster ssh` 的帮助文本。
**-d, --dryrun**
打印命令，该命令将运行并退出。
默认值为 `False`。
**-r *REGION*, --region *REGION***
指定 AWS 区域 要使用的。默认值为使用 [`pcluster configure`](pcluster.configure.md) 命令指定的区域。
**使用 2.11.7 AWS ParallelCluster 版本的示例：**
```
$ pcluster ssh -d mycluster -i ~/.ssh/id_rsa
SSH command: ssh ec2-user@1.1.1.1 -i /home/user/.ssh/id_rsa
```
```
$ pcluster ssh mycluster -i ~/.ssh/id_rsa
```
使用预先填充的集群用户名和 IP 地址运行 `ssh` 命令：
```
ssh ec2-user@1.1.1.1 -i ~/.ssh/id_rsa
```
在 [`[aliases]` 部分](aliases.md) 下的全局配置文件中定义 `ssh` 命令。它可以是自定义的，如下所示。
```
[ aliases ]
ssh = ssh {CFN_USER}@{MASTER_IP} {ARGS}
```
替换的变量：
`CFN_USER`
选择的 [`base_os`](cluster-definition.md#base-os) 的用户名。
`MASTER_IP`
头节点的 IP 地址。
`ARGS`
要传递到 `ssh` 命令的可选参数。
# `pcluster start`
为已停止的集群启动计算队列。
```
pcluster start [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```
## 定位参数
***cluster\$1name***
启动提供的集群名称的计算队列。
## 命名的参数
**-h, --help**
显示 `pcluster start` 的帮助文本。
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
指定要使用的替代配置文件。
默认值为 `~/.parallelcluster/config`。
**-r *REGION*, --region *REGION***
指定 AWS 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 AWS 区域 指定的值。
**使用 AWS ParallelCluster 版本 2.11.7 的示例：**
```
$ pcluster start mycluster
Compute fleet status is: RUNNING. Submitting status change request.
Request submitted successfully. It might take a while for the transition to complete.
Please run 'pcluster status' if you need to check compute fleet status
```
此命令将 Auto Scaling 组参数设置为下列项目之一：
+ 已用于创建集群的模板中的初始配置值（`max_queue_size` 和 `initial_queue_size`）。
+ 自集群首次创建以来用于更新集群的配置值。
# `pcluster status`
拉取集群的当前状态。
```
pcluster status [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name
```
## 定位参数
**cluster\$1name**
显示具有所提供名称的集群的状态。
## 命名的参数
**-h, --help**
显示 `pcluster status` 的帮助文本。
**-c *CONFIG\$1FILE*, `--config` *CONFIG\$1FILE***
指定要使用的替代配置文件。
默认值为 `~/.parallelcluster/config`。
**-r *REGION*, --region *REGION***
指定 AWS 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 AWS 区域 指定的值。
**-nw, --nowait**
指示在处理堆栈命令后不等待堆栈事件。
默认值为 `False`。
**使用 AWS ParallelCluster 版本 2.11.7 的示例：**
```
$ pcluster status -c path/to/config -r us-east-1 mycluster
Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS
```
# `pcluster stop`
停止计算实例集，同时让头节点保持运行。
```
pcluster stop [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```
## 定位参数
***cluster\$1name***
停止提供的集群名称的计算队列。
**使用 AWS ParallelCluster 版本 2.11.7 的示例：**
## 命名的参数
**-h, --help**
显示 `pcluster stop` 的帮助文本。
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
指定要使用的替代配置文件。
默认值为 `~/.parallelcluster/config`。
**-r *REGION*, --region *REGION***
指定 AWS 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 AWS 区域 指定的值。
```
$ pcluster stop mycluster
Compute fleet status is: STOPPED. Submitting status change request.
Request submitted successfully. It might take a while for the transition to complete.
Please run 'pcluster status' if you need to check compute fleet status
```
将 Auto Scaling 组参数设置为 min/max/desired = 0/0/0，然后终止计算队列。头节点保持运行。要终止所有 EC2 资源并避免 EC2 收费，请考虑删除集群。
# `pcluster update`
分析配置文件以确定是否可以安全地更新集群。如果分析后确定可以更新集群，系统会提示您确认更改。如果分析结果显示无法更新集群，则会枚举导致冲突的配置设置并显示详细信息。有关更多信息，请参阅 [使用 `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
```
## 定位参数
***cluster\$1name***
指定要更新的集群的名称。
## 命名的参数
**-h, --help**
显示 `pcluster update` 的帮助文本。
**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***
指定要使用的替代配置文件。
默认值为 `~/.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\$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` 返回以查看当前状态。
# `pcluster version`
显示 AWS ParallelCluster 版本。
```
pcluster version [ -h ]
```
对于命令特定的标记，请运行：`pcluster [command] –-help`。
## 命名的参数
**-h, --help**
显示 `pcluster version` 的帮助文本。
当命令被调用并开始轮询该调用的状态时，可以安全地使用“Ctrl-C”退出。您可以通过调用 `pcluster status mycluster` 返回以查看当前状态。
```
$ pcluster version
2.11.7
```