2. Docker 基础回顾：镜像分层原理、容器生命周期与常用命令

在进入缓存服务的日志收集与错误排查之前，必须重新校准 Docker 的核心基础。镜像分层机制决定了缓存镜像的构建效率与存储占用；容器生命周期管理直接影响日志采集的时机与完整性；而 docker run、exec、logs、inspect 是排查过程中使用频率最高的四个命令。本节以“快速复习 + 工程对照”的方式完成基础对齐。

2.1 Docker 镜像分层原理

Docker 镜像由只读层（Layer）堆叠而成，每一层对应 Dockerfile 中的一条指令。层被缓存并复用，这是镜像构建加速和存储优化的核心。

2.2 容器生命周期管理

容器从创建到销毁经历五个核心状态。理解状态转换是正确执行日志收集和错误排查的前提。

2.3 常用 Docker 命令快速复习

以下四个命令是缓存服务冒烟测试和日志排查中使用频率最高的操作。每个命令附带工程场景说明。

2.3.1 docker run — 创建并启动容器

# 标准启动命令（前台运行，绑定端口，挂载卷，设置环境变量）
docker run -d \
  --name redis-cache \
  -p 6379:6379 \
  -v /data/redis:/data \
  -e REDIS_PASSWORD=secret \
  redis:7-alpine

# 参数说明
# -d         后台运行（detached）
# --name     指定容器名称，便于后续操作
# -p         宿主机端口:容器端口
# -v         挂载卷（宿主机路径:容器路径）
# -e         设置环境变量

2.3.2 docker exec — 在运行中的容器内执行命令

# 进入容器交互式 shell
docker exec -it redis-cache sh

# 在容器内执行单条命令并返回结果
docker exec redis-cache redis-cli ping

# 参数说明
# -i         交互模式（interactive）
# -t         分配伪终端（tty）
# 组合 -it   通常一起使用，进入交互式 shell

2.3.3 docker logs — 查看容器日志输出

# 查看全部日志
docker logs redis-cache

# 实时跟踪日志（类似 tail -f）
docker logs -f redis-cache

# 查看最近 100 行日志
docker logs --tail 100 redis-cache

# 带时间戳查看日志
docker logs -t redis-cache

# 参数说明
# -f         实时跟踪（follow）
# --tail     仅显示末尾 N 行
# -t         显示时间戳

2.3.4 docker inspect — 查看容器/镜像的详细元数据

# 查看容器完整元数据（JSON 格式）
docker inspect redis-cache

# 使用 Go 模板过滤特定字段
docker inspect -f '{{.State.Status}}' redis-cache
docker inspect -f '{{.NetworkSettings.IPAddress}}' redis-cache
docker inspect -f '{{range .Mounts}}{{.Source}} -> {{.Destination}}{{end}}' redis-cache

# 查看镜像层信息
docker inspect redis:7-alpine

2.4 命令组合排查流程

以下是一个典型的缓存服务启动失败排查流程，展示四个命令的协同使用：

1. 启动容器： docker run -d --name my-cache redis:7-alpine
2. 检查状态： docker inspect -f '{{.State.Status}}' my-cache → 返回 exited
3. 查看退出码： docker inspect -f '{{.State.ExitCode}}' my-cache → 返回 1
4. 读取日志： docker logs my-cache → 显示 Fatal: can't open config file
5. 进入容器排查： docker run --rm -it -v $(pwd)/redis.conf:/usr/local/etc/redis/redis.conf redis:7-alpine sh → 手动检查配置文件权限和路径