frega/mariadb

MariaDB Docker镜像文档

镜像概述

MariaDB Docker镜像是由Docker社区维护的官方镜像（非MariaDB上游官方提供），基于Docker Official Image标准构建，用于提供开源关系型数据库服务。该镜像封装了MariaDB数据库系统，旨在简化数据库环境的部署与管理，适用于各类应用场景。

核心功能与特性

• MySQL兼容性：作为MySQL的分支，完全兼容MySQL协议、语法及客户端工具
• 开源免费：遵循GPL许可协议，可免费用于商业和非商业用途
• 多存储引擎支持：包含InnoDB、MyISAM等多种存储引擎，满足不同性能需求
• 跨平台支持：提供amd64等架构支持，适配多种运行环境
• 自动化构建与测试：通过Travis CI等工具进行持续集成，确保镜像质量

使用场景与适用范围

• 开发环境：快速搭建独立的数据库实例，支持应用开发与调试
• 测试环境：提供一致的数据库环境，确保测试结果的可靠性
• 生产环境：可作为中小型应用的数据库服务（建议根据负载进行配置优化）
• CI/CD流程：集成到自动化部署流程中，实现数据库环境的快速 provisioning

使用方法与配置说明

基本使用（docker run）

使用以下命令启动一个基本的MariaDB容器：

bash
docker run --name some-mariadb -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mariadb:latest

参数说明：

• --name some-mariadb：指定容器名称
• -e MYSQL_ROOT_PASSWORD=my-secret-pw：设置root用户密码（必填）
• -d：后台运行容器
• mariadb:latest：使用最新版本的MariaDB镜像

数据持久化

为避免容器删除导致数据丢失，建议挂载数据卷：

bash
docker run --name some-mariadb -v /my/own/datadir:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mariadb:latest

其中/my/own/datadir为宿主机目录，用于持久化存储数据库文件。

环境变量配置

常用环境变量：

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  mariadb:
    image: mariadb:latest
    container_name: mariadb
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: my-secret-pw
      MYSQL_DATABASE: mydb
      MYSQL_USER: myuser
      MYSQL_PASSWORD: myuser-pw
    volumes:
      - mariadb-data:/var/lib/mysql
    ports:
      - "3306:3306"

volumes:
  mariadb-data:

启动服务：

bash
docker-compose up -d

连接到数据库

使用MySQL客户端连接容器内数据库：

bash
docker exec -it some-mariadb mysql -uroot -p

输入之前设置的MYSQL_ROOT_PASSWORD即可登录。

镜像维护与更新

• 镜像源码仓库：https://github.com/docker-library/mariadb
• 官方镜像文档：https://hub.docker.com/_/mariadb/
• 更新检查：可通过https://github.com/docker-library/official-images/blob/master/library/mariadb%E6%9F%A5%E7%9C%8B%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E5%8F%8A%E5%8F%98%E6%9B%B4

构建状态

• Travis CI构建状态：!build status badge
• 自动化更新状态：!build status badge
• 架构构建状态：amd64 !build status badge