使用 docker-compose 构造本地运行环境

说明

docker-compose 能够本地快速搭建一个微小但是完整的运行环境，高度仿真正式的运行环境。

准备

确定本地已经安装有 docker 和 docker-compose。

$ docker-compose --version
Docker Compose version v2.24.5-desktop.1

打包成 docker 镜像

把目标服务打包成 docker 镜像，是使用 docker-compose 的前提。编译过程和打包过程可以用一个 Dockerfile 描述。下面是 go 语言开发服务的编译和打包过程。

在 golang:1.20.13-alpine3.18 中编译本地代码
将本地目录中的所有代码文件拷贝到容器的 go/src/web 目录中，web 是自定义的目录。
编译时在容器的 /go/pkg 目录挂载一个 cache volume，避免每次都要重新拉取依赖代码
打包镜像时用 –from 从 builder 中复制编译产物

FROM golang:1.20.13-alpine3.18 as builder
COPY . /go/src/web
WORKDIR /go/src/web
RUN --mount=target=/go/pkg,type=cache  go build -o _output/server cmd/server/main.go

FROM alpine:3.18.6
RUN mkdir -p /app && chown -R nobody:nogroup /app && apk add mariadb-connector-c
COPY --from=builder /go/src/web/_output/server /app
USER nobody
WORKDIR /app

ENTRYPOINT ["/app/server"]

docker-compose

docker-compose 是一个本地命令，它按照 compose file 中的内容在本地启动 docker 容器。最简单的 compose file 如下，启动一个 reids。compose file 的语法格式和支持的命令见：compose file reference。

services:
  redis:
    image: redis:7.2.4
    ports:
      - "6379:6379"

运行 docker-compose 命令，如果没有用 -f 指定 compose 文件，它会自动使用所在目录中的 docker-compose.yml 文件：

docker-compose up     # 启动，在前台运行
docker-compose up -d  # 启动，在后台运行
docker-compose down   # 停止

compose file

compose file 中可用的指令基本是和 docker 的能力对应的，下面列举下经常用到的配置方式。

配置多个服务并设置依赖

下面的配置中有 mysql 和 web-server 两个服务:

web-server 依赖 mysql，mysql 服务状态是 health 时，web-server 服务开始启动
mysql 服务通过 volumes 将本地目录挂到容器内，避免删除容器时将数据一同删除
web-server 中可以直接通过服务名 mysql 访问服务

services:
  mysql:
    image: mysql:8.0
    cap_add:
      - SYS_NICE
    environment:
      - TZ=CST-8
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=web
      - MYSQL_USER=web
      - MYSQL_PASSWORD=web
    ports:
      - '13306:3306'
    volumes:
      - ./_local/conf/mysql/my.cnf:/etc/my.cnf
      - ./_local/conf/mysql/conf.d:/etc/mysql/conf.d
      - ./_local/data/mysql:/var/lib/mysql
      - ./_local/log/mysql:/var/log/mysql
      - ./store/sql:/docker-entrypoint-initdb.d
    healthcheck:
      test: [ "CMD", "mysqladmin" ,"ping", "-h", "localhost" ]
      start_period: 4s
      interval: 2s
      retries: 10
    restart: always
  web-server:
    depends_on:
      mysql:
        condition: service_healthy
        restart: true
    image: "web-server:dev"
    command: -stderrthreshold=INFO
    ports:
      - "16060:6060"
    environment:
      - WEB_LISTEN_ADDR=0.0.0.0:6060
      - WEB_DSN=web:web@(mysql:3306)/web
    restart: always