ddev-dbserver Docker镜像文档

镜像概述

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

核心功能与特性

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

使用场景与适用范围

作为DDEV本地开发环境的数据库服务组件，主要适用于：

• PHP和Node.js Web项目的本地开发数据库环境搭建。
• 快速创建与生产环境一致的数据库配置，减少环境差异导致的问题。
• 团队协作中共享统一的数据库环境配置，确保开发一致性。
• 支持版本控制的数据库环境，便于项目迁移和回溯。

使用方法与配置说明

主要使用方式（通过DDEV）

ddev-dbserver镜像主要通过DDEV工具自动调用，无需手动配置。使用步骤如下：

1. 安装DDEV（参考DDEV***文档）。
2. 在项目目录初始化DDEV：

   bash
   ddev config
   

3. 启动DDEV环境（自动拉取并运行ddev-dbserver镜像）：

   bash
   ddev start
   

DDEV会自动根据项目配置（如.ddev/config.yaml中的database_type和database_version）选择对应的数据库类型（MariaDB/MySQL）和版本，并配置ddev-dbserver容器。

单独运行（调试或特殊场景）

如需单独运行容器（非推荐，仅用于调试），可使用以下命令：

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

• 参数说明：
  • <mariadb|mysql>：数据库类型，选择mariadb或mysql。
  • <version>：数据库版本号，如10.6（MariaDB）或8.0（MySQL）。
  • <tag>：镜像标签，通常与DDEV版本对应（如v1.22.0）。

相关资源

源代码

[***]

维护者

DDEV Docker维护团队

支持与帮助

• DDEV社区***
• Stack Overflow（ddev标签）

问题反馈

提交问题至GitHub Issues：[***]

***文档

• DDEV文档中心
• DDEV官网

关于DDEV

DDEV是一款开源工具，可在几分钟内启动本地Web开发环境，支持PHP和Node.js项目。其核心优势包括：

• 无需Docker经验即可享受Docker工作流。
• 环境可扩展、版本控制和共享。
• 项目启动、停止、移除简单便捷，支持快速迭代开发。

许可证信息

镜像包含软件的许可证信息详见LICENSE文件。

与所有Docker镜像一样，本镜像可能包含其他软件（如基础系统的Bash等），这些软件可能具有独立许可证。使用前请确保遵守所有包含软件的相关许可证要求。