📚 课程目录第3章数据库容器化基础

3. 数据库容器化基础：Dockerfile编写、镜像优化、数据持久化原理

将数据库迁入Kubernetes的第一步，是将其封装为符合云原生标准的容器镜像。本章聚焦三个核心环节：Dockerfile编写规范、镜像体积与安全优化、数据持久化原理。只有打好容器化基础，后续的迁移接口契约与性能调优才有可靠的执行底座。

3.1 Dockerfile编写：数据库专用指令与分层策略

数据库镜像与普通应用镜像有本质区别：数据库需要稳定的文件系统权限、预置的数据目录、以及可配置的初始化脚本。以下是一个生产级MySQL 8.0 Dockerfile示例：

FROM mysql:8.0.33-oracle AS base

# 设置时区与字符集
ENV TZ=Asia/Shanghai \
    LANG=C.UTF-8 \
    MYSQL_ROOT_HOST=% \
    MYSQL_DATABASE=appdb

# 复制自定义配置文件（覆盖默认配置）
COPY --chown=mysql:mysql conf.d/my.cnf /etc/mysql/conf.d/

# 复制初始化SQL脚本（仅在首次启动时执行）
COPY --chown=mysql:mysql init/ /docker-entrypoint-initdb.d/

# 暴露端口
EXPOSE 3306

# 使用官方entrypoint（自动处理初始化与数据目录权限）
ENTRYPOINT ["docker-entrypoint.sh"]
CMD ["mysqld"]

关键原则：不要使用root用户运行数据库进程。官方MySQL镜像默认使用mysql用户（UID 999），所有数据目录和配置文件必须显式设置--chown=mysql:mysql，否则容器启动时权限校验失败。

Dockerfile分层策略直接影响镜像构建缓存命中率与最终体积。推荐的分层顺序如下表：

分层顺序	内容	变更频率	缓存策略
第1层	基础镜像（FROM）	极低（季度/年度）	始终缓存
第2层	环境变量（ENV）	低（项目初始化）	缓存
第3层	配置文件（COPY conf.d/）	中（参数调优时）	按需失效
第4层	初始化脚本（COPY init/）	高（每次迭代）	频繁失效
第5层	ENTRYPOINT / CMD	极低	缓存

将变更频繁的初始化脚本放在Dockerfile末尾，可以最大化利用前几层的构建缓存，将每次构建时间从分钟级压缩到秒级。

3.2 镜像优化：从1.2GB到280MB的压缩路径

未优化的数据库镜像通常超过1GB，导致拉取慢、磁盘占用高、启动延迟大。以下优化手段按效果排序：

选择轻量基础镜像：使用oraclelinux-slim或debian-slim替代完整版。MySQL官方8.0.33-oracle比8.0.33小约40%。
多阶段构建：编译阶段使用完整工具链，运行阶段只复制二进制产物。
清理包管理器缓存：在同一个RUN层内执行apt-get update && apt-get install -y ... && rm -rf /var/lib/apt/lists/*。
删除非必要组件：移除调试符号、静态库、文档、示例数据库。
使用.dockerignore：排除本地日志、.git、node_modules等无关文件。

  优化效果对比（MySQL 8.0）：

  原始镜像：1.2GB → 优化后：280MB（压缩后约95MB）

  拉取时间：从45秒降至8秒（100Mbps网络）

  容器启动时间：从12秒降至4秒

以下是一个多阶段构建的PostgreSQL优化示例：

# 阶段1：编译
FROM postgres:16-bookworm AS builder
RUN set -ex \
    && apt-get update \
    && apt-get install -y --no-install-recommends \
        build-essential libpq-dev \
    && rm -rf /var/lib/apt/lists/*

# 阶段2：运行
FROM postgres:16-alpine
COPY --from=builder /usr/lib/postgresql/16/bin/* /usr/lib/postgresql/16/bin/
COPY --from=builder /usr/share/postgresql/16/extension/ /usr/share/postgresql/16/extension/
# 仅保留运行所需的最小文件集

3.3 数据持久化原理：容器存储与Kubernetes的衔接

容器默认使用可写层（Writable Layer）存储数据，但该层与容器生命周期绑定——容器删除后数据即丢失。数据库必须使用卷（Volume）将数据保存在宿主机或远程存储上。

Docker提供三种持久化方式，其原理与适用场景如下：

方式	存储位置	生命周期	适用场景	性能
Bind Mount	宿主机任意路径	由用户管理	开发调试、配置文件注入	原生（直接访问宿主机文件系统）
Volume	`/var/lib/docker/volumes/`	由Docker管理	生产数据库、需要备份的数据	原生（推荐）
tmpfs Mount	内存	容器停止即消失	临时缓存、敏感数据（不落盘）	极高（内存速度）

生产避坑：不要对数据库使用tmpfs挂载数据目录——容器重启或OOM后数据永久丢失。tmpfs仅适合存放临时排序文件或共享内存（如PostgreSQL的shared_buffers）。

在Kubernetes中，Docker Volume被抽象为PersistentVolume（PV）和PersistentVolumeClaim（PVC）。容器化阶段只需确保Dockerfile中声明的数据目录（如/var/lib/mysql）与Kubernetes挂载路径一致，后续迁移时无需修改镜像。

3.4 数据目录权限与初始化流程

数据库容器首次启动时，需要完成以下初始化流程：

检查数据目录：如果/var/lib/mysql为空，则执行初始化（创建系统表空间、用户表等）。
设置文件权限：确保数据目录所有者与容器内数据库用户一致（MySQL为mysql:mysql）。
执行初始化脚本：运行/docker-entrypoint-initdb.d/下的.sql、.sh文件。
启动数据库进程：以非root用户身份启动mysqld或postgres。

  权限排查命令（宿主机）：

  ls -ln /data/mysql  # 查看UID/GID

  chown -R 999:999 /data/mysql  # 修正为mysql用户UID

  docker run --rm -v /data/mysql:/var/lib/mysql mysql:8.0 ls -la /var/lib/mysql  # 验证容器内权限

3.5 本章小结

Dockerfile编写应遵循分层缓存优先原则，将变更频繁的初始化脚本放在末尾。
镜像优化通过轻量基础镜像 + 多阶段构建 + 缓存清理可将体积压缩70%以上。
数据持久化必须使用Docker Volume或Bind Mount，并确保容器内UID与存储后端权限一致。
理解容器化数据持久化原理，是后续在Kubernetes中配置PV/PVC、StatefulSet和存储类的前提。