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 獲取更多資訊