在AWS ECS部署Laravel应用后，如何仅让单个任务执行数据库迁移

下面是几种实用的实现方式，根据你的运维习惯选择即可：

1. 手动触发一次性任务执行迁移 #

部署完成后，直接在ECS控制台创建独立的一次性任务来跑迁移：

• 进入目标ECS集群，点击「运行任务」
• 任务定义选择和服务一致的版本，将容器命令替换为 php artisan migrate --force（--force 用于跳过生产环境的交互确认）
• 配置匹配服务的网络、IAM角色（确保任务有权限访问数据库），启动任务
• 该任务执行完成后会自动停止，不会加入服务的常驻任务池，完全独立于那4个服务任务

2. 服务启动时通过分布式锁控制单次执行 #

修改Laravel容器的启动脚本（比如entrypoint.sh），加入分布式锁逻辑，确保同一时间只有一个任务执行迁移：

# 示例entrypoint.sh核心逻辑
# 用Redis实现分布式锁，锁超时30秒防止异常残留
if redis-cli setnx migrate_lock "acquired" && redis-cli expire migrate_lock 30; then
    php artisan migrate --force
    redis-cli del migrate_lock
fi

# 启动正常的应用服务
exec php-fpm # 替换为你的应用启动命令（如apache2-foreground）

• 这种方式无需手动操作，但需要确保所有任务都能访问Redis，且锁的过期时间设置合理（覆盖迁移的最长执行时间）

3. 结合初始化容器+分布式锁 #

在ECS任务定义中添加初始化容器，专门处理迁移逻辑，同时配合锁避免重复执行：

• 新增一个初始化容器，命令设为 php artisan migrate --force，配置和主容器一致的环境变量、网络权限
• 在初始化容器的启动脚本中加入和方案2相同的分布式锁逻辑
• 主容器会等待初始化容器执行完成后再启动，确保迁移完成后才提供服务

关键注意事项 #

• 所有执行迁移的方式都必须加 --force 参数，否则Laravel在生产环境会要求交互确认，导致任务卡住
• 确保执行迁移的任务拥有数据库访问权限（IAM角色权限、安全组规则、VPC网络连通性）
• 分布式锁方案要考虑异常场景（比如任务中途崩溃），设置合理的锁过期时间避免锁残留

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