乐趣区

Docker容器启动时初始化Mysql数据库

jiezi

1. 前言

Docker在开发中使用的越来越多了，最近搞了一个 Spring Boot 应用，为了方便部署将 Mysql 也放在 Docker 中运行。那么怎么初始化 SQL脚本以及数据呢？

我这里有两个传统方案。第一种方案是在容器启动后手动导入，太 low 了不行。第二种在 Spring Boot 客户端连接 Mysql 容器时初始化数据库，你可以参考使用 flyway 进行数据库版本控制一文，但是这依赖客户端的能力。能不能做到 Mysql 容器启动时就自己初始化数据库呢？当然可以！今天就来演示一下。全部代码见文末。

2. 原理

当 Mysql 容器首次启动时，会在 /docker-entrypoint-initdb.d目录下扫描 .sh，.sql，.sql.gz类型的文件。如果这些类型的文件存在，将执行它们来初始化一个数据库。这些文件会按照字母的顺序执行 。默认情况下它们会初始化在启动容器时声明的 MYSQL_DATABASE 变量定义的数据库中, 例如下面的命令会初始化一个REGION_DB 数据库：

$ docker run --name some-mysql -e MYSQL_DATABASE=REGION_DB -d mysql:tag

如果你的启动命令没有指定数据库那么就必须在数据库 DDL 脚本中声明并指定使用该数据库。否则就会实现下面的异常：

ERROR 1046 (3D000) at line 7: No database selected

那么接下来我们将利用这一机制来实现 Docker 容器启动时初始化数据库。

3. 自定义 Dockerfile

我们编写自己的 Dockerfile 来实现我们的需求，这里以 Mysql:5.7 为例。不同的版本可能有一定的出入，需要详细去阅读官方文档。脚本如下：

FROM mysql:5.7
LABEL OG=felord.cn
COPY utf8mb4.cnf /etc/mysql/conf.d/utf8mb4.cnf
COPY ./sql  /tmp/sql
RUN mv /tmp/sql/*.sql /docker-entrypoint-initdb.d
RUN rm -rf /tmp/sql
  • 第一步，引入官方 Mysql:5.7 Docker 镜像。
  • 第二步，无实际意义，主要是作者、组织信息。
  • 第三步，很重要！本来我没有配置第三行，结果运行容器后发现初始化数据的中文全部乱码了。所以需要在初始化数据库前修改 Mysql 的编码等配置，这里我顺便把时区也改为了+8:00。
  • 第四步，复制包含数据库脚本的 ./sql文件夹到镜像的 /tmp/sql 下。
  • 第五步，使用 mv 命令把第四步拷贝的文件夹下的所有 .sql 文件复制到 /docker-entrypoint-initdb.d下，这样才能利用 2. 章节 的机制进行初始化数据库。
  • 第六步，删除使用过的临时目录。

然后你可以通过构建镜像命令构建自定义的 Mysql 镜像：

# 一定不要忘记最后的一个 . 点
docker build -t mysql:5.7c .

通过 mysql:5.7c 镜像启动一个名称为 mysql-service 的容器，root密码为 123456, 并持久化数据到宿主机 D:/mysql/data 下：

docker run --name mysql-service -v d:/mysql/data:/var/lib/mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 -d mysql:5.7c

小贴士：你可以通过 SHOW VARIABLES LIKE 'character%' 查看字符集是否更改为utf8mb4, 也可以通过SHOW VARIABLES LIKE '%time_zone%' 查看时区是否是东八区。

4. 总结

今天我们自定义一个可以执行初始化数据库的 Mysql 镜像，方便我们进行部署。你也可以参考这个思路来定制其它一些自己需要的 Docker 镜像。本文的完整 Demo 可通过我个人博客获取。

关注公众号：Felordcn 获取更多资讯

个人博客：https://felord.cn

退出移动版