Docker 优化的 MySQL 安装

Docker 镜像对于 MySQL 是优化的，以便在 Docker 容器中运行 MySQL 实例。与普通的非 Docker 安装相比，MySQL Docker 安装有以下区别：

配置 MySQL 服务器

当您启动 MySQL Docker 容器时，可以通过 docker run 命令将配置选项传递给服务器。例如：

docker run --name mysql1 -d container-registry.oracle.com/mysql/community-server:tag --character-set-server=utf8mb4 --collation-server=utf8mb4_col

该命令以 utf8mb4 作为默认字符集和 utf8mb4_col 作为数据库的默认排序规则启动 MySQL 服务器。

另一种配置 MySQL 服务器的方法是准备一个配置文件，并将其挂载到容器中的服务器配置文件位置。请参阅 持久化数据和配置更改 了解详细信息。

持久化数据和配置更改

Docker 容器原则上是短暂的，任何数据或配置都可能在容器被删除或损坏时丢失（请参阅 这里 的讨论）。 Docker 卷 提供了一种机制来持久化容器中的数据。在其初始化时，MySQL 服务器容器创建了一个 Docker 卷用于服务器数据目录。从容器的 docker inspect 命令的 JSON 输出中，可以找到关于数据目录卷的信息：

$> docker inspect mysql1
...
 "Mounts": [
            {
                "Type": "volume",
                "Name": "4f2d463cfc4bdd4baebcb098c97d7da3337195ed2c6572bc0b89f7e845d27652",
                "Source": "/var/lib/docker/volumes/4f2d463cfc4bdd4baebcb098c97d7da3337195ed2c6572bc0b89f7e845d27652/_data",
                "Destination": "/var/lib/mysql",
                "Driver": "local",
                "Mode": "",
                "RW": true,
                "Propagation": ""
            }
        ],
...

输出显示，宿主机上的源目录 /var/lib/docker/volumes/4f2d463cfc4bdd4baebcb098c97d7da3337195ed2c6572bc0b89f7e845d27652/_data，其中数据被持久化，已经挂载到容器中的 /var/lib/mysql 服务器数据目录中。

另一种持久化数据的方法是使用 bind-mount 主机目录时使用 --mount 选项创建容器。同样的技术也可以用于持久化服务器配置。以下命令创建了一个 MySQL 服务器容器，并将数据目录和服务器配置文件 bind-mount 到宿主机上：

docker run --name=mysql1 \
--mount type=bind,src=/path-on-host-machine/my.cnf,dst=/etc/my.cnf \
--mount type=bind,src=/path-on-host-machine/datadir,dst=/var/lib/mysql \
-d container-registry.oracle.com/mysql/community-server:tag

命令将 path-on-host-machine/my.cnf 挂载到 /etc/my.cnf（容器内的服务器配置文件），并将 path-on-host-machine/datadir 挂载到 /var/lib/mysql（容器内的数据目录）。以下条件必须满足以便 bind-mounting 生效：

运行附加初始化脚本

如果您有任何 .sh 或 .sql 脚本想要在数据库创建后立即运行，可以将它们放入主机目录，然后将目录挂载到容器内的 /docker-entrypoint-initdb.d/。例如：

docker run --name=mysql1 \
--mount type=bind,src=/path-on-host-machine/scripts/,dst=/docker-entrypoint-initdb.d/ \
-d container-registry.oracle.com/mysql/community-server:tag

从另一个 Docker 容器中的应用程序连接到 MySQL

通过设置 Docker 网络，您可以允许多个 Docker 容器相互通信，以便客户端应用程序在另一个 Docker 容器中可以访问 MySQL 服务器容器。首先，创建一个 Docker 网络：

docker network create my-custom-net

然后，在创建和启动服务器和客户端容器时，使用 --network 选项将它们放在您创建的网络上。例如：

docker run --name=mysql1 --network=my-custom-net -d container-registry.oracle.com/mysql/community-server

