本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `pcluster create`
<a name="pluster.create"></a>

建立新叢集。

```
pcluster create [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] [ -nr ]
                [ -u TEMPLATE_URL ] [ -t CLUSTER_TEMPLATE ]
                [ -p EXTRA_PARAMETERS ] [ -g TAGS ]
                cluster_name
```

## 定位引數
<a name="pluster.create.arg"></a>

***cluster\$1name***  
定義叢集的名稱。 AWS CloudFormation 堆疊名稱為 `parallelcluster-cluster_name`。

## 具名引數
<a name="pluster.create.namedarg"></a>

**-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" }'
```