docker/cruise-example-database

示例数据库容器 (Docker EE Hosted Demo)

镜像概述和主要用途

本镜像为 Docker EE (Enterprise Edition) 托管演示环境设计的示例数据库容器，旨在提供轻量级、预配置的数据库服务，用于演示 Docker EE 平台中容器化数据库的部署、管理及集成流程。主要用途包括 Docker EE 功能演示、容器编排测试、数据库容器化教学及快速原型验证。

核心功能和特性

• 轻量级设计：基于精简数据库引擎（如 SQLite 或轻量 MySQL 变体），镜像体积小，启动速度快，适合演示场景。
• 预配置演示数据：内置示例数据集（如用户表、订单表），无需手动初始化即可展示数据库操作流程。
• Docker EE 集成优化：适配 Docker EE 平台特性，支持与 Docker Swarm 或 Kubernetes 编排工具集成，兼容 EE 级网络策略和资源限制配置。
• 快速部署能力：提供默认配置参数，支持一行命令启动，降低演示环境搭建复杂度。
• 基础持久化支持：支持数据卷挂载，可临时保存演示数据，便于展示容器数据持久化方案。

使用场景和适用范围

• Docker EE 平台演示：用于展示 Docker EE 中容器部署、服务发现、负载均衡等核心功能。
• 开发/测试环境：供开发人员快速搭建临时数据库环境，验证应用与数据库的交互逻辑。
• 培训与教学：作为 Docker EE 容器管理培训的实操案例，帮助学员理解容器化数据库的生命周期管理。
• 原型验证：在项目初期验证数据库架构设计，支持快速启动和销毁，降低资源占用。

注意：本镜像为演示用途，未包含生产级安全加固和性能优化，禁止用于生产环境。

使用方法和配置说明

拉取镜像

假设镜像托管于 Docker EE 私有仓库或公共演示仓库，拉取命令示例：

bash
docker pull docker.io/example/db-container:latest

快速启动

通过 docker run 命令直接启动容器，使用默认配置（自动创建演示数据库并监听默认端口）：

bash
docker run -d --name demo-db -p 3306:3306 docker.io/example/db-container:latest

• -d：后台运行容器
• --name demo-db：指定容器名称为 demo-db
• -p 3306:3306：映射容器内数据库端口（3306）到主机端口

环境变量配置

通过环境变量自定义数据库参数，支持以下配置项（完整列表见 配置参数说明）：

自定义用户名/密码示例

bash
docker run -d \
  --name demo-db \
  -p 3306:3306 \
  -e DB_USER="demo_user" \
  -e DB_PASSWORD="SecureDemo123!" \
  -e DB_NAME="test_db" \
  docker.io/example/db-container:latest

docker-compose 部署

在 Docker Compose 中集成该数据库容器，示例配置（docker-compose.yml）：

yaml
version: '3.8'
services:
  demo-db:
    image: docker.io/example/db-container:latest
    container_name: demo-db
    ports:
      - "3306:3306"
    environment:
      - DB_USER=demo_user
      - DB_PASSWORD=SecureDemo123!
      - DB_NAME=test_db
      - LOG_LEVEL=debug  # 开启调试日志
    volumes:
      - demo-data:/var/lib/db  # 挂载持久化数据卷
    restart: unless-stopped  # 非手动停止时自动重启

volumes:
  demo-data:  # 定义命名数据卷，持久化数据库文件

启动命令：

bash
docker-compose up -d

持久化存储配置

为避免容器销毁时数据丢失，通过 -v 参数挂载主机目录或命名卷：

bash
# 挂载主机目录（绝对路径）
docker run -d \
  --name demo-db \
  -p 3306:3306 \
  -v /host/path/to/db/data:/var/lib/db \
  docker.io/example/db-container:latest

# 或使用命名卷（推荐 Docker 管理）
docker volume create demo-data
docker run -d \
  --name demo-db \
  -p 3306:3306 \
  -v demo-data:/var/lib/db \
  docker.io/example/db-container:latest

连接数据库

容器启动后，可通过主机 IP 和映射端口连接数据库（以 MySQL 客户端为例）：

bash
mysql -h 127.0.0.1 -P 3306 -u demo_user -pSecureDemo123! test_db

进入容器执行数据库操作：

bash
docker exec -it demo-db /bin/bash  # 进入容器终端
sqlite3 /var/lib/db/test_db.db  # 若为 SQLite，直接打开数据库文件

配置参数说明

环境变量

注意事项

1. 非生产环境使用：本镜像仅用于演示和测试，缺乏数据备份、高可用及安全加固（如密码策略、网络隔离），禁止部署到生产环境。
2. 密码安全：默认密码 password 仅用于演示，实际使用时必须通过 DB_PASSWORD 环境变量自定义强密码。
3. 持久化风险：若未配置持久化存储，容器销毁后数据将丢失，需根据场景选择是否挂载数据卷。
4. 资源限制：演示环境建议限制容器 CPU/内存资源（如 --cpus 0.5 -m 512m），避免占用过多主机资源。