实例自定义数据是什么
User Data 是创建实例时传入的初始化脚本或文本，由实例内的 cloud-init 在首次启动时读取并执行，用来安装软件、写配置、注册监控、加入集群。它是自动化交付的第一入口，适合轻量初始化；重型装机流程应该固化进自定义镜像，后续的配置变更交给配置管理工具。
基本信息
| 机制 | 创建实例时传入脚本或文本，首次启动由 cloud-init 执行 |
|---|---|
| 执行时机 | 默认仅首次启动执行；部分厂商支持每次启动执行的模式 |
| 查看方式 | 实例内 /var/lib/cloud/ 与 cloud-init 日志，控制台或 CLI 可查原始内容 |
| 长度限制 | 内容有大小上限，超长脚本应改为从对象存储拉取再执行 |
| 幂等要求 | 脚本必须可重入，重复执行不能破坏已有配置 |
| 适合范围 | 安装 Agent、挂盘、注册节点等轻量动作 |
典型使用场景
- 批量创建实例时统一安装监控与安全基线 Agent
- 自动识别并挂载数据盘、创建文件系统与挂载点
- 把实例注册进负载均衡后端或服务注册中心
- 写入环境标识、区域与业务参数，供应用启动时读取
- 拉取容器镜像并启动首个容器，完成一次性的初始部署
查看与排查
查看与排查
aliyun ecs DescribeUserData --InstanceId i-xxxx --RegionId cn-hangzhou # 查原始内容
cat /var/lib/cloud/instance/user-data.txt # 实例内看已下发的脚本
ls /var/lib/cloud/ # 查看 cloud-init 各阶段目录
grep -i error /var/log/cloud-init*.log # 查执行失败原因
sudo cloud-init status --long # 查看执行结果与耗时执行异常排查
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| 脚本完全没执行 | 镜像没有 cloud-init 或服务被禁用 | 确认镜像支持并检查日志中的执行记录 |
| 执行到中途退出 | 缺少错误处理，或网络尚未就绪 | 加 set -e 与重试，输出落盘便于回看 |
| 重启后配置被改回 | 脚本不幂等且被重复执行 | 写成可重入逻辑，或用标记文件控制只跑一次 |
| 内容被截断 | 脚本超过长度上限 | 改为拉取远端脚本执行，内容固化进镜像 |
| 凭据疑似外泄 | 把密钥写在脚本里 | 改用实例角色获取临时凭证，不留明文 |
User Data 适合轻量初始化：重型装机流程容易超时或被重复执行，务必写幂等脚本——先检测再修改，允许重复运行而不产生副作用，这是脚本能在重启、重试、重装场景下都安全的前提。
不要把密钥或访问令牌写进 User Data：控制台可查、实例元数据接口可读，任何能访问元数据的进程都能拿到，等同于把凭据公开。应改为给实例绑定角色并获取临时凭证。