如何在AWS CDK中为CfnLaunchTemplate添加UserData并绑定安全组

1. CfnLaunchTemplate UserData不生效问题 #

原因 #

• L1级别的CfnLaunchTemplate没有userAddData方法，该方法仅属于L2级别的ec2.LaunchTemplate构造，你之前的调用属于无效操作
• AWS EC2要求UserData必须为Base64编码后的字符串，直接传原始bash脚本内容不会生效

解决方案 #

import * as ec2 from 'aws-cdk-lib/aws-ec2';
import { readFileSync } from 'fs';

// 处理UserData
const bootScriptContent = readFileSync('./scripts/test.sh', 'utf8');
const userData = ec2.UserData.forLinux();
userData.addCommands(bootScriptContent);

// 创建启动模板
const launchTest = new ec2.CfnLaunchTemplate(this, "launchTest", {
  launchTemplateData: {
    imageId: AMI-test.valueAsString,
    instanceType: "t3a.medium",
    userData: userData.render(), // CDK会自动完成Base64编码，直接传入即可
    securityGroups: [launchTestSG.securityGroupId], // 此处同步兼容安全组绑定要求
    keyName: props.privateKey,
    iamInstanceProfile: {
      name: props.iamProfile
    }
  },
  launchTemplateName: "LT-Example",
})

注意：请确保你的test.sh头部包含#!/bin/bash shebang声明，避免脚本执行异常

2. 安全组绑定类型报错问题 #

原因 #

CfnLaunchTemplate的securityGroups字段要求传入安全组ID的字符串数组，你直接传入SecurityGroup构造对象会触发类型不匹配报错。

解决方案 #

取安全组实例的securityGroupId属性传入即可，参考上方代码中的securityGroups: [launchTestSG.securityGroupId]写法即可解决类型报错。

内容的提问来源于stack exchange，提问作者Dylan