Docker

Docker

go-zero services compile to a single static binary, giving you minimal Docker images.

Dockerfile

FROM golang:1.22-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o service .

FROM alpine:3.20
RUN apk --no-cache add ca-certificates tzdata
WORKDIR /app
COPY --from=builder /app/service .
COPY etc/ ./etc/
EXPOSE 8888
CMD ["./service", "-f", "etc/app.yaml"]

Build & Run

docker build -t myapp:latest .
docker run -p 8888:8888 myapp:latest

Docker Compose

docker-compose.yaml

services:
  api:
    build: ./api
    ports: ["8888:8888"]
    depends_on: [mysql, redis, etcd]

  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: password
      MYSQL_DATABASE: myapp
    volumes: [mysql_data:/var/lib/mysql]

  redis:
    image: redis:7-alpine

  etcd:
    image: bitnami/etcd:latest
    environment:
      ALLOW_NONE_AUTHENTICATION: "yes"

volumes:
  mysql_data:

docker compose up -d

Health Check

HEALTHCHECK --interval=10s --timeout=3s \
  CMD wget -qO- http://localhost:8888/healthz || exit 1