pcluster createami - Amazon ParallelCluster
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

pcluster createami

(Linux/macOS) 创建一个自定义 AMI 以与 Amazon 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 ]

必需的依赖项

除了 Amazon ParallelCluster CLI 之外,还需要以下依赖项才能运行 pcluster createami

注意

在 Amazon ParallelCluster 版本 2.8.0 之前,必须安装 Berkshelf(使用 gem install berkshelf 进行安装)才能使用 pcluster createami

命名的参数

-h, --help

显示 pcluster createami 的帮助文本。

-ai BASE_AMI_ID, --ami-id BASE_AMI_ID

指定要用于构建 Amazon ParallelCluster AMI 的基本 AMI。

-os BASE_AMI_OS, --os BASE_AMI_OS

指定基本 AMI 的操作系统。有效的选项为:alinux2ubuntu1804ubuntu2004centos7

注意

在不同的 Amazon ParallelCluster 版本中,对操作系统的支持有所不同:

  • 在 Amazon ParallelCluster 版本 2.10.4 中删除了对 centos8 的支持。

  • 在 Amazon ParallelCluster 版本 2.10.0 中添加了对 centos8 的支持,并删除了对 centos6 的支持。

  • 在 Amazon ParallelCluster 版本 2.6.0 中添加了对 alinux2 的支持。

  • 在 Amazon ParallelCluster 版本 2.5.0 中添加了对 ubuntu1804 的支持。

-i INSTANCE_TYPE, --instance-type INSTANCE_TYPE

指定用于创建 AMI 的实例类型。

默认值为 t2.xlarge

注意

在 Amazon ParallelCluster 版本 2.4.1 中增加了对 --instance-type 参数的支持。

-ap CUSTOM_AMI_NAME_PREFIX, --ami-name-prefix CUSTOM_AMI_NAME_PREFIX

指定生成的 Amazon ParallelCluster AMI 的前缀名称。

默认值为 custom-ami-

-cc CUSTOM_AMI_COOKBOOK, --custom-cookbook CUSTOM_AMI_COOKBOOK

指定要用于构建 Amazon 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

注意

在 Amazon ParallelCluster 版本 2.10.0 中增加了对 --post-install 参数的支持。

--no-public-ip

请勿将公有 IP 地址与用于创建 AMI 的实例关联。默认情况下,公有 IP 地址与该实例关联。

注意

在 Amazon ParallelCluster 版本 2.5.0 中增加了对 --no-public-ip 参数的支持。

-c CONFIG_FILE, --config CONFIG_FILE

指定要使用的替代配置文件。

默认值为 ~/.parallelcluster/config

-t CLUSTER_TEMPLATE, --cluster-template CLUSTER_TEMPLATE

指定用于检索 VPC 和子网设置的 CONFIG_FILE[cluster] 部分

注意

在 Amazon ParallelCluster 版本 2.4.0 中增加了对 --cluster-template 参数的支持。

--vpc-id VPC_ID

指定用于构建 Amazon ParallelCluster AMI 的 VPC 的 ID。

注意

在 Amazon ParallelCluster 版本 2.5.0 中增加了对 --vpc-id 参数的支持。

--subnet-id SUBNET_ID

指定用于构建 Amazon ParallelCluster AMI 的子网的 ID。

注意

在 Amazon ParallelCluster 版本 2.5.0 中增加了对 --vpc-id 参数的支持。

-r REGION, --region REGION

指定要使用的 Amazon Web Services 区域。默认值为使用 pcluster configure 命令指定的 Amazon Web Services 区域。