本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `pcluster`
`pcluster` 是主要 AWS ParallelCluster CLI 命令。您可以使用 `pcluster` 在 中啟動和管理 HPC 叢集 AWS 雲端。
```
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-」開頭，並包含「YYYYMMDDHHMMSS」格式的建立時間。您可以使用 [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 網路堆疊中建立。您可以在 主控台或使用 手動刪除該 VPC AWS CLI。
```
$ 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. `-r` 或 `--region` 參數。 [`pcluster create`](#pluster.create)
1. `AWS_DEFAULT_REGION` 環境變數。
1. `aws_region_name` 組態檔案`[aws]`區段中的 AWS ParallelCluster 設定 （預設位置為 `~/.parallelcluster/config`。) 這是 [`pcluster configure`](pcluster.configure.md)命令更新的位置。
1. `region` 組態檔案 (`~/.aws/config`.) `[default]`區段中的 AWS CLI 設定
**-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 版本的變更：
+ `centos8` 2.10.4 AWS ParallelCluster 版已移除 的支援。
+ `centos8` 已新增 的支援，並在 2.10.0 AWS ParallelCluster 版`centos6`中移除 的支援。
+ 2.6.0 AWS ParallelCluster 版中已新增對 alinux2 的支援。
+ 2.5.0 AWS ParallelCluster 版中已新增對 ubuntu1804 的支援。
**-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***
指定 *CONFIG\$1FILE* 的 [【`cluster`】 區段](cluster-definition.md)，用於擷取 VPC 和子網路設定。
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** *區域*
指定 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`命令的變更：
2.10.0 版中`centos8` AWS ParallelCluster 已新增 上的 `pcluster dcv`命令支援。
在 AWS 2.9.0 AWS ParallelCluster 版中新增了 Graviton 型執行個體的 `pcluster dcv`命令支援。
2.6.0 版中`ubuntu1804` AWS ParallelCluster 已新增 上的 `pcluster dcv`命令支援。
在 上的 `pcluster dcv`命令支援`centos7`已新增至 2.5. AWS ParallelCluster 0 版。
## 具名引數
**-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** *區域*
指定 AWS 區域 要使用的 。使用 [`pcluster configure`](pcluster.configure.md)命令預設為 AWS 區域 指定的 。
**-s, --show-url**
顯示連線至 Amazon DCV 工作階段的一次性 URL。指定此選項時，預設瀏覽器不會開啟。
2.5.1 AWS ParallelCluster 版中已新增對 `--show-url`引數的支援。
**使用 2.11.7 AWS ParallelCluster 版的範例：**
```
$ pcluster dcv connect -k ~/.ssh/id_rsa mycluster
```
開啟預設瀏覽器以連線至在前端節點上執行的 Amazon DCV 工作階段。
如果尚未啟動 Amazon DCV 工作階段，則會建立新的工作階段。
![\[A screenshot of the DCV console.\]](http://docs.aws.amazon.com/zh_tw/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 Logs 資料。日誌群組會保留到您手動刪除為止，但日誌事件會根據 [`retention_days`](cw-log-section.md#cw-log-section-retention-days)設定而過期。此設定預設為 14 天。
2.6.0 版中 AWS ParallelCluster 已新增對 **--keep-logs**引數的支援。
**-r *REGION*, --region *REGION***
指定 AWS 區域 要使用的 。使用 [`pcluster configure`](pcluster.configure.md)命令預設為 AWS 區域 指定的 。
當呼叫 命令並開始輪詢該呼叫的狀態時，使用 "Ctrl-C" 結束是安全的。您可以透過呼叫 `pcluster status mycluster` 來返回檢視目前狀態。
**使用 2.11.7 AWS ParallelCluster 版的範例：**
```
$ pcluster delete -c path/to/config -r us-east-1 mycluster
Deleting: mycluster
Status: RootRole - DELETE_COMPLETE
Cluster deleted successfully.
```
若要刪除 VPC 中的網路資源，您可以刪除 CloudFormation 網路堆疊。堆疊名稱以「parallelclusternetworking-」開頭，並包含「YYYYMMDDHHMMSS」格式的建立時間。您可以使用 [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 網路堆疊中建立。您可以在 主控台或使用 手動刪除該 VPC AWS CLI。
```
$ 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 區域 指定的 。
**使用 2.11.7 AWS ParallelCluster 版的範例：**
```
$ 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-*`。
**使用 2.11.7 AWS ParallelCluster 版的範例：**
```
$ 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`
執行預先填入叢集使用者名稱和 IP 地址的 `ssh` 命令。任意引數會附加至 `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
```
`ssh` 命令的定義位於 [`[aliases]` 區段](aliases.md) 下的全域組態檔案中。可以自訂此命令，如下所示。
```
[ 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 區域 指定的 。
**使用 2.11.7 AWS ParallelCluster 版的範例：**
```
$ 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`。
**使用 2.11.7 AWS ParallelCluster 版的範例：**
```
$ 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***
停止所提供叢集名稱的運算機群。
**使用 2.11.7 AWS ParallelCluster 版的範例：**
## 具名引數
**-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
```