ASP.NET Core .NET 6多RCL按国家部署条件引入方案咨询

一、本地/单实例打包：用条件引用+环境配置搞定 #

1. 给RCL添加条件引用 #

直接修改主MVC应用的.csproj文件，将各国RCL的引用设置为条件性引入，只有指定国家构建参数生效时才会加载：

<!-- 电商引擎类库始终保留引用 -->
<ProjectReference Include="..\EcommerceEngine\EcommerceEngine.csproj" />

<!-- 仅当BuildCountry参数为CN时，引用中国区RCL -->
<ProjectReference Include="..\EcommerceRCL-CN\EcommerceRCL-CN.csproj" Condition="'$(BuildCountry)' == 'CN'" />

<!-- 仅当BuildCountry参数为US时，引用美国区RCL -->
<ProjectReference Include="..\EcommerceRCL-US\EcommerceRCL-US.csproj" Condition="'$(BuildCountry)' == 'US'" />

2. VS2022快速切换构建配置 #

• 右键主项目→属性→生成，在“命令行”的附加参数中添加/p:BuildCountry=CN，即可仅打包中国区RCL；
• 若需频繁切换，可在解决方案配置管理器中新建专属配置（如Release-CN、Release-US），每个配置绑定对应的BuildCountry参数，切换配置即可自动适配。

3. 数据库连接字符串隔离 #

为每个国家单独创建配置文件，比如appsettings.CN.json：

{
  "ConnectionStrings": {
    "EcommerceDb": "Server=cn-db;Database=Ecommerce_CN;Trusted_Connection=True;"
  }
}

部署时设置环境变量ASPNETCORE_ENVIRONMENT=CN，程序会自动加载对应国家的数据库配置。

二、GitLab流水线自动化部署 #

1. 配置流水线变量 #

在GitLab项目的设置→CI/CD→变量中添加BUILD_COUNTRY变量，可选值设为CN、US等，手动触发流水线时可选择对应国家。

2. 编写.gitlab-ci.yml脚本 #

根据BUILD_COUNTRY参数动态打包部署，示例如下：

stages:
  - build
  - deploy

build:
  stage: build
  image: mcr.microsoft.com/dotnet/sdk:6.0
  script:
    - dotnet clean
    # 传入国家参数，仅打包对应RCL
    - dotnet publish YourMvcApp.csproj -c Release -o publish /p:BuildCountry=$BUILD_COUNTRY
  artifacts:
    paths:
      - publish/

deploy:
  stage: deploy
  # 替换为你使用的部署工具镜像，如Azure CLI、Docker等
  image: mcr.microsoft.com/azure-cli:latest
  script:
    # 示例：部署到对应国家的App Service实例
    - az webapp deploy --resource-group YourResourceGroup --name YourApp-$BUILD_COUNTRY --src-path publish/
  only:
    - main

触发流水线时选择目标国家，即可自动完成对应RCL的打包与部署，数据库配置也会自动匹配。

三、额外优化建议 #

• 将各国RCL的公共抽象接口提取到电商引擎类库，主应用仅依赖抽象而非具体实现，降低耦合度；
• RCL中的静态资源（如CSS、图片）会随条件引用自动打包，无需额外处理；
• 若未来需支持运行时切换国家，可考虑使用AssemblyLoadContext动态加载RCL，但当前按国家独立部署的场景下，条件构建已足够轻量高效。

内容的提问来源于stack exchange，提问作者Mark Coleman