如何在Terraform创建的Elastic Beanstalk中添加user_data初始化命令

你当前通过Terraform创建了关联RDS的Elastic Beanstalk（EB）环境，但EB自动创建的EC2实例无法直接配置user_data，需要在实例启动时执行数据库初始化脚本（进入应用目录、激活虚拟环境、安装依赖、运行db.create_all()），可以通过以下两种方法实现：

方法一：使用EB的.ebextensions配置文件（推荐） #

EB允许通过应用包内的.ebextensions配置文件定义实例启动或应用部署时的操作，这是官方推荐的方式，能更好地适配EB的部署流程。

步骤： #

1. 在你的应用代码根目录创建.ebextensions文件夹
2. 在该文件夹下新建配置文件（比如01-init-db.config），写入以下内容：

container_commands:
  01_init_db:
    command: |
      #!/bin/bash
      cd /var/app/current
      # 创建并激活虚拟环境，若已存在则跳过
      virtualenv env || true
      source env/bin/activate
      # 安装依赖
      pip install -r requirements.txt
      # 执行数据库初始化命令
      python3 -c "from application import db; db.create_all()"
    leader_only: true  # 仅在集群领头实例执行一次，避免重复初始化数据库

说明： #

• container_commands会在应用代码部署到/var/app/current后执行，刚好匹配你的脚本需求
• leader_only: true确保数据库初始化只执行一次，避免多实例重复操作导致的问题
• 将.ebextensions目录与应用代码一起打包，部署到EB环境即可，EB会自动执行该脚本

方法二：通过Terraform配置EB实例的UserData #

直接在Terraform的EB环境资源中，通过aws:autoscaling:launchconfiguration命名空间配置EC2实例的UserData，让实例启动时执行初始化脚本。

步骤： #

1. 修改你的初始化脚本initialize_db.sh，增加等待应用部署完成的逻辑（因为实例启动时EB还未部署应用到/var/app/current）：

#!/bin/bash
# 等待应用目录创建完成，最多等待5分钟
for i in {1..30}; do
  if [ -d /var/app/current ]; then
    break
  fi
  sleep 10
done

# 进入应用目录并执行初始化
cd /var/app/current
virtualenv env
source env/bin/activate
pip install -r requirements.txt
python3 -c "from application import db; db.create_all()"

2. 在Terraform的aws_elastic_beanstalk_environment资源中添加以下setting配置：

resource "aws_elastic_beanstalk_environment" "beanstalkappenv" {
  # 原有的配置...

  # 添加UserData配置
  setting {
    namespace = "aws:autoscaling:launchconfiguration"
    name      = "UserData"
    value     = base64encode(file("initialize_db.sh"))
  }
}

说明： #

• UserData需要用base64encode编码后传入，这是EC2 UserData的要求
• 脚本中的循环等待逻辑是为了确保EB完成应用部署后再执行初始化操作

注意事项 #

• 数据库连接配置：EB会自动将关联RDS的连接信息注入到实例的环境变量中（如RDS_HOSTNAME、RDS_PORT、RDS_USERNAME、RDS_PASSWORD、RDS_DB_NAME），你的应用代码应通过这些环境变量获取数据库连接信息，不要硬编码
• 权限配置：确保EB的EC2实例角色（aws-elasticbeanstalk-ec2-role）拥有访问RDS数据库的权限
• 避免重复初始化：无论哪种方法，都要确保数据库初始化脚本只执行一次，防止重复创建表等问题
• 虚拟环境适配：部分EB Python解决方案栈自带虚拟环境（如/opt/python/run/venv），可根据实际环境调整脚本中的虚拟环境路径

内容的提问来源于stack exchange，提问作者Mike D Hovhannisyan