使用 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 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 微服务在本地运行变得简单可控,适合快速搭建开发环境。关键是每个服务独立构建,通过统一编排实现协同工作。
以上就是在 Docker Compose 中如何编排 .NET 微服务?的详细内容,更多请关注php中文网其它相关文章!