MySQL 的容器化部署与数据库初始化

Spring

2023-05-20

MySQL

239

01 概述

1.1 环境

CentOS 8

$ docker --version
Docker version 20.10.11, build dea9396
$ docker-compose --version
Docker Compose version v2.16.0

1.2 Docker 安装 MySQL 的初始化原理

MySQL Docker 官方介绍：Initializing a refsh instance

When a container is started for the first time, a new database with the specified name will be created and initialized with the provided configuration variables. Furthermore, it will execute files with extensions ++.sh, .sql and .sql.gz++ that are found in /docker-entrypoint-initdb.d. Files will be executed in alphabetical order. You can easily populate your mysql services by mounting a SQL dump into that directory and provide custom images with contributed data. SQL files will be imported by default to the database specified by the MYSQL_DATABASE variable.

即，容器首次启动后，会做如下初始化动作：

加载目录为 /docker-entrypoint-initdb.d，后缀为 .sh, sql 和 .sql.gz 的文件
按照文件名的字母顺序，依次执行
默认情况下，SQL 文件将导入到 MYSQL_DATABASE 指定的数据库中（sh 格式暂不了解作用）

02 制作镜像

2.1 编写 Dockerfile

不一定要创建新的镜像，只是在项目部署时，习惯使用自己构建的镜像，定制一点配置，这里只是把初始化 sql 放到镜像中。

创建一个新的目录，结构如下：

- db/            # 存放 SQL 文件
- Dockerfile

Dockerfile 文件如下：

FROM mysql:8.0.33
MAINTAINER springx.fun

COPY ./db/*.sql /docker-entrypoint-initdb.d/

2.2 制作镜像

执行 build 制作镜像，自动拉取依赖镜像，并制作自定义镜像：

$ docker build -t springx.fun/mysql:8.0.33 .
Sending build context to Docker daemon   5.12kB
Step 1/3 : FROM mysql:8.0.33
8.0.33: Pulling from library/mysql
328ba678bf27: Pulling fs layer 
f3f5ff008d73: Pulling fs layer 
dd7054d6d0c7: Downloading 
70b5d4e8750e: Waiting 

...

参数说明：

-t：指定构建的镜像名称和标签。例如 -t myapp:latest，构建出来的镜像名称为 myapp，标签为 latest，这里指定 8.0.33
.：Dockerfile 的所在路径或文件名。这里指定当前路径，他会自动找到 Dockerfile 并构建

为什么要手动制作镜像？

其实如果要使用 Docker Compose，是不用自己手动构建镜像的。但是有遇到过一次异常，Docker Compose 构建的镜像与预期不符，没有可执行的命令，所以紧急情况下手动构建处理（当时是 Docker 19.03.4，可能与 Docker Compose v2.17.2 版本有关？）

03 使用 Docker Compose 管理容器

3.1 Docker Compose Yaml 配置

编写 docker-compose.yaml 文件：

version: '3.9'

services:
  mysql:
    # 运行起来的容器名称
    container_name: mysql-test
    # 自定构建镜像的镜像名称和标签
    image: springx.fun/mysql:8
    # 构建镜像的配置
    build:
      # Dockerfile 所在路径
      context: ./
      # 还可以指定其他参数
    # 重启策略：除非用户主动停止，否则出错就一直重启
    restart: unless-stopped
    # 端口映射：宿主端口:容器端口
    ports:
      - 23306:3306
    # 环境变量
    environment:
      MYSQL_DATABASE: ${MYSQL_DATABASE:-springx}
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-aaa123}
      TZ: Asia/Shanghai
    # 映射：把必要数据映射到指定位置
    volumes:
      - ./mysql/logs/:/logs/
      - ./mysql/data/:/var/lib/mysql/
      - ./mysql/db/:/docker-entrypoint-initdb.d/
      - ./mysql/conf.d/:/etc/mysql/conf.d/
    # Docker 日志限制，否则会无限大，占据过多磁盘
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

3.2 容器重启策略

Dcoker 容器的重启策略（restart）：

no：默认，容器退出不重启
on-failure：失败重启，次数可自定义
always：容器退出时，总是重启
unless-stopped：容器退出时重启，除非手动停止

Docker Compose Version 3 配置如下（See restart policy）：

version: "3.9"
services:
  mysql:
    image: mysql:alpine
    deploy:
      restart_policy:
        condition: on-failure  # 失败重启
        delay: 5s              # 尝试间隔    
        max_attempts: 3        # 最大尝试次数
        window: 120s           # 在决定重启是否成功之前需要等待多长时间

3.3 MySQL 的环境变量

Docker Compose 支持 ${ENV:-DEFAULT} 格式，从环境变量中获取值，一些通用配置、密码等一般都可以通过这种方式配置。

ENV：环境变量，既可以指定环境文件，也可以记录在默认的 .env 文件中（当前目录下）
```
ENV = XXYY
```
DEFAULT：默认值，如果读取不到 ENV，值使用默认值填充。- 为固定写法。

MYSQL_ROOT_PASSWORD

MYSQL_ROOT_PASSWORD 配置 root 用户的初始密码。

正式环境最好还是修改一下。

MYSQL_DATABASE

MYSQL_DATABASE 配置默认数据库，MySQL 容器启动后，会自动创建该数据库，并且初始化的 sql 默认导入该库中。

04 启动容器

4.1 Docker 直接启动

使用 Docker 直接运行，需要注意，部分参数需要注意顺序，比如环境变量，需要在指定镜像之前：

$ docker run \
    -e "MYSQL_ROOT_PASSWORD=ttt123" \
    -e "MYSQL_DATABASE=test" \
    springx.fun/mysql:8 \
    --name mysql-test \
    -d

4.2 Docker Compose 启动

# 启动
$ docker-compose up -d
# 查看容器运行情况
$ docker-compose ps -a
# 查看日志，看看启动是否有误
$ docker-compose logs

当 up 命令执行，Docker Compose 会自动执行 build 命令，构建相应的镜像，然后使用该镜像启动一个容器。