Skip to content

Docker 使用 ​

把程序连同依赖一起打包,保证「本机能跑,换台机器也能跑」。下面以本机的 muduo_im 分布式视频平台为例——它用一个多阶段 Dockerfile 编译全部服务,再用一份 compose 文件拉起 5 个服务 + 4 个中间件。

一、先分清四个概念 ​

概念是什么类比
镜像 image只读模板,含程序 + 依赖 + 文件系统类 / 安装包
容器 container镜像跑起来的实例,可读写对象 / 进程
卷 volume独立于容器生命周期的持久化数据数据库文件
仓库 registry存放镜像的地方(Docker Hub 等)应用商店

一句话:容器删了就没了,卷还在;镜像不改,容器随便开。

二、日常命令 ​

bash
# ── 镜像 ──────────────────────────────────────────────
docker pull ubuntu:24.04              # 拉取指定版本镜像(生产务必写 tag,别用 latest)
docker images                         # 列出本地镜像
docker rmi 镜像ID                      # 删除镜像(需先删依赖它的容器)
docker build -t myapp:1.0 .           # 用当前目录 Dockerfile 构建,打标签 myapp:1.0
docker image prune -f                 # 清理悬空镜像(无 tag 的中间层)

# ── 容器 ──────────────────────────────────────────────
docker run -it --rm ubuntu:24.04 bash # -i 交互、-t 分配终端、--rm 退出即删
docker run -d --name web -p 8080:80 nginx   # -d 后台、-p 宿主8080→容器80
docker ps                             # 运行中的容器(-a 连已停止的一起看)
docker exec -it web bash              # 进入正在运行的容器(exit 不会停容器)
docker logs -f --tail 100 web         # 跟踪最后 100 行日志
docker stop web                       # 优雅停止(SIGTERM,10 秒后 SIGKILL)
docker rm web                         # 删除已停止的容器
docker inspect web                    # 查看容器完整配置(IP、挂载、环境变量)

# ── 资源与清理 ────────────────────────────────────────
docker stats                          # 实时 CPU / 内存 / 网络占用
docker system df                      # 镜像、容器、卷各占多少磁盘
docker system prune -a                # 清理未使用的镜像/容器/网络(删除前先看清楚)

三、Dockerfile:多阶段构建 ​

muduo_im/docker/Dockerfile 的思路是编译镜像和运行镜像分离:builder 阶段装编译器产二进制,runtime 阶段只装运行库。最终镜像不带 g++、cmake,体积小很多,攻击面也小。

dockerfile
# ============ 阶段 1:编译 ============
FROM ubuntu:24.04 AS builder                # 给这个阶段起名 builder,后面可引用

