在 Docker Compose 中如何编排 .NET 微服务?

来源:这里教程网 时间:2026-02-21 17:28:56 作者:

在 Docker Compose 中编排 .NET 微服务,核心是将多个独立的 .NET 服务容器化,并通过 docker-compose.yml 文件定义它们的服务依赖、网络通信、端口映射和启动顺序。这种方式非常适合本地开发和测试微服务架构。

准备每个 .NET 服务的 Dockerfile

每个微服务项目根目录下都需要一个 Dockerfile,用于构建镜像。以一个典型的 ASP.NET Core 服务为例:

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY . .
RUN dotnet restore "Services/OrderService/OrderService.csproj"
RUN dotnet publish "Services/OrderService/OrderService.cspj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "OrderService.dll"]

确保每个服务都有独立的 Dockerfile,并能单独构建成功。

编写 docker-compose.yml 编排文件

在项目根目录创建 docker-compose.yml,定义所有微服务及其配置:

version: '3.8'

services:
  orderservice:
    build:
      context: .
      dockerfile: Services/OrderService/Dockerfile
    ports:
      - "5001:80"
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
    depends_on:
      - databases

  paymentservice:
    build:
      context: .
      dockerfile: Services/PaymentService/Dockerfile
    ports:
      - "5002:80"
    depends_on:
      - orderservice

  databases:
    image: mcr.microsoft.com/mssql/server:2022-latest
    environment:
      - SA_PASSWORD=YourStrong@Passw0rd
      - ACCEPT_EULA=Y
    ports:
      - "1433:1433"
    volumes:
      - sql_data:/var/opt/mssql

volumes:
  sql_data:

关键点说明:

build.context 指定构建上下文,通常为项目根目录 depends_on 控制服务启动顺序,但不等待应用就绪(需额外健康检查) 通过 ports 将服务暴露到主机,便于调试 使用 environment 设置环境变量,如连接字符串可在此传入 数据库等依赖服务也一并纳入编排,提升环境一致性

处理服务间通信

微服务之间通过服务名进行通信。例如,PaymentService 调用 OrderService 的 API:

在代码中使用 http://orderservice:80/api/orders 作为请求地址 Docker Compose 会自动通过内置 DNS 解析服务名 生产环境建议配合反向代理(如 Nginx)或服务网格,开发阶段直接调用即可

若需等待某个服务完全启动,可在 docker-compose.yml 中添加健康检查:

orderservice:
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:80/health"]
    interval: 10s
    timeout: 5s
    retries: 10

启动与管理服务

在命令行执行以下命令:

docker compose up --build:构建镜像并启动所有服务 docker compose down:停止并清理容器 docker compose logs -f paymentservice:查看特定服务日志

支持多环境配置,可通过 docker-compose.override.yml 定义开发专用设置,主文件保留通用配置。

基本上就这些。Docker Compose 让 .NET 微服务在本地运行变得简单可控,适合快速搭建开发环境。关键是每个服务独立构建,通过统一编排实现协同工作。

相关推荐