ddev-dbserver Docker镜像文档

镜像概述与主要用途

ddev-dbserver是DDEV项目的数据库服务容器镜像，用于构建DDEV环境中的MariaDB和MySQL数据库服务。该镜像作为DDEV本地开发环境的核心组件之一，通常不单独使用，而是与DDEV工具链协同工作，为本地Web开发提供数据库支持。

核心功能与特性

• 多版本数据库支持：兼容MariaDB 5.5至当前LTS版本，以及MySQL 5.5至当前LTS版本，满足不同项目的数据库版本需求。
• 内置备份工具：集成xtrabackup和mariadb-backup（原mariabackup），支持数据库数据的高效备份与恢复。

使用场景与适用范围

适用场景

• 作为DDEV本地开发环境的数据库服务组件，为PHP/Node.js项目提供MariaDB或MySQL数据库支持。
• 用于本地开发、测试环境的数据库部署，支持数据持久化与快速环境重置。

限制说明

• 不建议单独使用：该镜像专为DDEV工作流设计，单独运行时可能缺少必要的环境配置与依赖，无法发挥完整功能。
• 开发环境专用：仅适用于本地开发与测试，不推荐用于生产环境。

使用方法与配置说明

通过DDEV使用（推荐）

ddev-dbserver镜像的主要使用方式是通过DDEV工具自动部署，无需手动配置。具体步骤参考DDEV官方文档。

手动运行容器（仅调试/开发）

若需单独运行容器进行调试（不推荐生产使用），可执行以下命令：

# 替换<mariadb|mysql>为数据库类型，<version>为版本号，<tag>为镜像标签
docker run -it --rm --entrypoint=bash ddev/ddev-db-server-<mariadb|mysql>-<version>:<tag>

• --rm：容器退出后自动删除，避免残留。
• --entrypoint=bash：覆盖默认入口点，直接进入容器终端。

构建与推送镜像

如需自定义构建并推送镜像至Docker Hub，参考DDEV发布管理文档：Pushing Docker Images with the GitHub Actions Workflow。

支持与维护信息

源代码

镜像构建代码托管于：[***]

维护者

由DDEV Docker维护团队维护。

获取帮助

• DDEV社区***：[***]
• Stack Overflow：使用标签 ddev 提问

问题反馈

如遇功能异常或缺陷，可在GitHub提交issue：[***]

官方文档

• DDEV用户文档：[***]
• DDEV官网：[***]

关于DDEV

DDEV 是一款开源工具，用于快速搭建本地Web开发环境（支持PHP和Node.js）。其核心优势包括：

• 无需Docker经验即可使用Docker工作流；
• 环境可扩展、版本控制与共享；
• 项目启动、停止、删除操作简单高效。

许可证信息

镜像包含软件的许可证信息参见：[***]

与所有Docker镜像一样，本镜像可能包含基础系统（如Bash等）及依赖软件，这些组件可能具有独立许可证。使用前请确保遵守所有包含软件的许可协议。