如何为AWS EC2实例实现自定义配置？UserData执行无反馈求解

一、用户数据的核心执行逻辑 #

AWS EC2的用户数据脚本**仅在实例首次启动（或启用重新运行时的每次重启）**执行，和GCP的预/后配置脚本逻辑存在差异：

• GCP明确区分预配置（实例启动前）和后配置（实例启动后）脚本，EC2的用户数据默认由cloud-init服务在实例启动后执行，属于后配置范畴。
• 脚本执行日志默认存储在/var/log/cloud-init-output.log，这是排查的核心入口——脚本以root用户后台执行，不会出现在普通用户的命令历史中。

二、你的脚本存在的问题 #

你提供的脚本有几处明显错误，导致无法正常执行：

export ENV=test
sudo yum update -y
sudo yum install docker -y

aws s3 cp s3://app-deployment-my-app/ec2-runner-$ENV.sh ec2-runner.sh
sudo systemctl start docker
sudo sh ec2-runner.sh  # 先执行脚本，但未提前赋予执行权限
sudo chmod +x ec2-runner.sh  # 权限赋予顺序颠倒
sudo /bin/bash -c 'echo "*/5 * * * * ec2-user sh /home/ec2-user/ec2-runner.sh" >> /etc/crontab'
sudo systemctl restart crond.service

错误点：

1. 权限顺序颠倒：先执行脚本再赋予执行权限，虽用sh调用无需执行权限，但逻辑不合理，若脚本含#!/bin/bash头可能触发异常。
2. 环境变量作用域有限：export ENV=test仅在当前shell会话有效，crontab中的脚本无法继承该变量，建议直接写死或在crontab中显式定义。
3. AWS CLI权限缺失：默认ec2-user无S3访问权限，需给实例附加含s3:GetObject权限的IAM角色，而非依赖本地配置。

三、修正后的脚本示例 #

#!/bin/bash
# 显式指定shell，避免cloud-init使用默认shell引发问题

# 定义环境变量，确保后续步骤可直接引用
ENV=test

# 安装安全更新与依赖
yum update -y
yum install docker -y

# 设置docker开机自启并启动服务
systemctl enable docker
systemctl start docker

# 下载脚本（需实例附加具备S3访问权限的IAM角色）
aws s3 cp s3://app-deployment-my-app/ec2-runner-${ENV}.sh /home/ec2-user/ec2-runner.sh

# 先赋予权限再执行脚本
chmod +x /home/ec2-user/ec2-runner.sh
sh /home/ec2-user/ec2-runner.sh

# 配置crontab，指定完整路径避免环境变量问题
echo "*/5 * * * * ec2-user /bin/sh /home/ec2-user/ec2-runner.sh" >> /etc/crontab
systemctl restart crond.service

四、确保脚本执行的关键步骤 #

1. 查看cloud-init日志：登录实例后执行cat /var/log/cloud-init-output.log，直接查看脚本执行的报错信息。
2. 启用重新运行用户数据（可选）：若需每次重启都执行脚本，可修改/etc/cloud/cloud.cfg中的preserve_hostname: false及cloud_init_modules配置，或通过启动实例的API参数设置。
3. 配置IAM角色：给EC2实例附加IAM角色，授予目标S3桶的s3:GetObject权限，解决AWS CLI权限不足问题。
4. 添加shebang头：脚本第一行必须添加#!/bin/bash或#!/bin/sh，确保cloud-init使用正确的shell执行。

五、与其他云平台的差异 #

• GCP：区分预启动（实例创建过程中）和后启动（实例启动后）脚本，预启动脚本可修改实例底层配置；EC2无预启动阶段的自定义脚本，仅能通过自定义AMI实现类似效果。
• Azure：与EC2逻辑类似，通过自定义数据（Custom Data）由cloud-init执行，但日志路径为/var/log/cloud-init.log。
• 共性：均通过云初始化服务执行脚本，但各平台的日志位置、执行时机、权限模型存在细微差异。

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