启动模板支持 - AWS Batch
启动模板中的 Amazon EC2 用户数据
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

启动模板支持

AWS Batch 支持在计算环境中使用 Amazon EC2 启动模板。启动模板支持允许您修改 AWS Batch 计算资源的默认配置，而无需您创建自定义的 AMI。

您必须先创建启动模板，然后才能将其与计算环境关联。您可以在 Amazon EC2 控制台中创建启动模板，也可以使用 AWS CLI 或 AWS 开发工具包。例如，下面的 JSON 文件表示一个启动模板，它为默认 AWS Batch 计算资源 AMI 调整 Docker 数据卷的大小，并将其设置为加密。 

{
    "LaunchTemplateName": "increase-container-volume-encrypt",
    "LaunchTemplateData": {
        "BlockDeviceMappings": [
            {
                "DeviceName": "/dev/xvdcz",
                "Ebs": {
                    "Encrypted": true,
                    "VolumeSize": 100,
                    "VolumeType": "gp2"
                }
            }
        ]
    }
}

您可以通过将 JSON 保存到名为 lt-data.json 的文件并运行以下 AWS CLI 命令来创建上述启动模板： 

aws ec2 --region <region> create-launch-template --cli-input-json file://lt-data.json

有关启动模板的更多信息，请参阅 Amazon EC2 用户指南（适用于 Linux 实例） 中的从启动模板启动实例。

如果使用启动模板来创建计算环境，则可以将以下现有计算环境参数移至启动模板：

注意

如果在启动模板和计算环境配置中都指定了这些参数中的任何一个（Amazon EC2 标签除外），则计算环境参数优先。Amazon EC2 标签将在启动模板和计算环境配置之间合并。如果标签键发生冲突，则计算环境配置中的值优先。

  • Amazon EC2 密钥对

  • Amazon EC2 AMI ID

  • 安全组 ID

  • Amazon EC2 标签

AWS Batch 将忽略以下启动模板参数：

  • 实例类型（在创建计算环境时指定所需的实例类型）

  • 实例角色（在创建计算环境时指定所需的实例角色）

  • 网络接口子网（在创建计算环境时指定所需的子网）

  • 实例市场选项（AWS Batch 必须控制 Spot 实例配置）

  • 禁用 API 终止（AWS Batch 必须控制实例生命周期）

AWS Batch 不支持使用新的启动模板版本来更新计算环境。如果更新启动模板，则必须使用新模板创建新计算环境以使更改生效。

启动模板中的 Amazon EC2 用户数据

可以在启动模板中提供当实例启动时由 cloud-init 执行的 Amazon EC2 用户数据。您的用户数据可以执行常见的配置方案，包括但不限于：

启动模板中的 Amazon EC2 用户数据必须采用 MIME 分段存档格式，因为您的用户数据将与配置计算资源所需的其他 AWS Batch 用户数据合并。您可以将多个用户数据块合并到一个 MIME 分段文件中。例如，您可能希望将配置 Docker 守护程序的云 boothook 与为 Amazon ECS 容器代理写入配置信息的用户数据 Shell 脚本合并。

如果您使用的是 AWS CloudFormation，AWS::CloudFormation::Init 类型可以与 cfn-init 帮助程序脚本一起使用，以执行常见的配置方案。

MIME 分段文件包含以下组成部分：

  • 内容类型和段边界声明：Content-Type: multipart/mixed; boundary="==BOUNDARY=="

  • MIME 版本声明：MIME-Version: 1.0

  • 一个或多个用户数据块，其包含以下组成部分：

    • 开口边界，表示用户数据块的开头：--==BOUNDARY==

    • 数据块的内容类型声明：Content-Type: text/cloud-config; charset="us-ascii"。有关内容类型的更多信息，请参阅 Cloud-Init 文档。

    • 用户数据的内容，例如，Shell 命令或 cloud-init 指令的列表

  • 封闭边界，表示 MIME 分段文件的结尾：--==BOUNDARY==--

以下是一些示例 MIME 分段文件，您可以使用它们来创建您自己的文件。

注意

如果将用户数据添加到 Amazon EC2 控制台中的启动模板，则可以将其作为纯文本粘贴或从文件进行上载。如果您使用 AWS CLI 或 AWS 开发工具包，则必须先对用户数据进行 base64 编码，并在调用 CreateLaunchTemplate 时将该字符串作为 UserData 参数值提交，如下面的 JSON 中所示。 

{
    "LaunchTemplateName": "base64-user-data",
    "LaunchTemplateData": {
        "UserData": "ewogICAgIkxhdW5jaFRlbXBsYXRlTmFtZSI6ICJpbmNyZWFzZS1jb250YWluZXItdm9sdW..."
    }
}

示例：挂载现有 Amazon EFS 文件系统

此示例 MIME 分段文件将配置计算资源以安装 amazon-efs-utils 程序包并在 /mnt/efs 处装载现有 Amazon EFS 文件系统。 

MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: text/cloud-config; charset="us-ascii"

packages:
- amazon-efs-utils

runcmd:
- file_system_id_01=fs-abcdef123
- efs_directory=/mnt/efs

- mkdir -p ${efs_directory}
- echo "${file_system_id_01}:/ ${efs_directory} efs tls,_netdev" >> /etc/fstab
- mount -a -t efs defaults

--==MYBOUNDARY==--

示例：覆盖默认 Amazon ECS 容器代理配置

此示例 MIME 分段文件将覆盖计算资源的默认 Docker 映像清除设置。

MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: text/x-shellscript; charset="us-ascii"

#!/bin/bash
echo ECS_IMAGE_CLEANUP_INTERVAL=60m >> /etc/ecs/ecs.config
echo ECS_IMAGE_MINIMUM_CLEANUP_AGE=60m >> /etc/ecs/ecs.config

--==MYBOUNDARY==--

示例：挂载现有 Amazon FSx for Lustre 文件系统

此示例 MIME 分段文件将配置计算资源，以从 Extras 库安装 lustre2.10 程序包，并在 /scratch 处装载现有 Amazon FSx for Lustre 文件系统。此示例适用于 Amazon Linux 2。有关其他 Linux 发行版的安装说明，请参阅Amazon FSx for Lustre 用户指南中的安装 Lustre 客户端 。 

MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: text/cloud-config; charset="us-ascii"

runcmd:
- file_system_id_01=fs-0abcdef1234567890
- region=us-east-2
- fsx_directory=/scratch
- amazon-linux-extras install -y lustre2.10
- mkdir -p ${fsx_directory}
- mount -t lustre ${file_system_id_01}.fsx.${region}.amazonaws.com@tcp:fsx ${fsx_directory}

--==MYBOUNDARY==--

在容器属性的 volumes 和 mountPoints 成员中，装载点必须映射到容器中。 

{
    "volumes": [
        {
            "host": {
                "sourcePath": "/scratch"
            },
            "name": "Scratch"
        }
    ],
    "mountPoints": [
        {
            "containerPath": "/scratch",
            "sourceVolume": "Scratch"
        }
    ],
}