2.5.6.1 使用 Docker 部署 MySQL 服务器的基本步骤

警告

MySQL 团队维护的 MySQL Docker 镜像是专门为 Linux 平台构建的. 不支持其他平台, 使用这些 MySQL Docker 镜像的用户自行承担风险. 有关在非 Linux 操作系统中运行这些容器的一些已知限制, 请参阅此处的讨论.

接受许可协议并使用Docker Client登录 (MySQL企业版)

使用 MySQL 企业版的 Docker 镜像需要订阅. 订阅的工作原理是携带你自己的许可证模型; 参阅 如何购买 MySQL 产品和服务 获取详情. 在下载 MySQL 企业版镜像之前, 你需要接受许可协议并登录到容器库.

从 Oracle 容器库下载:

  • 在 https://container-registry.oracle.com/ 浏览 Oracle 容器库并选择 MySQL.

  • 在 MySQL 库列表下, 选择 enterprise-server.

  • 如果你至今没有登录到 Oracle 容器库, 点击页面右侧的 Sign in 按钮, 然后在提示时输入你的 Oracle 账户凭证.

  • 按照页面右侧的说明接受许可协议.

  • 使用你的 Docker 客户端 (docker 命令) 登录 Oracle 容器源. 使用 docker login 命令:

  1. # docker login container-registry.oracle.com 
  2. Username: Oracle-Account-ID
  3. Password: password
  4. Login successful.

从 Docker 商店下载:

  • 在 https://store.docker.com/images/mysql-enterprise-server 浏览 MySQL 服务器企业版页面.

  • 如果你还没登录到 Docker 商店, 使用 Log in 链接和你的 Docker 证书进行登录.

  • 点击出现的 Proceed to Checkout 按钮.

  • 按照页面右侧的说明接受许可协议.

  • 使用 Docker 客户端 (docker 命令) 登录到 Docker 商店. 使用 docker login 命令:

  1. # docker login
  2. Username: Docker-ID
  3. Password: password
  4. Login successful.
下载 MySQL 服务器 Docker 镜像

严格来说, 在单独的步骤中下载服务器镜像不是必需的; 然而, 在创建容器之前执行此步骤可以确保本地镜像是最新的. 下载 MySQL 社区版镜像, 运行命令:

  1. docker pull mysql/mysql-server:tag

tag 是你想拉取的镜像版本的标签 (例如, 5.5, 5.6, 5.7, 8.0, 或者 latest). 如果 :tag 被省略, 将使用 latest 标签, 下载 MySQL 社区服务器的最新 GA 版本镜像. 在 Docker Hub 的 mysql/mysql-server 页面 参考可用版本的标签列表.

列出已下载的 Docker 镜像:

  1. shell> docker images
  2. REPOSITORY           TAG                 IMAGE ID            CREATED             SIZE
  3. mysql/mysql-server   latest              3157d7f55f8d        4 weeks ago         241MB

从 Docker 商店下载 MySQL 企业版镜像:

  1. docker pull  store/oracle/mysql-enterprise-server:tag

从 Oracle 容器源下载 MySQL 企业版镜像:

  1. docker pull  container-registry.oracle.com/mysql/enterprise-server:tag

tag 有不同的选择, 对应 MySQL 团队在 Oracle 提供的两个版本的 MySQL 企业版 Docker 镜像:

8.0, 8.0.x (x 是 8.0 系列的最新版本号): MySQL 8.0 企业版，最新的GA

5.7, 5.7.y (y 是 85.7 系列的最新版本号): MySQL 5.7 企业版

启动 MySQL 服务器实例

为 MySQL 社区版服务器启动一个新的 Docker 容器:

  1. docker run --name=mysql1 -d mysql/mysql-server:tag

使用此命令为 MySQL 企业版服务器启动一个新的 Docker 容器, 如果 Docker 镜像是从 Oracle 容器库中下载的:

  1. docker run --name=mysql1 -d container-registry.oracle.com/mysql/enterprise-server:tag

使用此命令为 MySQL 企业版服务器启动一个新的 Docker 容器, 如果 Docker 镜像是从 Docker 商店下载的:

  1. docker run --name=mysql1 -d store/oracle/mysql-enterprise-server:tag

--name 选项, 用于为服务器容器提供自定义命令 (在本示例中是 mysql1), 可选; 如果没有提供容器名称, 会随机生成一个. 如果指定名称和 tag 的镜像没有在以前通过 docker pull 或者 docker run 命令下载, 则现在讲下载该镜像. 下载完成后, 开始初始化容器, 当你运行 docker ps 命令时, 容器会出现在正在运行的容器列表中; 例如:

  1. shell> docker ps
  2. CONTAINER ID   IMAGE                COMMAND                  CREATED             STATUS                              PORTS                NAMES
  3. a24888f0d6f4   mysql/mysql-server   "/entrypoint.sh my..."   14 seconds ago      Up 13 seconds (health: starting)    3306/tcp, 33060/tcp  mysql1

容器初始化可能需要一些时间. 当服务器准备好使用时, 容器在状态在 docker ps 命令的输出中从 (health: starting) 到 (healthy).

在 docker run 命令中使用 -d 选项使容器在后台运行. 使用这个命令监视容器的输出:

  1. docker logs mysql1

