无.NET Core SDK环境下部署带EF迁移的.NET 7类库项目

一、修复dotnet publish的runtime缺失问题 #

你遇到的Microsoft.NETCore.App.Runtime.linux-x64找不到的错误，本质是自包含发布无法自动下载对应runtime包。按以下步骤解决：

• 在有网络且安装了.NET7 SDK的机器上，提前下载所有依赖包（含runtime）：

  dotnet publish -c Release -r linux-x64 --self-contained true --no-build --output ./temp-publish --download-packages-to ./local-packages
  

  执行后，local-packages文件夹会包含所有所需的NuGet包和runtime文件。
• 将local-packages文件夹与项目代码一同复制到隔离环境的Linux机器。
• 在隔离环境中，指定本地包源执行发布：

  dotnet publish -c Release -r linux-x64 --self-contained true --source ./local-packages
  

二、无SDK环境下运行EF Core迁移 #

EF Core工具依赖SDK，但可通过两种方式在隔离环境执行迁移：

方式1：打包自包含EF Core工具 #

在有SDK的联网机器上操作：

1. 创建临时控制台项目用于封装EF工具：

   dotnet new console -n EFToolBundle
   cd EFToolBundle
   

2. 添加EF工具和Npgsql依赖：

   dotnet add package Microsoft.EntityFrameworkCore.Tools
   dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL
   

3. 发布为linux-x64自包含程序：

   dotnet publish -c Release -r linux-x64 --self-contained true --output ./self-contained-ef
   

4. 将self-contained-ef文件夹复制到隔离环境。
5. 在隔离环境的项目目录下，用该工具执行迁移：

   ../self-contained-ef/EFToolBundle.dll ef migrations add InitialCreate --project ./YourNpgsqlLib.csproj
   ../self-contained-ef/EFToolBundle.dll ef database update --project ./YourNpgsqlLib.csproj
   

   提示：若需指定连接字符串，可添加--connection "你的PostgreSQL连接串"参数，或确保项目目录下存在正确的配置文件（如appsettings.json）。

方式2：嵌入迁移执行逻辑到项目 #

无需单独打包EF工具，直接通过项目代码执行迁移：

1. 在你的Npgsql类库项目中添加迁移执行类：

   using Microsoft.EntityFrameworkCore;
   
   namespace YourNpgsqlLibrary
   {
       public static class DbMigrationExecutor
       {
           public static void ApplyMigrations(string connectionString)
           {
               var options = new DbContextOptionsBuilder<YourDbContext>()
                   .UseNpgsql(connectionString)
                   .Options;
   
               using var dbContext = new YourDbContext(options);
               dbContext.Database.Migrate();
           }
       }
   }
   

2. 创建控制台项目作为迁移启动器，引用你的类库：

   dotnet new console -n MigrationBootstrapper
   cd MigrationBootstrapper
   dotnet add reference ../YourNpgsqlLibrary/YourNpgsqlLibrary.csproj
   

3. 在Program.cs中调用迁移方法：

   using YourNpgsqlLibrary;
   
   // 可从配置文件读取连接串，此处为示例
   var connectionString = "Host=localhost;Database=YourDb;Username=postgres;Password=yourpwd";
   DbMigrationExecutor.ApplyMigrations(connectionString);
   

4. 发布为linux-x64自包含程序：

   dotnet publish -c Release -r linux-x64 --self-contained true --output ./migration-executor
   

5. 将migration-executor复制到隔离环境，赋予执行权限后运行：

   chmod +x ./migration-executor/MigrationBootstrapper
   ./migration-executor/MigrationBootstrapper
   

三、关键注意事项 #

• 确保联网机器下载的包与.NET7版本完全匹配，避免兼容性冲突。
• Linux环境下需给自包含程序添加执行权限（如上述chmod命令）。
• 验证连接字符串的正确性，确保隔离环境能访问目标PostgreSQL数据库。

内容的提问来源于stack exchange，提问作者Ehud Grand