owncloudops/mariadb

mariadb

![构建状态]([] ![Quay.io]([]

MariaDB的自定义容器镜像。

镜像概述和主要用途

该镜像提供MariaDB数据库服务，支持通过环境变量进行灵活配置，包含数据持久化机制和备份功能，适用于需要可靠、可定制的MariaDB数据库环境的应用部署。

核心功能和特性

• 提供标准MariaDB数据库服务，默认暴露3306端口
• 支持数据持久化存储，确保数据库数据不丢失
• 通过环境变量自定义数据库配置参数，满足不同场景需求
• 内置备份功能，支持数据库备份调度和存储

端口

• 3306：MariaDB数据库服务默认端口

卷

• /var/lib/mysql：数据库数据存储目录，建议挂载以实现数据持久化
• /var/lib/backup：备份文件存储目录，需挂载以持久化保存备份数据

环境变量

Shell
# 数据库基础配置
MARIADB_DATABASE=          # 初始数据库名称
MARIADB_USER=              # 数据库用户
MARIADB_PASSWORD=          # 数据库用户密码
MARIADB_ROOT_PASSWORD=     # 数据库root用户密码

# 备份配置
MARIADB_BACKUP_HOST=mariadb  # 备份目标数据库主机
MARIADB_BACKUP_PORT=3306     # 备份目标数据库端口

# [mysql] 配置段
MARIADB_DEFAULT_CHARACTER_SET=utf8mb4  # 默认字符集

# [mysqld] 配置段
MARIADB_CHARACTER_SET_SERVER=utf8mb4        # 服务器字符集
MARIADB_COLLATION_SERVER=utf8mb4_general_ci # 服务器排序规则
MARIADB_TRANSACTION_ISOLATION=              # 事务隔离级别
MARIADB_KEY_BUFFER_SIZE=128M                # 键缓冲区大小
MARIADB_MAX_ALLOWED_PACKET=16M              # 最大允许数据包大小
MARIADB_TABLE_OPEN_CACHE=2000               # 表打开缓存数量
MARIADB_SORT_BUFFER_SIZE=2M                 # 排序缓冲区大小
MARIADB_NET_BUFFER_SIZE=16K                 # 网络缓冲区大小
MARIADB_READ_BUFFER_SIZE=128K               # 读缓冲区大小
MARIADB_READ_RND_BUFFER_SIZE=256K           # 随机读缓冲区大小
MARIADB_MYISAM_SORT_BUFFER_SIZE=128MB       # MyISAM排序缓冲区大小
MARIADB_MAX_CONNECTIONS=151                 # 最大连接数
MARIADB_LOG_BIN=0                           # 是否启用二进制日志（0为禁用）
MARIADB_BINLOG_FORMAT=MIXED                 # 二进制日志格式
MARIADB_INNODB_DATA_FILE_PATH=ibdata1:12M:autoextend  # InnoDB数据文件路径
MARIADB_INNODB_BUFFER_POOL_SIZE=128M        # InnoDB缓冲池大小
MARIADB_INNODB_LOG_FILE_SIZE=96M            # InnoDB日志文件大小
MARIADB_INNODB_LOG_BUFFER_SIZE=16M          # InnoDB日志缓冲区大小
MARIADB_INNODB_FLUSH_LOG_AT_TRX_COMMIT=1    # 事务提交时日志刷新策略
MARIADB_INNODB_LOCK_WAIT_TIMEOUT=50         # InnoDB锁等待超时时间（秒）
MARIADB_INNODB_USE_NATIVE_AIO=ON            # 是否使用原生AIO
MARIADB_INNODB_FILE_PER_TABLE=ON            # 是否每个表使用独立文件
MARIADB_INNODB_READ_ONLY_COMPRESSED=OFF     # 是否只读压缩表

使用场景和适用范围

适用于需要部署MariaDB数据库的各类应用场景，包括但不限于Web应用后端、企业信息系统、开发测试环境等，尤其适合需要自定义数据库配置和定期备份功能的场景。

使用方法和配置说明

基本部署

通过以下命令启动MariaDB容器，包含基础配置和数据持久化：

Shell
docker run -d \
  --name mariadb \
  -p 3306:3306 \
  -v /host/path/to/mysql/data:/var/lib/mysql \
  -e MARIADB_ROOT_PASSWORD=your_secure_root_password \
  -e MARIADB_DATABASE=app_db \
  -e MARIADB_USER=app_user \
  -e MARIADB_PASSWORD=app_user_password \
  owncloudops/mariadb:latest

数据库备份

使用容器进行数据库备份，需确保备份容器与数据库容器在同一网络，并挂载备份卷：

Shell
docker run --no-healthcheck \
  --network my-app-network \
  --entrypoint /usr/bin/entrypoint \
  -v /host/path/to/backups:/var/lib/backup \
  -e MARIADB_ROOT_PASSWORD=your_secure_root_password \
  -it owncloudops/mariadb:latest backup

构建镜像

如需自定义构建镜像，可使用以下命令：

Shell
docker build -f Dockerfile -t mariadb:latest .

许可证

本项目采用Apache 2.0许可证 - 详见https://github.com/owncloud-ops/mariadb/blob/main/LICENSE%E6%96%87%E4%BB%B6%E3%80%82