Azure生产环境下ASP.Net Core+PostgreSQL应用的EF Core数据库迁移最佳实践及CI/CD部署方案咨询

我来帮你梳理下Azure环境下适配EF Core的生产数据库迁移流程，结合你提到的CI/CD需求，分享几个实际落地的方案：

1. 先把EF迁移转换成生产友好的SQL脚本 #

你已经知道运行时Database.Migrate()不适合生产，第一步就是把EF的C#迁移文件转换成可审计、可测试的SQL脚本。用EF CLI命令生成：

dotnet ef migrations script --output ./migrations/20240520_AddUserTable.sql --idempotent --project YourProjectName --startup-project YourStartupProjectName

• --idempotent是关键：生成的脚本会自动检查迁移是否已经应用过，避免重复执行，完全适配生产环境的增量部署需求。
• 如果只需要生成特定版本之间的迁移，加上--from和--to参数即可，比如--from 20240510_AddProductTable --to 20240520_AddUserTable。

生成脚本后，先在Azure PostgreSQL的测试实例上跑一遍，验证语法和数据兼容性，没问题再进入CI/CD流程。

2. 在CI/CD流水线中自动化应用迁移脚本 #

不管你用Azure DevOps Pipeline还是GitHub Actions，都能轻松集成迁移步骤，这里给两个常见场景的示例：

用Azure DevOps Pipeline的情况 #

添加一个「Azure CLI」任务，直接调用psql命令执行脚本：

- task: AzureCLI@2
  displayName: 'Apply Production DB Migration'
  inputs:
    azureSubscription: '你的Azure服务连接名'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      psql "host=your-postgres-server.postgres.database.azure.com port=5432 dbname=your-prod-db user=admin@your-postgres-server password=$(ProdDbPassword) sslmode=require" -f ./migrations/20240520_AddUserTable.sql

注意：$(ProdDbPassword)要存在Azure DevOps的变量组里，设置为保密变量，绝对不能明文写在脚本里。

用GitHub Actions的情况 #

可以直接用官方的Azure/postgresql动作，简化连接和执行：

- name: Apply Production DB Migration
  uses: Azure/postgresql@v1
  with:
    connection-string: ${{ secrets.AZURE_POSTGRESQL_PROD_CONNECTION_STRING }}
    sql-file: ./migrations/20240520_AddUserTable.sql

这里的连接字符串存在GitHub的Secrets中，确保敏感信息不泄露。

3. Azure辅助服务提升迁移安全性 #

虽然Azure没有专门的"EF迁移服务"，但有几个工具能帮你更可控地管理生产迁移：

• Azure Database for PostgreSQL - 弹性服务器：支持只读副本，你可以先在副本上测试迁移脚本，验证性能和正确性，确认没问题再应用到主库。
• Azure DevOps 发布门限：在生产部署迁移脚本前，设置门限（比如检查预生产环境迁移成功、监控指标正常），避免有风险的变更直接上生产。
• Azure 自动备份：迁移前手动触发一次全量备份，虽然Azure PostgreSQL有自动备份，但额外的手动备份能给你多一层保障。

4. 生产迁移的最佳实践 #

最后再提几个踩过坑的经验：

• 预生产环境一定要完全复刻生产的配置（数据库版本、数据量、索引），否则测试通过的脚本到生产可能出问题。
• 大版本迁移（比如涉及大表结构变更）尽量选择低峰期执行，或者分阶段：先迁移结构，再迁移关联数据，减少锁表时间。
• 迁移后立刻检查数据库状态，比如直接查询__EFMigrationsHistory表确认迁移是否完全应用，或者用本地EF CLI执行dotnet ef database update --dry-run验证状态。

内容的提问来源于stack exchange，提问作者Edouard Berthe