200ms/mariadb_dev2

MariaDB Dev²容器

镜像概述

本镜像属于"Dev²套件"的一部分，基于官方MariaDB镜像扩展，旨在简化LAMP应用的开发和测试流程。通过额外脚本消除密码配置、手动账户创建等繁琐任务，提供调试和网络洞察能力，并解决文件权限不匹配问题。

核心功能

• 消除密码配置和账户创建的繁琐操作
• 内置调试工具，支持开发阶段问题排查
• 提供数据库导入/导出脚本（支持.sql、.sql.gz等格式）
• 通过Dev2FS实现共享文件权限映射，避免sudo chown操作
• 支持环境变量自定义数据库配置

使用场景

• 本地开发环境快速搭建MariaDB服务
• 测试环境模拟生产数据库配置
• 团队协作时统一数据库开发环境
• LAMP应用开发中的数据库快速部署和数据迁移

配置说明

FUSE和额外权限

镜像内部使用Dev2FS，需确保Linux主机加载FUSE模块（modprobe fuse），并在运行容器时添加以下权限：

bash
docker run --cap-add SYS_ADMIN --device /dev/fuse ...

Docker Compose配置示例：

yaml
services:
  db:
    cap_add: ['SYS_ADMIN']
    devices: /dev/fuse

特殊目录

推荐将主机目录映射到容器的/dbdump路径，用于共享数据库导入/导出文件，Dev2FS会自动处理权限映射。

启动命令

bash
# 拉取镜像
docker pull docker.xuanyuan.run/200ms/mariadb_dev2
# 创建共享目录
mkdir ./share
# 运行容器
docker run --cap-add SYS_ADMIN --device /dev/fuse \
           -it -v $(pwd)/share:/dbdump \
           docker.xuanyuan.run/200ms/mariadb_dev2

默认值

• 数据库名：mydb
• root密码：随机生成
• admin用户：随机密码（拥有数据库结构和数据操作权限）
• user用户：未实现（计划用于数据操作权限）

使用方法

• 查看数据库凭证：

  bash
  docker exec <容器名> d2mydb.sh info
  

• 导入数据库：

  bash
  docker exec <容器名> d2mydb.sh import <文件名>
  # 或恢复最新备份
  docker exec <容器名> d2mydb.sh restore
  

• 导出数据库：

  bash
  # 导出指定数据库
  docker exec <容器名> d2mydb.sh dump <数据库名> [文件名]
  # 导出所有数据库
  docker exec <容器名> d2mydb.sh dumpall [文件名]
  

环境变量

可通过环境变量自定义配置：

• MARIADB_DATABASE：数据库名（默认mydb）
• MARIADB_USER：数据库用户（默认admin）
• MARIADB_PASSWORD：用户密码（默认随机）
• MARIADB_ROOT_PASSWORD：root密码（默认随机）
• MARIADB_ALLOW_EMPTY_ROOT_PASSWORD：允许空root密码（需设为yes）
• DBDUMPDIR：备份目录（默认/dbdump）

Docker Compose示例

yaml
networks:
  d2-net:
    external: false

services:
  db:
    image: docker.xuanyuan.run/200ms/mariadb_dev2
    networks:
      - d2-net
    ports:
      - 3306:3306
    volumes:
      - ./data:/dbdump
    cap_add: ['SYS_ADMIN']
    devices:
      - /dev/fuse

注意事项：

1. 镜像仅在Linux系统测试过，其他系统暂不支持。
2. 部分功能仍在开发中，如有问题可在BitBucket提交反馈。