共计 1615 个字符,预计需要花费 5 分钟才能阅读完成。
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