nickb937/mysql8

MySQL 8 Docker镜像（支持initContainer初始化）

镜像概述

本镜像基于官方MySQL 8镜像构建，核心特性是允许通过initContainer执行entrypoint.sh init命令，实现数据库初始化流程与主容器启动的解耦，适用于需要在主服务启动前完成数据库预配置的场景。

核心功能与特性

• 基于MySQL 8：完整继承官方MySQL 8镜像的全部功能，包括数据库服务、用户管理、数据持久化等
• initContainer支持：允许在initContainer中执行entrypoint.sh init命令，独立完成数据库初始化（如创建库表、导入初始数据等）
• 环境变量兼容：支持官方MySQL镜像的标准环境变量配置（如MYSQL_ROOT_PASSWORD、MYSQL_DATABASE等）
• 初始化脚本支持：可通过挂载初始化脚本目录，自动执行.sql、.sql.gz或.sh格式的初始化文件

使用场景

• Kubernetes环境：在K8s部署中，通过initContainer先行执行数据库初始化，确保主容器启动时数据库已就绪
• CI/CD流水线：自动化部署流程中，通过初始化脚本快速构建标准化数据库环境
• 多环境一致性：在开发、测试、生产环境中通过统一初始化流程保证数据库配置一致性

使用方法与配置说明

基础环境变量配置

Docker Compose配置示例（含initContainer）

yaml
version: '3.8'

services:
  # 初始化容器：执行数据库初始化操作
  mysql-init:
    image: [镜像名称]
    command: ["entrypoint.sh", "init"]
    environment:
      MYSQL_ROOT_PASSWORD: "rootpassword"
      MYSQL_DATABASE: "mydb"
    volumes:
      - ./init-scripts:/docker-entrypoint-initdb.d  # 挂载初始化脚本目录
      - mysql-data:/var/lib/mysql  # 共享数据卷，确保初始化结果被主容器使用

  # 主MySQL服务容器
  mysql:
    image: [镜像名称]
    depends_on:
      mysql-init:
        condition: service_completed_successfully
    environment:
      MYSQL_ROOT_PASSWORD: "rootpassword"
      MYSQL_DATABASE: "mydb"
    volumes:
      - mysql-data:/var/lib/mysql
    ports:
      - "3306:3306"

volumes:
  mysql-data:

entrypoint.sh init命令说明

该命令是本镜像的核心扩展功能，执行时会：

1. 检查数据库存储目录是否已初始化
2. 若未初始化，执行/docker-entrypoint-initdb.d目录下的所有初始化脚本（按文件名排序）
3. 完成后退出，不启动MySQL服务，仅保留初始化后的数据文件

初始化脚本规范

• 放置在/docker-entrypoint-initdb.d目录下的.sql、.sql.gz文件会被自动执行
• .sh脚本文件需具有可执行权限，将按顺序执行
• 脚本执行顺序按文件名字典序排列，建议命名时添加序号（如01-create-tables.sql、02-insert-data.sql）

注意事项

1. 确保initContainer与主容器使用同一数据卷，否则初始化结果无法被主容器识别
2. entrypoint.sh init仅在数据库未初始化时执行，已初始化的数据库不会重复执行
3. 生产环境中建议通过环境变量或密钥管理工具传递敏感信息（如MYSQL_ROOT_PASSWORD）