Docker部署MySQL：从环境准备到生产实践

1. 为什么选择Docker部署MySQL在当今的开发和运维环境中Docker已经成为部署数据库服务的首选方案之一。我最初接触Docker部署MySQL是在2016年当时团队需要为多个微服务项目提供隔离的数据库实例。传统安装方式需要为每个项目单独配置虚拟机资源消耗大且管理复杂。而Docker容器化方案完美解决了这些问题。Docker部署MySQL的核心优势在于环境隔离和快速部署。每个容器相当于一个轻量级虚拟机但启动速度更快通常只需几秒资源占用更少共享主机内核。对于开发人员来说这意味着可以在本地机器上轻松运行多个不同版本的MySQL实例而不用担心版本冲突或配置污染。重要提示生产环境使用Docker部署MySQL时必须考虑数据持久化和性能优化问题这与开发环境配置有本质区别。2. 环境准备与Docker安装2.1 检查系统兼容性在开始之前需要确认你的系统满足Docker运行的基本要求Linux系统内核版本3.10或更高推荐Ubuntu 18.04/CentOS 7Windows系统Windows 10 Pro/Enterprise/Education版本家庭版需使用Docker ToolboxmacOS2010年后的机型macOS 10.13可以通过以下命令检查Linux内核版本uname -r2.2 安装Docker引擎不同操作系统的安装方式有所差异Ubuntu/Debian系统安装步骤# 卸载旧版本 sudo apt-get remove docker docker-engine docker.io containerd runc # 安装依赖 sudo apt-get update sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg \ lsb-release # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg # 设置稳定版仓库 echo \ deb [archamd64 signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 安装Docker引擎 sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io # 验证安装 sudo docker run hello-worldWindows/macOS用户 建议直接下载Docker Desktop安装包Windows: https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exemacOS: https://desktop.docker.com/mac/main/amd64/Docker.dmg安装完成后在终端运行docker version应能看到客户端和服务端版本信息。2.3 解决常见安装问题问题1虚拟化支持未启用Windows错误提示Docker Desktop failed to start because virtualization support wasnt detected解决方案重启电脑进入BIOS设置通常按F2/DEL键找到Intel VT-x或AMD-V选项并启用保存设置并重启问题2权限不足Linux错误提示Got permission denied while trying to connect to the Docker daemon socket解决方案sudo usermod -aG docker $USER newgrp docker3. MySQL容器部署实战3.1 拉取MySQL官方镜像Docker Hub提供了官方MySQL镜像建议使用指定版本而非latest标签docker pull mysql:8.0.28验证镜像下载docker images | grep mysql3.2 运行MySQL容器基础运行命令docker run --name some-mysql -e MYSQL_ROOT_PASSWORDmy-secret-pw -d mysql:tag生产环境推荐配置docker run -d \ --name mysql-prod \ -p 3306:3306 \ -v /path/to/mysql/data:/var/lib/mysql \ -v /path/to/mysql/conf:/etc/mysql/conf.d \ -e MYSQL_ROOT_PASSWORDcomplex_password_123 \ -e MYSQL_DATABASEapp_db \ -e MYSQL_USERapp_user \ -e MYSQL_PASSWORDuser_password \ --restart unless-stopped \ --memory2g \ --cpus2 \ mysql:8.0.28 \ --character-set-serverutf8mb4 \ --collation-serverutf8mb4_unicode_ci参数解析-v挂载数据卷实现持久化存储--restart设置容器自动重启策略--memory/--cpus限制资源使用末尾参数设置MySQL服务器字符集3.3 验证MySQL运行状态检查容器日志docker logs mysql-prod进入容器内部docker exec -it mysql-prod mysql -uroot -p连接测试SHOW DATABASES; SELECT VERSION();4. 高级配置与优化4.1 自定义MySQL配置在挂载的配置目录如/path/to/mysql/conf下创建custom.cnf[mysqld] max_connections200 innodb_buffer_pool_size1G query_cache_size64M slow_query_log1 long_query_time2重启容器使配置生效docker restart mysql-prod4.2 性能监控与调优使用docker stats实时监控docker stats mysql-prod安装MySQL监控工具docker run -d \ --name mysql-exporter \ --link mysql-prod \ -e DATA_SOURCE_NAMEroot:complex_password_123(mysql-prod:3306)/ \ prom/mysqld-exporter4.3 备份与恢复策略手动备份docker exec mysql-prod sh -c exec mysqldump --all-databases -uroot -p$MYSQL_ROOT_PASSWORD /backup/mysql/all-databases-$(date %Y%m%d).sql自动备份crontab示例0 3 * * * docker exec mysql-prod sh -c exec mysqldump --all-databases -uroot -pcomplex_password_123 /backup/mysql/all-databases-$(date \%Y\%m\%d).sql从备份恢复cat /backup/mysql/all-databases-20230601.sql | docker exec -i mysql-prod mysql -uroot -pcomplex_password_1235. 生产环境注意事项5.1 安全加固措施修改默认root密码创建专用应用用户并限制权限启用SSL连接docker run ... -v /path/to/certs:/etc/mysql/certs ... mysql:8.0.28 --ssl-ca/etc/mysql/certs/ca.pem --ssl-cert/etc/mysql/certs/server-cert.pem --ssl-key/etc/mysql/certs/server-key.pem定期更新镜像版本5.2 高可用方案主从复制配置主库docker run ... -e MYSQL_ROOT_PASSWORDmaster_pass --name mysql-master ... mysql:8.0.28 --server-id1 --log-binmysql-bin --binlog-formatROW从库docker run ... -e MYSQL_ROOT_PASSWORDslave_pass --name mysql-slave --link mysql-master ... mysql:8.0.28 --server-id2配置复制-- 在主库执行 CREATE USER repl% IDENTIFIED BY repl_pass; GRANT REPLICATION SLAVE ON *.* TO repl%; -- 在从库执行 CHANGE MASTER TO MASTER_HOSTmysql-master, MASTER_USERrepl, MASTER_PASSWORDrepl_pass, MASTER_LOG_FILEmysql-bin.000001, MASTER_LOG_POS154; START SLAVE;5.3 常见问题排查问题1容器启动后立即退出检查方法docker inspect mysql-prod | grep -A 10 ExitCode docker logs mysql-prod常见原因配置文件错误、数据目录权限问题问题2性能突然下降排查步骤检查系统资源docker stats mysql-prod查看慢查询docker exec mysql-prod mysql -uroot -p -e SHOW FULL PROCESSLIST;分析查询计划问题3连接数不足解决方案增加max_connections参数优化连接池配置检查是否有连接泄漏6. 开发环境实用技巧6.1 快速重置测试数据使用临时容器docker run --rm -it --link mysql-prod mysql:8.0.28 mysql -hmysql-prod -uroot -pcomplex_password_123 -e DROP DATABASE test_db; CREATE DATABASE test_db;6.2 使用Adminer替代phpMyAdmin轻量级管理工具部署docker run -d --link mysql-prod -p 8080:8080 --name adminer adminer6.3 集成到开发工作流docker-compose.yml示例version: 3.8 services: db: image: mysql:8.0.28 environment: MYSQL_ROOT_PASSWORD: root_pass MYSQL_DATABASE: app_dev MYSQL_USER: dev_user MYSQL_PASSWORD: dev_pass ports: - 3306:3306 volumes: - mysql_data:/var/lib/mysql - ./mysql/conf:/etc/mysql/conf.d healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] timeout: 5s retries: 5 app: build: . depends_on: db: condition: service_healthy environment: DB_HOST: db DB_USER: dev_user DB_PASS: dev_pass volumes: mysql_data:启动命令docker-compose up -d在实际项目开发中我发现合理配置Docker的缓存层可以显著提高构建速度。例如将不经常变更的依赖安装步骤放在Dockerfile的前面而将频繁修改的源代码放在后面。这样每次代码变更时Docker可以利用缓存跳过前面的步骤