devilboxcommunity/mysql

Devilbox MySQL系列镜像文档

镜像概述

Devilbox MySQL系列镜像是Devilbox项目提供的容器化数据库解决方案，支持Percona、MySQL、MariaDB等主流关系型数据库系统。该系列镜像基于官方精简基础镜像构建，专为开发环境优化，旨在提供快速部署、版本一致且配置灵活的数据库服务，适用于本地开发、团队协作及容器化部署场景。

核心功能与特性

多数据库类型支持

• 集成Percona Server（MySQL分支，优化性能与可靠性）
• 原生MySQL官方版本支持
• MariaDB（社区维护的MySQL分支）兼容版本

多版本覆盖

• 提供各数据库系统的多个稳定版本标签（如MySQL 5.7/8.0、MariaDB 10.4/10.6、Percona 5.7/8.0等），满足不同项目兼容性需求

轻量级与优化设计

• 基于官方alpine或slim基础镜像构建，镜像体积小，启动速度快
• 移除生产环境非必要组件，保留开发必需功能，降低资源占用

配置灵活性

• 支持通过环境变量快速配置核心参数（如root密码、默认数据库、用户权限等）
• 支持挂载自定义配置文件（my.cnf）覆盖默认配置，实现高级调优

数据持久化

• 内置数据目录（/var/lib/mysql）支持外部卷挂载，确保容器重启后数据不丢失
• 兼容Docker命名卷与宿主机目录挂载两种持久化方式

Devilbox生态集成

• 与Devilbox本地开发环境无缝集成，支持一键加入LAMP/LEMP栈架构
• 兼容Docker Compose编排，可与其他服务（如Web服务器、缓存服务）联动

使用场景

开发环境数据库服务

• 本地开发时快速启动独立数据库实例，避免本地环境污染
• 多项目并行开发时，通过不同容器实例隔离数据库环境

团队协作与环境一致性

• 统一团队开发数据库版本与配置，消除"本地能跑，线上报错"问题
• 新人入职时无需手动配置数据库，通过镜像一键启动标准化环境

CI/CD流程支持

• 作为CI/CD流水线中的临时测试数据库，提供独立的测试环境
• 自动化测试环节中快速创建/销毁数据库实例，降低环境依赖

微服务架构集成

• 作为微服务架构中的独立数据库容器，与应用服务解耦部署
• 支持横向扩展多个数据库实例，满足分布式应用需求

使用方法与配置说明

基础使用（Docker Run）

启动MySQL实例

bash
docker run -d \
  --name devilbox-mysql \
  -e MYSQL_ROOT_PASSWORD=dev_root_pass \  # 必选：root用户密码
  -e MYSQL_DATABASE=dev_project_db \      # 可选：初始化时创建的数据库
  -e MYSQL_USER=dev_user \                # 可选：创建普通用户
  -e MYSQL_PASSWORD=dev_user_pass \       # 可选：普通用户密码
  -v mysql-data:/var/lib/mysql \          # 数据持久化（命名卷）
  -p 3306:3306 \                          # 端口映射（宿主机:容器）
  devilbox/mysql:8.0                      # 指定MySQL 8.0版本

启动MariaDB实例

bash
docker run -d \
  --name devilbox-mariadb \
  -e MYSQL_ROOT_PASSWORD=dev_root_pass \
  -v $(pwd)/local-data:/var/lib/mysql \   # 数据持久化（宿主机目录）
  -p 3306:3306 \
  devilbox/mariadb:10.6                   # 指定MariaDB 10.6版本

启动Percona实例

bash
docker run -d \
  --name devilbox-percona \
  -e MYSQL_ROOT_PASSWORD=dev_root_pass \
  -e MYSQL_DATABASE=percona_test \
  -p 3306:3306 \
  devilbox/percona:8.0                    # 指定Percona 8.0版本

Docker Compose配置示例

yaml
version: '3.8'
services:
  db:
    image: devilbox/mysql:8.0
    container_name: devilbox-mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: dev_root_pass
      MYSQL_DATABASE: app_db
      MYSQL_USER: app_user
      MYSQL_PASSWORD: app_pass
    volumes:
      - mysql-data:/var/lib/mysql
      - ./custom-my.cnf:/etc/mysql/conf.d/custom.cnf  # 挂载自定义配置
    ports:
      - "3306:3306"
    networks:
      - dev-network

volumes:
  mysql-data:  # 命名卷自动创建

networks:
  dev-network:
    driver: bridge

核心配置参数

环境变量

数据持久化

通过-v参数挂载数据卷，确保容器删除或重启后数据不丢失：

• 命名卷（推荐）：-v mysql-data:/var/lib/mysql（Docker管理卷生命周期）
• 宿主机目录：-v /path/on/host:/var/lib/mysql（手动管理宿主机目录权限）

自定义配置

通过挂载my.cnf配置文件覆盖默认设置：

bash
-v /path/to/custom/my.cnf:/etc/mysql/conf.d/custom.cnf

配置文件示例（调整连接数与缓存）：

ini
[mysqld]
max_connections = 500
innodb_buffer_pool_size = 256M
query_cache_size = 0  # MySQL 8.0已移除query_cache，需根据版本调整

版本标签说明

镜像标签格式为devilbox/<数据库类型>:<版本号>，支持的主要标签：

• MySQL: devilbox/mysql:5.6, devilbox/mysql:5.7, devilbox/mysql:8.0
• MariaDB: devilbox/mariadb:10.3, devilbox/mariadb:10.4, devilbox/mariadb:10.6, devilbox/mariadb:10.11
• Percona: devilbox/percona:5.7, devilbox/percona:8.0

可通过https://hub.docker.com/r/devilbox/mysql%E6%9F%A5%E7%9C%8B%E5%AE%8C%E6%95%B4%E7%89%88%E6%9C%AC%E5%88%97%E8%A1%A8%E3%80%82