主题
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 |
| 容器内崩溃没有 core | core 写在容器可写层 | 挂载目录,或把 core_pattern 指到挂载点 |
| 改了代码没生效 | 用的旧镜像 | docker compose up -d --build 重新构建 |
六、一句话流程
bash
# 改代码
# ↓
docker compose up -d --build # 重新编译 + 滚动启动
# ↓
docker compose logs -f <服务> # 看日志确认
# ↓
docker compose down # 收工(加 -v 会连数据库一起删)