sudo mkdir -p /opt/data/ops/mysql
cd /opt/data/ops/mysql

# =============================================================================
# MySQL 8.4 (LTS) Docker Compose 部署文件
# 镜像版本：mysql:8.4（对应 MySQL 8.4.11，与《Ubuntu 22.04 安装 MySQL 8.0 指南》方案二一致）
# 使用方式：cd /opt/data/ops/mysql && docker compose up -d
# 密码等敏感值通过环境变量注入，请先 export（见文档"六、常用环境变量表"章节）
# =============================================================================

services:
  mysql:
    # 镜像版本：8.4 LTS 官方镜像（阿里云/daocloud 镜像源可加速拉取）
    image: mysql:8.4

    # 容器名称，方便 docker ps / docker logs 定位
    container_name: mysql-8-4

    # 重启策略：容器异常退出时自动重启（除非手动 stop）
    restart: unless-stopped

    # ---- 常用环境变量配置（值由外部环境变量注入）----
    environment:
      - TZ=Asia/Shanghai                      # 容器时区（与宿主机一致）
      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD:?请在环境变量中设置}  # root 密码（首次初始化生效）
      - MYSQL_DATABASE=${MYSQL_DATABASE:-app_db}   # 自动创建的默认数据库
      - MYSQL_USER=${MYSQL_USER:-app_user}         # 自动创建的业务用户
      - MYSQL_PASSWORD=${MYSQL_PASSWORD:?请在环境变量中设置}            # 业务用户密码
      - MYSQL_ROOT_HOST=${MYSQL_ROOT_HOST:-%}      # 允许 root 远程登录（% 表示任意主机）

    # ---- 常用配置参数（等价于写进 my.cnf）----
    # 说明：参数已统一放入 ./conf/my.cnf（见下方 volumes 挂载），
    # 修改配置只需编辑该文件后 docker compose restart mysql，无需改 yaml
    command:
      - --character-set-server=utf8mb4        # 默认字符集 UTF-8
      - --collation-server=utf8mb4_unicode_ci # 默认排序规则
      - --default-time-zone=+08:00            # 数据库时区（东八区）
      - --max-connections=200                 # 最大连接数

    # ---- 端口映射：宿主机13306 -> 容器3306 ----
    ports:
      - "13306:3306"

    # ---- 数据持久化（重要）----
    # ./data 为宿主机数据目录，重启容器数据不丢失
    volumes:
      - ./data:/var/lib/mysql
      # ---- 配置文件持久化（重要）----
      # ./conf 为宿主机配置目录，挂载到 /etc/mysql/conf.d 自动加载，
      # 编辑 ./conf/my.cnf 后 docker compose restart mysql 即可生效
      - ./conf:/etc/mysql/conf.d

    # ---- 健康检查：容器内 mysqladmin ping 判断数据库就绪 ----
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-uroot", "-p$$MYSQL_ROOT_PASSWORD"]
      interval: 10s      # 每 10 秒检查一次
      timeout: 5s        # 单次检查超时
      retries: 10        # 连续 10 次失败视为不健康
      start_period: 30s  # 启动后 30 秒才开始检查

    # 容器日志大小限制，防止磁盘被日志占满
    logging:
      driver: json-file
      options:
        max-size: "50m"
        max-file: "3"

# 注入密码（首次初始化生效，容器重建后需保持一致才能正常读取数据目录）
export MYSQL_ROOT_PASSWORD='your-root-password'
export MYSQL_PASSWORD='your-app-password'

docker compose up -d

# 查看容器状态（healthy 表示健康检查通过）
docker ps --filter name=mysql-8-4

# 连接测试
docker exec -it mysql-8-4 mysql -uroot -p

# 验证字符集与时区
mysql> SHOW VARIABLES LIKE 'character_set_server';
mysql> SHOW VARIABLES LIKE 'time_zone';

# 配置文件位于宿主机，可随时编辑
sudo vim /opt/data/ops/mysql/conf/my.cnf

# MySQL 自定义配置文件（挂载到 /etc/mysql/conf.d/my.cnf，自动加载）
# 修改后重启容器生效：docker compose restart mysql

[mysqld]
# 默认字符集 UTF-8 全量
character-set-server = utf8mb4
# 默认排序规则
collation-server = utf8mb4_unicode_ci
# 数据库会话时区（东八区）
default-time-zone = +08:00
# 最大连接数（默认 151）
max_connections = 200

# 更多常用参数示例（按需取消注释）：
# innodb_buffer_pool_size = 1G        # InnoDB 缓冲池（建议为物理内存的 60%~70%）
# max_allowed_packet = 64M            # 最大单包大小（大字段/大结果集场景）
# slow_query_log = 1                  # 开启慢查询日志
# long_query_time = 2                 # 慢查询阈值（秒）

# 先注入环境变量
export MYSQL_ROOT_PASSWORD='your-root-password'
export MYSQL_PASSWORD='your-app-password'

docker run -d \
  --name mysql-8-4 \
  --restart unless-stopped \
  -e TZ=Asia/Shanghai \
  -e MYSQL_ROOT_PASSWORD="$MYSQL_ROOT_PASSWORD" \
  -e MYSQL_DATABASE=app_db \
  -e MYSQL_USER=app_user \
  -e MYSQL_PASSWORD="$MYSQL_PASSWORD" \
  -e MYSQL_ROOT_HOST='%' \
  -p 13306:3306 \
  -v /opt/data/ops/mysql/data:/var/lib/mysql \
  -v /opt/data/ops/mysql/conf:/etc/mysql/conf.d \
  --health-cmd='mysqladmin ping -h 127.0.0.1 -uroot -p"$MYSQL_ROOT_PASSWORD"' \
  --health-interval=10s \
  --health-timeout=5s \
  --health-retries=10 \
  --health-start-period=30s \
  mysql:8.4 \
  --character-set-server=utf8mb4 \
  --collation-server=utf8mb4_unicode_ci \
  --default-time-zone=+08:00 \
  --max-connections=200

# 查看日志
docker logs -f mysql-8-4

# 重启容器（数据保留）
docker compose restart

# 停止并移除容器（保留数据）
docker compose down

# 彻底移除容器 + 数据目录（谨慎操作！）
docker compose down -v

CREATE DATABASE app_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;