使用 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 baseWORKDIR /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：
艾零三企业网站系统1.7 Build 120226
下载
艾零三（a03web）企业网站系统免费版，本系统特点为后台有可视化的用户控件引用功能，无需编程即可使用丰富的企业网站功能，此版本为免费版，无任何功能限制。 系统环境 asp.net2.0+access，发布包中包含一个微服务器环境，不需要装Microsoft .NET Framework v2.0 也可以访问网站。 艾零三（a03web）企业网站系统包含功能有： 网站单页资料模块：可在后台分组设立
- 在代码中使用 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 微服务在本地运行变得简单可控，适合快速搭建开发环境。关键是每个服务独立构建，通过统一编排实现协同工作。