docker run --name=myapp1 --network=my-custom-net -d myapp

然后，myapp1 容器可以使用 mysql1 主机名连接到 mysql1 容器，反之亦然，因为 Docker 会自动设置容器名称的 DNS。在以下示例中，我们从 myapp1 容器内部运行 mysql 客户端以连接到 mysql1 容器：

docker exec -it myapp1 mysql --host=mysql1 --user=myuser --password

有关容器网络技术的其他信息，请参阅 Docker 文档中的 容器网络 部分。

服务器错误日志

当 MySQL 服务器首次启动时，如果满足以下任一条件，服务器错误日志将不会生成：

要使 MySQL 服务器生成错误日志，请使用 --log-error 选项配置服务器以生成错误日志在容器内的特定位置。要持久化错误日志，请按照 Persisting Data and Configuration Changes 中的说明将主机文件挂载到容器内的错误日志位置。但是，您必须确保 MySQL 服务器在容器内有写入访问权限。

使用 MySQL Enterprise Backup 与 Docker

MySQL Enterprise Backup 是 MySQL 服务器的商业许可备份实用程序，随 MySQL Enterprise Edition 一起提供。MySQL Enterprise Backup 包含在 Docker 安装的 MySQL Enterprise Edition 中。

在以下示例中，我们假设您已经在 Docker 容器中运行了 MySQL 服务器（参阅 Section 2.5.6.1, “基本步骤以部署 MySQL 服务器使用 Docker”）。要使 MySQL Enterprise Backup 备份 MySQL 服务器，必须访问服务器的数据目录。这可以通过例如 bind-mounting 主机目录到 MySQL 服务器的数据目录 来实现：

docker run --name=mysqlserver \
--mount type=bind,src=/path-on-host-machine/datadir/,dst=/var/lib/mysql \
-d mysql/enterprise-server:8.3

使用该命令，MySQL 服务器使用 MySQL 企业版的 Docker 镜像启动，并将主机目录 /path-on-host-machine/datadir/ 挂载到服务器的数据目录 (/var/lib/mysql) 内的容器中。我们还假设，在服务器启动后，已经为 MySQL 企业备份设置了所需的权限（见 授予 MySQL 权限给备份管理员，以获取详细信息）。使用以下步骤备份和恢复 MySQL 服务器实例。

要备份在 Docker 容器中运行的 MySQL 服务器实例，请按照以下步骤操作：

要恢复在 Docker 容器中运行的 MySQL 服务器实例，请按照以下步骤操作：

使用 mysqldump with Docker

除了使用 MySQL 企业备份来备份在 Docker 容器中运行的 MySQL 服务器外，还可以使用 mysqldump 实用程序，在 Docker 容器中运行，以执行逻辑备份。

以下说明假设您已经在 Docker 容器中运行了 MySQL 服务器，并且在容器首次启动时，已经将主机目录 /path-on-host-machine/datadir/ 挂载到服务器的数据目录 /var/lib/mysql（见 将主机目录绑定到 MySQL 服务器的数据目录 详细信息），其中包含 Unix 套接字文件，以便 mysqldump 和 mysql 连接到服务器。我们还假设，在服务器启动后，已经创建了一个具有适当权限的用户（在这个示例中为 admin），以便 mysqldump 访问服务器。使用以下步骤备份和恢复 MySQL 服务器数据：

使用 mysqldump 和 Docker 备份 MySQL 服务器数据：

使用 mysqldump 和 Docker 还原 MySQL 服务器数据：

已知问题

Docker 环境变量

当您创建 MySQL 服务器容器时，可以使用 --env 选项（短选项 -e）和指定一个或多个环境变量来配置 MySQL 实例。只有在挂载的数据目录为空时，服务器初始化才会执行，在这种情况下，设置这些变量没有效果（请参阅 持久化数据和配置更改），并且容器启动时不会修改目录的现有内容，包括服务器设置。

可以用于配置 MySQL 实例的环境变量列举如下：