使用 docker Compose 编排 .NET 微服务需为每个服务编写 Dockerfile 并在 docker-compose.yml 中定义服务依赖、网络和端口映射，通过服务名实现通信，结合健康检查确保启动顺序，适合本地开发测试环境快速搭建。

在 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 base AS final
WORKDIR /app
COPY –from=publish /app/publish .
ENTRYPOINT [“dotnet”, “OrderService.dll”]

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

编写 docker-compose.yml 编排文件

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

version: ‘3.8’

volumes:
  sql_data:

关键点说明：

简篇AI排版

AI排版工具，上传图文素材，秒出专业效果！

134

查看详情

• 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 微服务在本地运行变得简单可控，适合快速搭建开发环境。关键是每个服务独立构建，通过统一编排实现协同工作。