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

# `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\_AMI\_ID}}, --ami-id {{BASE\_AMI\_ID}}**  
指定用於建置 AMI 的基本 AWS ParallelCluster AMI。

**-os {{BASE\_AMI\_OS}}, --os {{BASE\_AMI\_OS}}**  
指定基本 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\_TYPE}}, --instance-type {{INSTANCE\_TYPE}}**  
指定用來建立 AMI 的執行個體類型。  
預設為 `t2.xlarge`。  
2.4.1 AWS ParallelCluster 版中已新增對 `--instance-type`引數的支援。

**-ap {{CUSTOM\_AMI\_NAME\_PREFIX}}, --ami-name-prefix {{CUSTOM\_AMI\_NAME\_PREFIX}}**  
指定產生的 AWS ParallelCluster AMI 的字首名稱。  
預設為 `custom-ami-`。

**-cc {{CUSTOM\_AMI\_COOKBOOK}}, --custom-cookbook {{CUSTOM\_AMI\_COOKBOOK}}**  
指定要用來建置 AWS ParallelCluster AMI 的技術指南。

**--post-install {{POST\_INSTALL\_SCRIPT}}**  
指定安裝後指令碼的路徑。路徑必須使用 `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\_FILE}}, --config {{CONFIG\_FILE}}**  
指定要使用的替代組態檔案。  
預設為 `~/.parallelcluster/config`。

**-t {{CLUSTER\_TEMPLATE}}, --cluster-template {{CLUSTER\_TEMPLATE}}**  
指定 {{CONFIG\_FILE}} 的 [【`cluster`】 區段](cluster-definition.md)，用於擷取 VPC 和子網路設定。  
2.4.0 AWS ParallelCluster 版中已新增對 `--cluster-template`引數的支援。

**--vpc-id {{VPC\_ID}}**  
指定要用來建置 AWS ParallelCluster AMI 的 VPC ID。  
2.5.0 AWS ParallelCluster 版中已新增對 `--vpc-id`引數的支援。

**--subnet-id {{SUBNET\_ID}}**  
指定要用來建置 AWS ParallelCluster AMI 的子網路 ID。  
2.5.0 AWS ParallelCluster 版中已新增對 `--vpc-id`引數的支援。

**-r {{REGION}}, --region** {{區域}}  
指定 AWS 區域 要使用的 。使用 [`pcluster configure`](pcluster.configure.md)命令預設為 AWS 區域 指定的 。