📚 课程目录第4章 Dockerfile编写

4. Dockerfile 编写：基于 Alpine 构建最小化 Redis 镜像

在生产环境中，缓存服务的镜像体积直接影响部署速度、存储成本和攻击面。本章将演示如何通过 Alpine Linux 基础镜像与 多阶段构建 技术，构建一个仅包含 Redis 运行时的最小化 Docker 镜像。

4.1 为什么选择 Alpine 作为基础镜像

Alpine 是一个面向安全的轻量级 Linux 发行版，基于 musl libc 和 busybox。与标准 Ubuntu/Debian 镜像相比，其体积优势显著：

基础镜像	压缩后大小	解压后大小	包管理器	C 库
ubuntu:22.04	~77 MB	~200 MB	apt	glibc
debian:bullseye-slim	~80 MB	~190 MB	apt	glibc
alpine:3.19	~7 MB	~18 MB	apk	musl

兼容性提示： Redis 官方从 6.x 版本开始已全面支持 musl libc，在 Alpine 上运行无需额外适配。但若使用 Redis Stack 或包含外部模块的扩展版本，需验证模块是否依赖 glibc 特性。

4.2 多阶段构建策略

多阶段构建允许在同一个 Dockerfile 中使用多个 FROM 语句。第一阶段（构建阶段）包含完整的编译工具链，第二阶段（运行阶段）仅复制编译产物和运行时依赖，从而丢弃所有构建工具和中间文件。

  核心收益： 最终镜像仅包含 Redis 二进制文件、最小运行时库和配置文件，无 gcc、make、musl-dev 等构建依赖，体积可缩减 80% 以上。

4.3 完整 Dockerfile 实现

以下 Dockerfile 使用 Alpine 3.19 作为基础，通过多阶段构建编译 Redis 7.2.4 稳定版：

# ============================================
# 阶段一：构建阶段
# ============================================
FROM alpine:3.19 AS builder

# 安装编译工具和依赖
RUN apk add --no-cache \
    gcc \
    make \
    musl-dev \
    linux-headers \
    tar \
    curl

# 下载并解压 Redis 源码
ARG REDIS_VERSION=7.2.4
ARG REDIS_URL=https://download.redis.io/releases/redis-${REDIS_VERSION}.tar.gz

RUN curl -fsSL ${REDIS_URL} -o /tmp/redis.tar.gz \
    && tar xzf /tmp/redis.tar.gz -C /tmp \
    && rm /tmp/redis.tar.gz

# 编译 Redis（仅编译 server 和 cli，跳过测试和文档）
WORKDIR /tmp/redis-${REDIS_VERSION}
RUN make -j$(nproc) \
    && make install PREFIX=/opt/redis

# ============================================
# 阶段二：运行阶段
# ============================================
FROM alpine:3.19

# 安装运行时最小依赖：仅需 libgcc 运行时库
RUN apk add --no-cache libgcc

# 从构建阶段复制编译产物
COPY --from=builder /opt/redis/bin/redis-server /usr/local/bin/
COPY --from=builder /opt/redis/bin/redis-cli /usr/local/bin/

# 创建数据目录和配置文件目录
RUN mkdir -p /data /etc/redis

# 复制默认配置文件（可选：使用自定义配置）
COPY redis.conf /etc/redis/redis.conf

# 暴露端口
EXPOSE 6379

# 设置工作目录和数据卷
WORKDIR /data
VOLUME /data

# 启动命令
CMD ["redis-server", "/etc/redis/redis.conf"]

4.4 构建与验证

执行以下命令构建镜像并验证体积：

# 构建镜像
docker build -t redis-alpine-minimal:7.2.4 .

# 查看镜像体积
docker images redis-alpine-minimal:7.2.4

# 预期输出（实际大小可能因版本略有差异）：
# REPOSITORY                TAG       IMAGE ID       CREATED          SIZE
# redis-alpine-minimal      7.2.4     abc123def456   10 seconds ago   12.3 MB

# 启动容器并验证 Redis 可用性
docker run -d --name redis-test -p 6379:6379 redis-alpine-minimal:7.2.4
docker exec redis-test redis-cli ping
# 输出：PONG

安全注意： 生产环境中请勿使用 redis-cli ping 暴露在公网。建议在 Dockerfile 中移除 redis-cli 二进制，或通过 --network host 模式限制访问。

4.5 多阶段构建流程示意图

下图展示了构建阶段与运行阶段之间的文件传递关系：

4.6 镜像体积对比

以下是不同构建方式下的最终镜像体积对比：

构建方式	基础镜像	最终体积	包含内容
单阶段（apt 安装）	ubuntu:22.04	~180 MB	Redis + glibc + apt 缓存
单阶段（apk 安装）	alpine:3.19	~35 MB	Redis + musl + apk 缓存
多阶段（本方案）	alpine:3.19	~12 MB	仅 Redis 二进制 + libgcc

  最佳实践： 多阶段构建相比单阶段 apk 安装，体积再缩减约 65%。若进一步移除 redis-cli 和调试符号（strip），体积可降至 8 MB 以下。

4.7 常见问题与避坑指南

musl 兼容性： 若使用 Redis 模块（如 RediSearch、RedisJSON），需确认模块是否提供 musl 编译版本。部分模块仅提供 glibc 版本，此时应改用 debian:bullseye-slim 作为运行阶段基础镜像。
时区问题： Alpine 默认不包含时区数据。若 Redis 日志需要正确时区，可在运行阶段安装 tzdata 包并设置 TZ 环境变量。
配置文件路径： 确保 redis.conf 中的 dir 和 logfile 路径与 Dockerfile 中创建的目录一致，避免容器启动时因权限或路径错误而退出。
安全加固： 生产环境建议在 Dockerfile 中执行 RUN strip /usr/local/bin/redis-server 移除调试符号，并设置 USER redis 以非 root 用户运行。