Azure容器应用服务中EF数据库迁移的Docker部署方案咨询

最优方案：修改Dockerfile实现运行时迁移执行 #

因为你的限制是只能依赖Docker镜像运行时完成迁移，且要保留Visual Studio生成的基础镜像，这个方案最贴合需求，步骤如下：

1. 在运行阶段安装SqlCmd.exe #

针对Windows Server基础镜像，可通过Chocolatey快速安装SqlCmd，在Dockerfile的运行阶段（base阶段）添加以下命令：

# 安装Chocolatey包管理器并安装SqlCmd
RUN Set-ExecutionPolicy Bypass -Scope Process -Force; \
    [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; \
    iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')); \
    choco install sqlcmd -y --no-progress

2. 编写启动脚本（PowerShell） #

创建startup.ps1脚本，先执行数据库迁移，验证成功后再启动Web应用，自动从环境变量读取连接字符串：

# 从环境变量获取数据库连接字符串
$connectionString = $env:DB_CONNECTION_STRING

# 执行迁移脚本，-b参数确保迁移失败时返回非0退出码
sqlcmd -ConnectionString "$connectionString" -i "migration.sql" -b

# 检查迁移执行结果
if ($LASTEXITCODE -eq 0) {
    Write-Host "数据库迁移执行成功，启动Web应用..."
    # 替换为你的Web应用启动命令，例如dotnet启动命令
    dotnet YourWebApp.dll
} else {
    Write-Error "数据库迁移失败，退出码：$LASTEXITCODE"
    exit $LASTEXITCODE
}

3. 更新Dockerfile的入口配置 #

将Dockerfile的ENTRYPOINT或CMD改为执行上述启动脚本，同时确保从构建阶段复制migration.sql到运行目录：

# 从构建阶段复制生成的迁移脚本
COPY --from=build /app/migration.sql .

# 复制启动脚本
COPY startup.ps1 .

# 设置入口点为PowerShell执行启动脚本
ENTRYPOINT ["powershell", "-Command", "./startup.ps1"]

4. 配置Azure App Service环境变量 #

在ARM模板中为Web App添加DB_CONNECTION_STRING环境变量，值为你的数据库连接字符串，确保容器运行时能读取到该变量。

其他方案的利弊分析 #

方案2：Docker Compose预览功能 #

• 问题：该功能处于预览阶段，不提供生产环境SLA，且ARM模板配置多容器Web App的复杂度更高，迁移容器的生命周期管理（如仅执行一次迁移）需要额外逻辑，风险较高，不建议用于生产。

方案3：应用内部执行迁移 #

• 问题：违背微软官方最佳实践，会导致以下风险：
  • 多实例部署时可能出现并发迁移冲突
  • 迁移耗时过长导致应用启动超时
  • 迁移失败直接导致应用无法启动，排查难度大
    生产环境绝对不推荐此方案。

方案4：部署时PowerShell脚本 #

• 问题：你明确无法手动编辑GitHub Actions文件，而ARM模板的自定义脚本扩展需要额外配置，且依赖Azure资源部署的时机，可靠性不如镜像内运行时处理，因此该方案不可行。

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