使用Docker Compose可高效编排Golang微服务,通过定义docker-compose.yml文件实现多服务构建、网络互通与环境配置,支持服务间通过容器名通信,简化本地开发与测试流程。

在使用 Go(Golang)开发微服务架构时,通常会涉及多个服务协同工作。Docker 配合 docker-compose 是实现多服务编排的轻量级解决方案。下面介绍如何用 Golang 构建多个服务,并通过 Docker Compose 进行统一管理。
编写多个 Golang 服务
假设有两个简单的 Go 服务:
- user-service:提供用户信息 API
- auth-service:处理认证逻辑
每个服务都有自己的 main.go 和 Dockerfile。
示例:user-service/main.go
立即学习“go语言免费学习笔记(深入)”;
package main
<p>import (
"encoding/json"
"net/http"
"log"
)</p><p>func main() {
http.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
json.NewEncoder(w).Encode(map[string]string{
"id": "1",
"name": "John Doe",
})
})</p><pre class="brush:php;toolbar:false;">log.Println("User service starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))}
为每个服务创建独立的 Dockerfile:
Dockerfile(user-service)FROM golang:1.21-alpine AS builder WORKDIR /app COPY . . RUN go build -o user-svc . <p>FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /app/user-svc . EXPOSE 8080 CMD ["./user-svc"]
auth-service 的结构类似,监听在 :9000 端口。
使用 docker-compose.yml 编排服务
在项目根目录创建 docker-compose.yml,定义多个服务及其依赖关系。
version: '3.8' <p>services: user-service: build: context: ./user-service dockerfile: Dockerfile ports:</p><ul><li>"8080:8080" environment:</li><li>ENV=development</li></ul><p>auth-service: build: context: ./auth-service dockerfile: Dockerfile ports:</p><ul><li>"9000:9000" environment:</li><li>ENV=development</li></ul><h1>可选:加入数据库或其他中间件</h1><p>redis: image: redis:alpine ports:</p><ul><li>"6379:6379"
这个配置会:
- 从各自目录构建镜像
- 暴露端口供外部访问
- 支持环境变量注入
- 自动建立默认网络,服务间可通过服务名通信(如 user-service 调用 http://auth-service:9000/login)
服务间通信示例
如果 user-service 需要调用 auth-service 验证 token,可以直接使用服务名作为主机名:
resp, err := http.Get("http://auth-service:9000/validate?token=xxx")
if err != nil {
// 处理错误(注意:容器网络中服务名即 DNS 名)
}
Docker Compose 会自动设置内网 DNS,使服务可通过名称互相访问。
启动与管理多服务
在项目根目录运行:
docker-compose up -d --build
这会:
- 构建每个服务的镜像(如有变更)
- 启动所有容器
- 后台运行(-d)
查看日志:
docker-compose logs -f user-service
停止服务:
docker-compose down
基本上就这些。对于本地开发和测试,Docker Compose 提供了简洁高效的多服务编排方式。Go 服务轻量、启动快,非常适合这种模式。生产环境可进一步迁移到 Kubernetes,但开发阶段用 Compose 完全够用。










