Docker 最佳实战：Docker 部署单节点 MariaDB 实战指南

运维有术

发布于 2024-07-16 15:26:25

1450

发布于 2024-07-16 15:26:25

文章被收录于专栏：运维有术

你好，欢迎来到运维有术。

今天分享的内容是 Docker 最佳实战「2024」 系列文档中的 Docker 部署单节点 MariaDB 实战指南。

本文将详细介绍如何利用 Docker 容器化技术以及 Docker Compose 工具，快速部署一个高效、稳定的单节点 MariaDB 数据库实例

实战服务器配置 (架构 1:1 复刻小规模生产环境，配置略有不同)

主机名	IP	CPU（核）	内存（GB）	系统盘（GB）	数据盘（GB）	用途
docker-node-1	192.168.9.81	4	16	40	100	Docker 节点 1
docker-node-2	192.168.9.82	4	16	40	100	Docker 节点 2
docker-node-3	192.168.9.83	4	16	40	100	Docker 节点 3
合计	3	12	48	120	300

实战环境涉及软件版本信息

操作系统：openEuler 22.03 LTS SP3
Docker：24.0.7
MariaDB：10.11.8

1. 前提条件

主流的 MariaDB 有 10.x.x 和 11.x.x 两个版本，10 和 11 两个大版本又分了许多小版本。本文选择了 10 系列的最新版 10.11.8 ，实际使用中请根据项目需求选择具体的版本。

目前主流的 mariadb 容器化部署方案可用的镜像有以下几种：

mariadb （DockerHub 官方出品，MariaDB Foundation 维护，下载量 1B+）
bitnami/mariadb （Bitnami 出品，下载量 500M+）

本人选择使用 Docker 镜像的策略是：

优先使用 DockerHub官方
其次选择软件供应商官方镜像
自己构建镜像

因此，本文选择下载量最大、DockerHub 官方出品的镜像，构建单节点 MariaDB 服务。

2. 部署单节点 MariaDB

2.1 创建数据目录

cd /data/containers
mkdir -p mariadb/{data,config,logs}

data： 存储容器持久化数据
config： 配置文件目录
logs： 服务日志目录（可选）

2.2 创建 MariaDB 自定义配置文件

MariaDB 默认使用的 my.cnf 配置文件，适配的使用场景有限，生产或开发环境需要根据需求自定义 MariaDB 配置文件。

本文随机找了一份配置文件，仅仅是为了实现自定义配置的功能，请根据自己的使用场景自定义配置文件。

创建自定义 MariaDB 配置文件，vi mariadb/config/mysqld.cnf

[mysqld]
# performance settings
lock_wait_timeout = 3600
open_files_limit = 65535
back_log = 1024
max_connections = 1024
max_connect_errors = 1000000
table_open_cache = 1024
table_definition_cache = 1024
thread_stack = 512K
sort_buffer_size = 4M
join_buffer_size = 4M
read_buffer_size = 8M
read_rnd_buffer_size = 4M
bulk_insert_buffer_size = 64M
thread_cache_size = 768
interactive_timeout = 600
wait_timeout = 600
tmp_table_size = 32M
max_heap_table_size = 32M
innodb_open_files = 1024

# TLS 配置
tls_version = TLSv1.2

2.3 创建 Docker Compose 配置文件

创建并编辑 Docker Compose 配置文件，vi mariadb/docker-compose.yml ，加入以下内容。

services:
  mariadb:
    container_name: mariadb
    hostname: mariadb
    image: mariadb:10.11.8
    restart: always
    ulimits:
      nofile:
        soft: 65536
        hard: 65536
    environment:
      - TZ=Asia/Shanghai
      - MYSQL_ROOT_PASSWORD=OpsXlab!2024
    volumes:
      - ./data:/var/lib/mysql
      - ./config:/etc/mysql/conf.d/
    networks:
      - app-tier
    ports:
      - 3306:3306

networks:
  app-tier:
    name: app-tier
    driver: bridge
    #external: true

参数说明：

MYSQL_ROOT_PASSWORDD： 默认管理员 root 用户密码
volumes 将自定义的 MariaDB 配置文件挂载到容器中的 /etc/mysql/conf.d/ 目录下
ulimits 设置最大的文件打开数，用于提高 MariaDB 服务的性能

2.4 创建并启动服务

启动服务

cd /data/containers/mariadb
docker compose up -d

2.5 验证容器状态

查看容器状态

$ docker compose ps
NAME      IMAGE             COMMAND                  SERVICE   CREATED         STATUS         PORTS
mariadb   mariadb:10.11.8   "docker-entrypoint.s…"   mariadb   7 seconds ago   Up 6 seconds   0.0.0.0:3306->3306/tcp, :::3306->3306/tcp

查看容器日志

# 通过日志查看容器是否有异常，结果略
docker compose logs -f

3. MariaDB 服务可用性测试

为了测试 MariaDB 服务的可用性，利用 Docker 创建一个 MariaDB 客户端容器实例，并执行几个简单的查询命令。

创建 MariaDB 客户端实例

docker run -it --rm --network app-tier mariadb:10.11.8 mariadb -h 192.168.9.81 -uroot -p

说明： 该命令会连接指定的数据库并提供一个标准的 MariaDB 提示符，可以执行相关 SQL 命令。

查看版本和连接信息

MariaDB [(none)]> \s
--------------
mariadb  Ver 15.1 Distrib 10.11.8-MariaDB, for debian-linux-gnu (x86_64) using  EditLine wrapper

Connection id:          3
Current database:
Current user:           root@172.20.0.1
SSL:                    Not in use
Current pager:          stdout
Using outfile:          ''
Using delimiter:        ;
Server:                 MariaDB
Server version:         10.11.8-MariaDB-ubu2204 mariadb.org binary distribution
Protocol version:       10
Connection:             192.168.9.81 via TCP/IP
Server characterset:    utf8mb4
Db     characterset:    utf8mb4
Client characterset:    utf8mb3
Conn.  characterset:    utf8mb3
TCP port:               3306
Uptime:                 2 min 47 sec

Threads: 1  Questions: 4  Slow queries: 0  Opens: 17  Open tables: 10  Queries per second avg: 0.023
--------------

验证自定义配置是否生效

MariaDB [(none)]> show variables like '%max_conn%';
+-----------------------+---------+
| Variable_name         | Value   |
+-----------------------+---------+
| extra_max_connections | 1       |
| max_connect_errors    | 1000000 |
| max_connections       | 1024    |
+-----------------------+---------+
3 rows in set (0.001 sec)