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

# `pcluster createami`
<a name="pcluster.createami"></a>

(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 ]
```

## 必需的依赖项
<a name="pcluster.createami.required-dependencies"></a>

除了 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`

## 命名的参数
<a name="pcluster.createami.namedarg"></a>

**-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 区域 指定的值。