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

# `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. [`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" }'
```