ddev-dbserver Docker镜像文档

1. 镜像概述与主要用途

ddev-dbserver是DDEV项目的数据库服务容器镜像，用于构建DDEV环境中所有MariaDB和MySQL数据库实例。该镜像作为DDEV本地开发环境的核心组件之一，通常不单独使用，而是由DDEV工具自动管理和调度，为本地开发项目提供数据库服务支持。

2. 核心功能与特性

• 多版本数据库支持：
  • MariaDB：支持5.5版本至当前LTS版本
  • MySQL：支持5.5版本至当前LTS版本
• 内置备份工具：集成xtrabackup和mariadb-backup（原mariabackup），提供数据库备份与恢复能力

3. 使用场景与适用范围

适用场景

• DDEV本地开发环境中的数据库服务节点，为PHP或Node.js项目提供MySQL/MariaDB数据库支持
• 配合DDEV工具实现开发环境的快速搭建、版本控制与共享

适用范围

• 仅推荐在DDEV管理的本地开发环境中使用，不建议作为独立数据库服务部署到生产环境

4. 使用方法与配置说明

4.1 运行容器（独立模式）

该镜像通常由DDEV自动管理，若需手动运行（用于调试或测试），可执行以下命令：

docker run -it --rm --entrypoint=bash ddev/ddev-db-server-<mariadb|mysql>-<version>:<tag>

参数说明：

• <mariadb|mysql>：指定数据库类型（MariaDB或MySQL）
• <version>：数据库版本号（如10.6、8.0）
• <tag>：镜像标签（通常与DDEV版本对应，如v1.22.0）
• --entrypoint=bash：覆盖默认入口点，启动bash终端进行交互
• -it：交互式终端模式
• --rm：容器退出后自动删除

4.2 构建与推送镜像

若需自定义构建并推送镜像至Docker Hub，参考DDEV官方文档：
DDEV镜像构建与推送流程

4.3 配置说明

该镜像的数据库配置（如端口、用户名、密码等）通常由DDEV工具通过环境变量自动注入，无需额外手动配置。具体配置可通过DDEV项目配置文件（.ddev/config.yaml）调整。

5. 其他信息

5.1 源代码

[***]

5.2 维护者

DDEV Docker维护团队

5.3 支持与帮助

• 社区***：DDEV Community ***
• Stack Overflow：ddev标签问答

5.4 问题反馈

提交issue至：[***]

5.5 官方文档

• DDEV官方文档
• DDEV官网

5.6 DDEV简介

DDEV是一款开源工具，用于快速搭建本地Web开发环境（支持PHP和Node.js）。其环境可扩展、版本控制和共享，无需Docker经验即可实现Docker工作流。项目可快速启动、停止或删除，简化开发环境管理。

6. 许可证

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

与所有Docker镜像一样，该镜像可能包含其他软件（如基础系统的Bash等），其许可证可能不同。使用前请确保符合所有包含软件的许可证要求。