一、背景及分析
MysqL容器启动时,会自动创建一些必要的数据库,比如MysqL,这是官方默认的做法。但是,在实际中,还需要让MysqL自动创建我们自定义的数据库。本文就此应用场合进行探究。
一般的做法是,启动容器并挂载数据目录后,使用MysqL客户端连接服务器,再手动输入sql语句创建(或导入.sql文件),当然也可以直接在容器内创建(方法同上)。由于挂载了数据目录,因此可持久化保存。但是,这些方法在部署数据库比较繁琐,不方便,特别是在初测阶段,会频繁地从头开始搭建环境。
如果能在MysqL容器启动时,自动执行我们自己的.sql文件,就不需要那么麻烦了,其实MysqL容器的启动脚本已经考虑了这种场合。通过MysqL镜像构建脚本docker-entrypoint.sh
(参考这里
),发现如下语句:
for f in /docker-entrypoint-initdb.d/*; do
process_init_file "$f" "${MysqL[@]}"
done
process_init_file
函数定义如下:
process_init_file() {
local f="$1"; shift
local MysqL=( "$@" )
case "$f" in
*.sh) echo "$0: running $f"; . "$f" ;;
*.sql) echo "$0: running $f"; "${MysqL[@]}" < "$f"; echo ;;
*.sql.gz) echo "$0: running $f"; gunzip -c "$f" | "${MysqL[@]}"; echo ;;
*) echo "$0: ignoring $f" ;;
esac
echo
}
从上面语句看到,脚本将需要执行的文件(如.sh或.sql)放到/docker-entrypoint-initdb.d
目录下,那么docker-entrypoint.sh
就会自动执行。明白了原理,解决方案就十分简单了。
二、解决方案
2.1 Dockerfile
内容如下:
为了方便起见,所有.sql文件都放到Dockerfile同级的sql目录。
2.2 准备好sql文件
下面是测试用的.sql文件,文件名为test.sql,内容如下:
-- 创建db_test数据库
create database `db_test` default character set utf8 collate utf8_general_ci;
use db_test;
-- 创建用户表
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
`id` bigint(20) NOT NULL,
`email` varchar(255) DEFAULT NULL,
`first_name` varchar(255) DEFAULT NULL,
`last_name` varchar(255) DEFAULT NULL,
`username` varchar(255) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;
-- 插入数据
INSERT INTO `user` (`id`, `email`, `first_name`, `last_name`, `username`)
VALUES(0,'[email protected]','Late','Lee','latelee');
主要内容是创建user
表,并插入测试的数据。
2.3 创建镜像
docker build -t MysqLtest .
创建镜像名称为MysqLtest
,注意最后的点号.
,表示使用当前目录的Dockerfile
。
2.4 容器启动
version: '2'
services:
database:
image: MysqLtest
#image: singula/MysqL
container_name: MysqL
ports:
- "3406:3306"
volumes:
- ./MysqL_data:/var/lib/MysqL
- /home:/home
environment:
MysqL_ROOT_PASSWORD: 123456
使用下列命令启动:
docker-compose up -d
验证数据库表:
$ docker exec -it MysqL bash
bash-4.2# MysqL -uroot -p123456
MysqL> use db_test;
MysqL> select * from user;
+----+----------------+------------+-----------+----------+
| id | email | first_name | last_name | username |
+----+----------------+------------+-----------+----------+
| 0 | [email protected] | Late | Lee | latelee |
+----+----------------+------------+-----------+----------+
1 row in set (0.00 sec)
使用如下语句修改邮箱地址:
update user set email='cst@cststudio.com.cn' where username='latelee';
退出容器后,停止容器:
docker-compose down
再次重复上述命令启动、查看数据,可以看到邮件地址是最新的,从而验证了数据能永久存储。
三、实践指导
.sql
脚本只有第一次启动时创建(或说没有数据库时则会创建),已创建的,不会覆盖掉,否则这个机制就无法正式应用项目中。
在.sql
脚本中,也可以创建账号、密码,这样就不用在docker-compose
文件指定环境变量了。起到了一定的保护作用。
如果要完全迁移数据,需要将数据目录(文中为MysqL_data
目录)与docker-compose.yml
文件一起迁移。