RUN apt-get update \                        # 更新软件源索引
    && DEBIAN_FRONTEND=noninteractive \     # 安装时不弹交互式提问
    apt-get install -y --no-install-recommends \  # -y 自动确认;不装推荐包,减小体积
        build-essential \                   # g++ / make 等基础编译工具
        cmake \                             # 构建系统
        libprotobuf-dev protobuf-compiler \ # Protobuf 运行库 + protoc 编译器
        libzookeeper-mt-dev \               # ZooKeeper C 客户端头文件
        libmysqlclient-dev \                # MySQL 客户端库
        libhiredis-dev \                    # Redis 客户端库
        librabbitmq-dev \                   # RabbitMQ 客户端库
    && rm -rf /var/lib/apt/lists/*          # 同一层内删缓存,否则体积白省

WORKDIR /src                                # 后续命令的工作目录,不存在会自动创建
COPY . .                                    # 把构建上下文复制进镜像(.dockerignore 会排除无关文件)

RUN cmake -B build \                        # 配置:源码在 .,构建目录 build
        -DCMAKE_BUILD_TYPE=Release \        # 发布模式:-O3 -DNDEBUG
        -DENABLE_NATIVE_MARCH=OFF \         # 关掉 -march=native,保证镜像能跨 CPU 机器运行
    && cmake --build build -j$(nproc)       # 并行编译,核数取容器可见的 CPU 数

# ============ 阶段 2:运行 ============
FROM ubuntu:24.04 AS runtime                # 全新的干净基础镜像

RUN apt-get update \                        # 只装运行期需要的东西
    && DEBIAN_FRONTEND=noninteractive \
    apt-get install -y --no-install-recommends \
        ffmpeg \                            # 转码服务依赖的外部程序
        libprotobuf32t64 \                  # 运行时库:注意版本号对应 Ubuntu 24.04
        libzookeeper-mt2 \                  # ZooKeeper 运行时库
        libmysqlclient21 \                  # MySQL 运行时库
        libhiredis1.1.0 \                   # Redis 运行时库
        librabbitmq4 \                      # RabbitMQ 运行时库
        ca-certificates \                   # HTTPS 证书,访问外部服务需要
    && rm -rf /var/lib/apt/lists/*          # 同样在同层清缓存

WORKDIR /app                                # 运行目录

COPY --from=builder /src/bin/ /app/bin/     # 只从 builder 拷贝产物,不拷编译器
COPY docker/conf/ /app/conf/                # 拷贝各服务的配置文件

RUN mkdir -p /app/program_log \             # 日志目录,下面会被 volume 覆盖
             /data/videos \                 # 输入视频目录
             /data/output \                 # 转码输出目录
             /tmp/transcode_worker          # 转码临时目录

为什么不用 npm/pip 那种单阶段? C++ 编译依赖大(cmake、protobuf-dev、头文件),但运行时只需要 .so。单阶段镜像动辄 1~2 GB,多阶段能压到几百 MB。

配套的 .dockerignore 同样重要——它决定 COPY . . 带进多少东西:

text
build/             # 本机编译产物,镜像里会重新编译
bin/               # 本机二进制,避免旧产物混进镜像
lib/               # 本机库
program_log/       # 日志
data/              # 本地视频数据
.git/              # 版本库,体积大且运行时用不到
.vscode/ .claude/  # 编辑器/工具配置

四、docker compose:一键起整套环境 ​

单容器用 docker run,多容器(服务 + MySQL + Redis + MQ)用 compose。muduo_im/docker/docker-compose.yml 的骨架如下,关键行都加了注释:

yaml
services:
  # ── 中间件:直接使用官方镜像 ──────────────────────────
  mysql:
    image: mysql:8.0                        # 指定版本,避免 latest 漂移
    environment:
      MYSQL_ROOT_PASSWORD: root123456       # root 密码
      MYSQL_DATABASE: video_platform        # 首次启动自动建库
      MYSQL_USER: video_platform            # 业务账号
      MYSQL_PASSWORD: video_platform123     # 业务密码
    volumes:
      - mysql-data:/var/lib/mysql           # 命名卷持久化数据,容器删了数据还在
      - ../video_platform/sql/schema.sql:/docker-entrypoint-initdb.d/schema.sql:ro
                                            # 首次启动自动执行建表脚本,:ro 只读挂载
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-uroot", "-proot123456"]
                                            # 探活命令:能 ping 通才算 healthy
      interval: 5s                          # 每 5 秒探测一次
      timeout: 3s                           # 单次超时 3 秒
      retries: 20                           # 连续失败 20 次才判不健康
      start_period: 20s                     # 启动后 20 秒内的失败不计
    ports:
      - "23306:3306"                        # 宿主 23306 → 容器 3306(避开本机已占的 3306)
    restart: unless-stopped                 # 异常退出自动重启,手动 stop 的除外

  # ── 平台服务:共用同一个 Dockerfile ───────────────────
  scheduler_service:
    build:
      context: ..                           # 构建上下文是项目根目录(能 COPY 到全部源码)
      dockerfile: Dockerfile                # 用 docker/Dockerfile
    command: ["/app/bin/scheduler_service", "-i", "/app/conf/scheduler.conf"]
                                            # 同一镜像,用不同 command 启动不同服务
    depends_on:
      zookeeper: { condition: service_healthy }   # 等 ZK 健康后再启动
      mysql:     { condition: service_healthy }   # 等 MySQL 健康后再启动
    ports:
      - "19002:9002"                        # 宿主 19002 → 容器内 RPC 端口 9002
    volumes:
      - ../program_log:/app/program_log     # 日志落到宿主,容器删了日志还在
      - ../data/videos:/data/videos         # 输入视频
      - ../data/output:/data/output         # 输出产物
    restart: unless-stopped

  transcode_worker:
    build:
      context: ..
      dockerfile: Dockerfile
    command: ["/app/bin/transcode_worker", "-i", "/app/conf/transcode_worker.conf"]
    depends_on:
      zookeeper:      { condition: service_healthy }   # worker 需要 ZK 注册
      worker_manager: { condition: service_healthy }   # 等 WM 就绪,避免注册竞态
    # 不映射端口:--scale 起多副本时宿主端口会冲突,容器间靠 ZK 发现互通
    volumes:
      - ../data/videos:/data/videos         # 读输入
      - ../data/output:/data/output         # 写输出
    restart: unless-stopped

volumes:
  mysql-data:                               # 声明命名卷,由 Docker 统一管理

compose 常用命令 ​

bash
cd ~/muduo_im/docker
docker compose up -d --build              # 构建镜像并后台启动全部服务
docker compose ps                         # 查看各服务状态(含 healthy 标记)
docker compose logs -f scheduler_service  # 跟踪某个服务的日志
docker compose up -d --scale transcode_worker=3   # 把 worker 扩到 3 个副本
docker compose exec worker_manager bash   # 进入正在运行的容器
docker compose restart scheduler_service  # 只重启一个服务
docker compose down                       # 停止并删除容器/网络,保留数据卷
docker compose down -v                    # 连数据卷一起删(MySQL 数据会清空,慎用)

五、容器里跑 C++ 服务的坑 ​

现象原因处理
服务连不上 MySQL配置里写了 127.0.0.1,指容器自己改成 compose 服务名 mysql,容器间有内置 DNS
容器一启动就退出主进程结束了command 要跑前台进程,不能 nohup ... &
worker 注册 ZK 失败worker 比 worker_manager 先起来depends_on + condition: service_healthy,代码侧再加重试兜底
--scale 报端口冲突每个副本都想映射同一个宿主端口需要多副本的服务不要映射端口,走服务发现
镜像换机器跑不了编译时加了 -march=native构建加 -DENABLE_NATIVE_MARCH=OFF
宿主端口被占用本机已有服务映射到替代端口,如 23306:3306
容器内崩溃没有 corecore 写在容器可写层挂载目录,或把 core_pattern 指到挂载点
改了代码没生效用的旧镜像docker compose up -d --build 重新构建

六、一句话流程 ​

bash
# 改代码
#   ↓
docker compose up -d --build    # 重新编译 + 滚动启动
#   ↓
docker compose logs -f <服务>   # 看日志确认
#   ↓
docker compose down             # 收工(加 -v 会连数据库一起删)