在启动模板中使用 Amazon Systems Manager 参数代替 AMI ID

通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。

在导航窗格中，选择启动模板，然后选择创建启动模板。

对于设备模板名称，请为您的启动模板输入描述性名称。

在 Application and OS Images (Amazon Machine Image) [应用程序和操作系统镜像（Amazon 机器映像）] 下，选择 Browse more AMIs（浏览其他 AMI）。

选择搜索栏右侧的箭头按钮，然后选择指定自定义值/Systems Manager 参数。

在指定自定义值或 Systems Manager 参数对话框中，执行以下操作：

1. 对于 AMI ID 或 Systems Manager 参数字符串，使用以下格式之一输入 Systems Manager 参数名称：

   • resolve:ssm:parameter-name

   • resolve:ssm:parameter-name:version-number

   • resolve:ssm:parameter-name:label

   • resolve:ssm:public-parameter

2. 选择 Save（保存）。

根据需要指定任何其他启动模板参数，然后选择创建启动模板。

使用以下语法：resolve:ssm:parameter-name，其中 resolve:ssm 是标准前缀，parameter-name 是 Systems Manager 参数名称。

以下示例可创建一个从名为 golden-ami 的现有 Systems Manager 参数获取 AMI ID 的启动模板。

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling \
  --launch-template-data file://config.json

config.json 的内容：

{ 
    "ImageId":"resolve:ssm:golden-ami",
    "InstanceType":"t2.micro"
}

如果未指定，则参数的默认版本为最新版本。

以下示例引用 golden-ami 参数的特定版本。该示例使用 golden-ami 参数的版本 3，但您可以使用任何有效的版本号。

{ 
    "ImageId":"resolve:ssm:golden-ami:3",
    "InstanceType":"t2.micro"
}

以下类似示例引用了映射到 golden-ami 参数特定版本的参数标签 prod。

{ 
    "ImageId":"resolve:ssm:golden-ami:prod",
    "InstanceType":"t2.micro"
}

下面是示例输出。

{
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-068f72b724example",
        "LaunchTemplateName": "my-template-for-auto-scaling",
        "CreateTime": "2022-12-27T17:11:21.000Z",
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "DefaultVersionNumber": 1,
        "LatestVersionNumber": 1
    }
}

要确认启动模板获得的 AMI ID 是否为首选，请使用 describe-launch-template-versions 命令。该命令使用 --resolve-alias 选项将参数解析为实际的 AMI ID。

aws ec2 describe-launch-template-versions --launch-template-name my-template-for-auto-scaling \
   --versions $Default --resolve-alias

该示例返回 ImageId 的 AMI ID。使用此启动模板启动实例时，AMI ID 解析为 ami-04d5cc9b88example。

{
    "LaunchTemplateVersions": [
        {
            "LaunchTemplateId": "lt-068f72b724example",
            "LaunchTemplateName": "my-template-for-auto-scaling",
            "VersionNumber": 1,
            "CreateTime": "2022-12-27T17:11:21.000Z",
            "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
            "DefaultVersion": true,
            "LaunchTemplateData": {
                "ImageId": "ami-04d5cc9b88example",
                "InstanceType": "t2.micro"
            }
        }
    ]
}

请使用以下语法：resolve:ssm:public-parameter，其中 resolve:ssm 是标准前缀，public-parameter 是公有参数的路径和名称。

在此示例中，启动模板使用 Amazon 提供的公有参数，使用在 Amazon Web Services 区域 中为您的配置文件配置的最新 Amazon Linux 2 AMI 启动实例。

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data file://config.json

config.json 的内容：

{ 
    "ImageId":"resolve:ssm:/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2",
    "InstanceType":"t2.micro"
}

以下为响应示例。

{
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-089c023a30example",
        "LaunchTemplateName": "my-template-for-auto-scaling",
        "CreateTime": "2022-12-28T19:52:27.000Z",
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "DefaultVersionNumber": 1,
        "LatestVersionNumber": 1
    }
}

要确认启动模板获得的 AMI ID 是否正确，请使用 describe-launch-template-versions 命令。该命令使用 --resolve-alias 选项将参数解析为实际的 AMI ID。

aws ec2 describe-launch-template-versions --launch-template-name my-template-for-auto-scaling \
   --versions $Default --resolve-alias

该示例返回 ImageId 的 AMI ID。使用此启动模板启动实例时，AMI ID 解析为 ami-0ac394d6a3example。

{
    "LaunchTemplateVersions": [
        {
            "LaunchTemplateId": "lt-089c023a30example",
            "LaunchTemplateName": "my-template-for-auto-scaling",
            "VersionNumber": 1,
            "CreateTime": "2022-12-28T19:52:27.000Z",
            "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
            "DefaultVersion": true,
            "LaunchTemplateData": {
                "ImageId": "ami-0ac394d6a3example",
                "InstanceType": "t2.micro",
            }
        }
    ]
}