初始化完成后, 命令输出包含为 root 用户生成的随机密码; 例如, 使用这个命令查询密码:

  1. shell> docker logs mysql1 2>&1 | grep GENERATED
  2. GENERATED ROOT PASSWORD: Axegh3kAJyDLaRuBemecis&EShOs
从容器内连接到 MySQL 服务器

一旦服务器准备好了, 你可以在你刚启动的 MySQL Server 容器中运行 mysql 客户端, 并连接到 MySQL Server. 使用 docker exec -it 命令在已运行的 Docker 容器内启动 mysql 客户端, 如下所示:

  1. docker exec -it mysql1 mysql -uroot -p

当询问时, 输入生成的 root 密码 (有关如何查找密码, 请参阅 启动 MySQL 服务器实例 的最后一步). 因为 MYSQL_ONETIME_PASSWORD 选项默认为 true, 当 mysql 客户端连接服务器之后, 你必须通过发出此语句重置服务器 root 密码:

  1. mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY 'password';

使用你选择的密码替换 password. 重置密码后, 服务器就可以使用了.

容器 Shell 访问

让 shell 访问 MySQL 服务器容器, 使用 docker exec -it 命令在容器内启动 bash shell:

  1. shell> docker exec -it mysql1 bash 
  2. bash-4.2#

然后可以在容器中运行 Linux 命令. 例如, 查看容器内服务器数据目录的内容, 使用此命令:

  1. bash-4.2# ls /var/lib/mysql
  2. auto.cnf    ca.pem         client-key.pem  ib_logfile0  ibdata1  mysql       mysql.sock.lock       private_key.pem  server-cert.pem  sys
  3. ca-key.pem  client-cert.pem  ib_buffer_pool  ib_logfile1  ibtmp1   mysql.sock  performance_schema  public_key.pem   server-key.pem
停止和删除 MySQL 容器

停止我们创建的 MySQL 服务器容器, 使用这个命令:

  1. docker stop mysql1

docker stop 发送 SIGTERM 信号到 mysqld 进程, 以便服务器正常关闭.

请注意, 当容器的主进程 (MySQL 服务器容器中的 mysqld) 停止时, Docker 容器也会自动停止.

再次启动 MySQL 服务器容器:

  1. docker start mysql1

重启 MySQL 服务器容器:

  1. docker restart mysql1

删除 MySQL 容器, 先停止, 然后使用 docker rm 命令:

  1. docker stop mysql1
  1. docker rm mysql1

如果你想同时删除 服务器数据目录的 Docker volume, 添加 -v 选项到 docker rm 命令.

升级 MySQL 服务器容器

重要

  • 在执行任何 MySQL 升级之前, 请仔细阅读 2.11节, “升级 MySQL” 中的说明. 在这里讨论的其他说明中, 在升级前备份你的数据尤为重要.
  • 本节要求在主机上保留服务器的数据和配置. 参阅 保留数据和配置更改 获取详情.

按照以下步骤 MySQL Docker 安装从 5.7 升级到 8.0:

  • 停止 MySQL 5.7 服务器 (在这个示例中容器名称是 mysql57):
  1. docker stop mysql57

  • 下载 MySQL 8.0 服务器 Docker 镜像. 请参阅下载 MySQL 服务器 Docker 镜像; 确保你对 MySQL 8.0 使用了正确的 tag.

  • 使用在这个主机上持久化的 (在本例中使用 bind-mounting) 旧的服务器数据和配置 (如有需要可适当修改—参阅 2.11节, “升级 MySQL”) 启动新的 MySQL 8.0 Docker 容器 (在这个示例中命名为 mysql80). MySQL 社区服务器, 运行命令:

  1. docker run --name=mysql80 \
  2.    --mount type=bind,src=/path-on-host-machine/my.cnf,dst=/etc/my.cnf \
  3.    --mount type=bind,src=/path-on-host-machine/datadir,dst=/var/lib/mysql \        
  4.    -d mysql/mysql-server:8.0

如果需要, 调整 mysql/mysql-server 为正确的库名称. 例如, 替换为 store/oracle/mysql-enterprise-server 是 Docker 商店的 MySQL 企业版镜像, 或者 container-registry.oracle.com/mysql/enterprise-server 是 Oracle 容器库的 MySQL 企业版镜像.

  • 等待服务器完成启动. 你可以使用 docker ps 命令检查服务器的状态 (参阅 启动 MySQL 服务器实例 获取如何操作).

  • 对于 MySQL 8.0.15 和更早的: 在 MySQL 8.0 服务器容器中运行 mysql_upgrade 工具 (不支持 MySQL 8.0.16 和更高版本):

  1. docker exec -it mysql80 mysql_upgrade -uroot -p

当提示时, 输入你的旧的 MySQL 5.7 服务器 root 密码.

  • 通过重启 MySQL 8.0 服务器容器完成升级:
  1. docker restart mysql80
使用 Docker 部署 MySQL 服务器的更多主题

有关使用Docker部署MySQL服务器的更多主题, 例如服务器配置, 持久化数据和配置, 服务器错误日志, 和容器环境变量, 参阅 2.5.6.2节, “使用 Docker 部署 MySQL 服务器的更多主题”.