tutum/mysql

tutum-docker-mysql

镜像概述和主要用途

tutum-docker-mysql是用于运行MySQL数据库服务器的基础Docker镜像。它提供了便捷的部署方式，支持多种配置选项，适用于开发、测试及生产环境中快速搭建MySQL服务。

MySQL版本

不同MySQL版本从不同文件夹构建。如需使用MariaDB，请查看tutum/mariadb镜像：https://github.com/tutumcloud/tutum-docker-mariadb

核心功能和特性

• 首次运行自动创建带随机密码的admin用户
• 支持自定义管理员用户名和密码
• 可在容器创建时自动创建指定数据库
• 支持数据卷挂载实现数据持久化
• 支持通过其他容器存储数据库文件
• 提供数据库迁移工具和方法
• 支持主从复制配置

使用场景和适用范围

• 开发环境快速部署MySQL服务
• 测试环境需要隔离的数据库实例
• 需要数据持久化的MySQL部署
• 构建主从复制架构以提高读取性能
• 迁移现有MySQL服务器到容器环境

使用方法和配置说明

构建镜像

在tutum-mysql文件夹中执行以下命令创建tutum/mysql镜像（以5.5版本为例）：

bash
docker build -t tutum/mysql 5.5/

基本运行

运行镜像并绑定3306端口：

bash
docker run -d -p 3306:3306 tutum/mysql

获取初始密码

首次运行容器时，会创建admin用户并生成随机密码。通过容器日志查看密码：

bash
docker logs <CONTAINER_ID>

日志输出示例：

========================================================================
You can now connect to this MySQL Server using:

    mysql -uadmin -p47nnf4FweaKu -h<host> -P<port>

Please remember to change the above password as soon as possible!
MySQL user 'root' has no password but only allows local connections.
========================================================================

其中47nnf4FweaKu即为admin用户的密码。

测试连接

bash
mysql -uadmin -p

设置管理员账户的特定密码

通过MYSQL_PASS环境变量设置预设密码：

bash
docker run -d -p 3306:3306 -e MYSQL_PASS="mypass" tutum/mysql

测试连接：

bash
mysql -uadmin -p"mypass"

管理员用户名可通过MYSQL_USER环境变量设置。

创建初始数据库

通过ON_CREATE_DB环境变量指定容器创建时自动创建的数据库名称：

bash
docker run -d -p 3306:3306 -e ON_CREATE_DB="database" tutum/mysql

挂载数据库文件卷

为持久化数据库数据，可将主机本地文件夹挂载到容器的/var/lib/mysql目录（MySQL默认数据存储路径）：

1. 初始化数据库结构：

bash
docker run -d -v /path/in/host:/var/lib/mysql tutum/mysql /bin/bash -c "/usr/bin/mysql_install_db"

注意：主机需确保/path/in/host目录存在

2. 启动MySQL容器（使用已挂载的目录）：

bash
docker run -d -p 3306:3306 -v /path/in/host:/var/lib/mysql tutum/mysql

从其他容器挂载数据库文件卷

另一种持久化方式是将数据库文件存储在专用数据容器中：

1. 创建数据容器（以tutum/ubuntu-trusty为基础镜像）：

bash
docker run -d -v /var/lib/mysql --name db_vol -p 22:22 tutum/ubuntu-trusty

--name选项可指定容器名称，供后续步骤使用

2. 使用数据容器启动MySQL：

bash
docker run -d --volumes-from db_vol -p 3306:3306 tutum/mysql

迁移现有MySQL服务器

导出数据

从现有服务器导出数据库结构：

bash
mysqldump -u<user> -p --opt -d -B <database name(s)> > /tmp/dbserver_schema.sql

导出数据库数据：

bash
mysqldump -u<user> -p --quick --single-transaction -t -n -B <database name(s)> > /tmp/dbserver_data.sql

导入数据

方法1：通过/import_sql.sh脚本导入（假设SQL文件位于主机/tmp目录）：

bash
sudo docker run -d -v /tmp:/tmp tutum/mysql /bin/bash -c "/import_sql.sh <user> <pass> /tmp/<dump.sql>"

方法2：启动时通过STARTUP_SQL环境变量指定初始化SQL文件：

bash
sudo docker run -d -v /path/in/host:/var/lib/mysql -e STARTUP_SQL="/tmp/<dump.sql>" tutum/mysql

<user>和<pass>为之前设置的数据库用户名和密码，<dump.sql>为SQL文件名

主从复制配置

通过设置环境变量REPLICATION_MASTER或REPLICATION_SLAVE启用主从复制。主库可通过REPLICATION_USER和REPLICATION_PASS指定复制账户（默认值：replica:replica）。

主库示例

bash
docker run -d -e REPLICATION_MASTER=true -e REPLICATION_PASS=mypass -p 3306:3306 --name mysql tutum/mysql

从库示例

bash
docker run -d -e REPLICATION_SLAVE=true -p 3307:3306 --link mysql:mysql tutum/mysql

可通过3306端口访问主库，3307端口访问从库

环境变量

• MYSQL_USER：管理员账户用户名（默认：admin）
• MYSQL_PASS：管理员账户密码（未设置时自动生成随机密码）
• STARTUP_SQL：初始化数据库的一个或多个SQL脚本（空格分隔，需确保脚本在容器内可访问）
• ON_CREATE_DB：容器创建时自动创建的数据库名称
• REPLICATION_MASTER：设为true启用主库模式
• REPLICATION_SLAVE：设为true启用从库模式
• REPLICATION_USER：复制账户用户名（默认：replica）
• REPLICATION_PASS：复制账户密码（默认：replica）

兼容性问题

• MySQL 5.6创建的数据卷不能用于MySQL 5.5镜像或MariaDB镜像。