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

# `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\_name}}**  
定义集群的名称。 AWS CloudFormation 堆栈名称是`parallelcluster-{{cluster_name}}`。

## 命名的参数
<a name="pluster.create.namedarg"></a>

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

**-c {{CONFIG\_FILE}}, --config {{CONFIG\_FILE}}**  
指定要使用的替代配置文件。  
默认值为 `~/.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\_URL}}, --template-url {{TEMPLATE\_URL}}**  
如果创建时使用了自定义 AWS CloudFormation 模板，则指定该模板的 URL。

**-t {{CLUSTER\_TEMPLATE}}, --cluster-template {{CLUSTER\_TEMPLATE}}**  
指示要使用的集群模板。

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

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