如何部署含数据库表及数据的ASP.NET Core应用至Azure及其他环境

一、解决dotnet ef migrations bundle打包失败 #

GitHub Actions环境看不到详细错误，先从本地排查：

• 本地执行dotnet ef migrations bundle --self-contained -r <目标运行时>（例如linux-x64，匹配Azure App Service的操作系统），查看本地报错详情。
• 检查项目依赖：确保Microsoft.EntityFrameworkCore.Tools和Microsoft.EntityFrameworkCore.Design包版本与EF Core主包一致，且已正确安装。
• 在GitHub Actions的构建步骤中添加--verbose参数输出详细日志，比如：

- name: Build migration bundle
  run: dotnet ef migrations bundle --verbose --self-contained -r linux-x64

二、将LocalDB的表与数据部署到Azure #

1. 导出LocalDB数据与结构 #

• 用SQL Server Management Studio（SSMS）连接LocalDB实例（通常为(localdb)\MSSQLLocalDB），右键目标数据库 → 任务→生成脚本。
• 选择"整个数据库"，勾选"编写数据的脚本"选项，生成完整的SQL脚本文件。

2. 在Azure配置SQL数据库 #

• 登录Azure门户，创建Azure SQL数据库，保存其连接字符串。
• 进入Azure SQL数据库的查询编辑器，执行刚才生成的SQL脚本，完成表结构与数据的导入。

3. 配置应用连接字符串 #

• 在Azure App Service的配置→应用程序设置中，添加与本地appsettings.json同名的连接字符串（如DefaultConnection），值填入Azure SQL的连接字符串。

4. 替代方案：启动时自动执行迁移 #

如果bundle方式仍有问题，可在Program.cs中添加自动迁移逻辑（生产环境建议先备份数据）：

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<YourDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

var app = builder.Build();

// 应用迁移
using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
    dbContext.Database.Migrate();
}

// 其他中间件配置...
app.Run();

三、部署到其他托管环境 #

1. IIS部署 #

• 导出LocalDB的SQL脚本，在目标SQL Server（本地或远程）执行脚本导入数据与结构。
• 发布应用到IIS，在站点的高级设置或发布后的appsettings.json中修改连接字符串为目标SQL的信息。
• 确保目标服务器已安装ASP.NET Core托管捆绑包。

2. Docker部署 #

• 用Docker Compose配置SQL服务（如mssql-server-linux镜像），启动时自动执行导入数据的SQL脚本。
• 应用容器的连接字符串指向Docker内部的SQL服务，可在docker-compose.yml中配置环境变量。
• 可选择在应用启动时执行Migrate()或提前生成迁移脚本在SQL容器中执行。

3. 第三方主机（如DigitalOcean、GoDaddy） #

• 利用主机提供的SQL数据库管理工具，导入LocalDB导出的SQL脚本。
• 发布应用到主机，将连接字符串配置为主机SQL数据库的信息。
• 确认主机支持当前ASP.NET Core版本，已安装对应运行时。

四、实用参考方向 #

• EF Core迁移：重点掌握dotnet ef migrations script生成迁移脚本、Database.Migrate()的适用场景与风险。
• Azure SQL导入：Azure门户的SQL数据库支持直接从LocalDB备份文件（.bak）导入，可简化数据迁移流程。
• App Service部署：Azure部署中心的GitHub关联向导，可添加自定义构建步骤来执行迁移或数据导入脚本。

内容的提问来源于stack exchange，提问作者David Bahler