Docker容器啟動時初始化Mysql資料庫
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 獲取更多資訊