brightspot/mysql 镜像文档

镜像概述和主要用途

brightspot/mysql 是 brightspot/tomcat 的配套 MySQL 容器，专为本地开发环境设计。该镜像提供 MySQL 数据库服务，用于支持 brightspot/tomcat 应用在本地开发和测试过程中的数据存储需求，简化开发环境的搭建与集成。

核心功能和特性

• 配套集成：与 brightspot/tomcat 容器无缝配合，确保开发环境中应用与数据库的兼容性
• 本地开发优化：针对本地开发场景配置，支持快速启动和基础数据库操作
• 简化配置：减少开发环境中数据库的手动配置步骤，提升开发效率
• 轻量适用：适合开发、测试阶段使用，提供基础数据库功能支持

使用场景和适用范围

• 本地应用开发：开发人员在本地构建基于 brightspot/tomcat 的应用时，作为配套数据库服务
• 功能测试验证：在测试环境中验证应用与数据库的交互逻辑
• 开发环境快速搭建：团队协作时统一本地开发环境的数据库配置

使用方法和配置说明

基本启动命令

通过 docker run 命令启动容器，基本格式如下：

bash
docker run -d --name brightspot-mysql brightspot/mysql

环境变量配置

可通过环境变量自定义 MySQL 服务配置（具体支持的变量请参考*** MySQL 镜像文档，以下为常用配置示例）：

• MYSQL_ROOT_PASSWORD：设置 root 用户密码（必填）
• MYSQL_DATABASE：初始化创建的数据库名称
• MYSQL_USER：创建的数据库用户（非 root）
• MYSQL_PASSWORD：对应 MYSQL_USER 的密码

示例：

bash
docker run -d \
  --name brightspot-mysql \
  -e MYSQL_ROOT_PASSWORD=devrootpass \
  -e MYSQL_DATABASE=brightspot_dev \
  -e MYSQL_USER=brightspot_user \
  -e MYSQL_PASSWORD=devuserpass \
  brightspot/mysql

与 brightspot/tomcat 容器联动

1. 启动 brightspot/tomcat 容器

bash
docker run -d --name brightspot-tomcat brightspot/tomcat

2. 启动配套 MySQL 容器并建立连接

通过 --link 参数（或 Docker 网络）实现容器间通信：

bash
docker run -d \
  --name brightspot-mysql \
  -e MYSQL_ROOT_PASSWORD=devrootpass \
  -e MYSQL_DATABASE=brightspot_dev \
  --link brightspot-tomcat:tomcat \  # 建立与 tomcat 容器的关联
  brightspot/mysql

数据持久化（可选）

为避免容器重启后数据丢失，可挂载本地目录持久化存储数据：

bash
docker run -d \
  --name brightspot-mysql \
  -e MYSQL_ROOT_PASSWORD=devrootpass \
  -v /path/on/host/mysql-data:/var/lib/mysql \  # 挂载本地目录到容器数据目录
  brightspot/mysql

注意事项

• 该镜像仅建议用于开发和测试环境，不适合生产环境部署
• 确保与 brightspot/tomcat 容器版本兼容，建议使用***推荐的版本组合
• 生产环境需根据实际需求加强安全配置（如网络隔离、密码策略等）