paintedfox/mariadb

MariaDB Docker镜像

镜像概述和主要用途

本Docker镜像用于运行MariaDB 5.5数据库服务，MariaDB是MySQL的直接替代品，提供兼容的功能和性能。该镜像设计用于快速部署独立的MariaDB数据库环境，支持数据持久化存储，并可与其他容器化应用集成。

核心功能和特性

• 兼容性：基于MariaDB 5.5，完全兼容MySQL协议和客户端
• 数据持久化：数据库数据存储在容器内/data目录，支持通过卷映射实现主机持久化
• 灵活配置：通过环境变量自定义超级用户的用户名和密码
• 容器集成：支持容器链接功能，方便与其他应用容器（如Web应用）集成
• 便捷构建：提供make命令支持，简化镜像构建和容器运行流程

使用场景和适用范围

• 开发环境中的独立数据库服务部署
• 需要数据持久化的MariaDB数据库实例
• 容器化应用架构中的数据库层组件
• 快速搭建临时测试数据库环境

镜像创建

基本构建方法

使用以下命令构建镜像，默认标签为paintedfox/mariadb：

shell
$ docker build -t="paintedfox/mariadb" .

使用Makefile构建

若系统已安装make，可直接执行：

shell
$ make

自定义Docker用户名

指定自定义Docker用户名构建镜像：

shell
$ make DOCKER_USER=自定义用户名

容器创建与运行

基本运行命令

创建并运行容器，包含数据卷映射、端口映射和环境变量配置：

shell
$ mkdir -p /tmp/mariadb  # 创建主机数据目录
$ docker run -d -name="mariadb" \
             -p 127.0.0.1:3306:3306 \  # 端口映射（主机:容器）
             -v /tmp/mariadb:/data \   # 数据卷映射（主机目录:容器/data）
             -e USER="super" \         # 超级用户名
             -e PASS="$(pwgen -s -1 16)" \  # 随机生成16位密码
             paintedfox/mariadb

使用Makefile运行

通过make命令简化运行过程：

shell
$ make run

自定义运行参数

可指定自定义端口、数据目录及用户凭据：

shell
$ sudo mkdir -p /srv/docker/mariadb  # 创建自定义数据目录
$ make run PORT=127.0.0.1:3306 \     # 自定义端口映射
           DATA_DIR=/srv/docker/mariadb \  # 自定义数据目录
           USER=super \               # 自定义超级用户名
           PASS=$(pwgen -s -1 16)     # 自定义密码（或随机生成）

连接数据库

安装客户端

在Ubuntu 12.04LTS系统上安装MySQL客户端：

shell
$ sudo apt-get install mysql-client

获取登录凭据

容器启动时会生成超级用户凭据，通过容器日志查看：

shell
$ docker logs mariadb
MARIADB_USER=super
MARIADB_PASS=FzNQiroBkTHLX7y4
MARIADB_DATA_DIR=/data
Starting MariaDB...
140103 20:33:49 mysqld_safe Logging to '/data/mysql.log'.
140103 20:33:49 mysqld_safe Starting mysqld daemon with databases from /data

连接数据库

使用获取的凭据连接数据库：

shell
$ mysql -u super --password=FzNQiroBkTHLX7y4 --protocol=tcp

与数据库容器链接

创建链接容器

将应用容器与数据库容器链接，实现跨容器访问：

shell
$ docker run -t -i -link mariadb:db ubuntu bash

说明：-link mariadb:db表示将名为mariadb的数据库容器以别名db链接到新容器

在链接容器中访问数据库

在链接容器中安装MySQL客户端并连接数据库：

shell
$ apt-get install -y mysql-client
$ mysql -u "$DB_ENV_USER" --password="$DB_ENV_PASS" -h "$DB_PORT_3306_TCP_ADDR" -P "$DB_PORT_3306_TCP_PORT"

环境变量说明：链接容器会自动获取数据库容器的环境变量，前缀为DB_ENV_（因别名为db），包含：

• DB_ENV_USER：数据库超级用户名
• DB_ENV_PASS：数据库超级用户密码
• DB_PORT_3306_TCP_ADDR：数据库容器IP地址
• DB_PORT_3306_TCP_PORT：数据库容器端口号