针对 Docker 优化的 MySQL 安装

MySQL 的 Docker 镜像针对代码大小进行了优化，这意味着它们仅包含对在 Docker 容器中运行 MySQL 实例的大多数用户而言可能相关的关键组件。MySQL Docker 安装在以下方面与常见的非 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 卷提供了一种机制来持久化 Docker 容器内创建的数据。在其初始化时，MySQL 服务器容器会为服务器数据目录创建一个 Docker 卷。容器上 docker inspect 命令的 JSON 输出包含一个 Mount 键，其值提供有关数据目录卷的信息

$> 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（容器内的服务器数据目录）。

另一种保留数据的方法是在创建容器时使用 --mount 选项绑定挂载主机目录。可以使用相同的技术来持久化服务器的配置。以下命令创建一个 MySQL 服务器容器，并绑定挂载数据目录和服务器配置文件

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（容器内的数据目录）。要使绑定挂载正常工作，必须满足以下条件

运行其他初始化脚本

如果在创建数据库后要立即在数据库上运行任何 .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 文档中的Docker 容器网络部分。

服务器错误日志

当 MySQL 服务器首次使用您的服务器容器启动时，如果满足以下任一条件，则不会生成服务器错误日志

要在满足上述两个条件中的任何一个时使 MySQL 服务器生成错误日志，请使用 --log-error 选项配置服务器以在容器内的特定位置生成错误日志。要持久化错误日志，请在容器内的错误日志位置挂载主机文件，如持久化数据和配置更改中所述。但是，您必须确保容器内的 MySQL 服务器对挂载的主机文件具有写入权限。

在 Docker 中使用 MySQL Enterprise Backup

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

在以下示例中，我们假设您已经在 Docker 容器中运行了 MySQL 服务器（有关如何使用 Docker 启动 MySQL 服务器实例，请参阅第 2.5.6.1 节“使用 Docker 部署 MySQL 服务器的基本步骤”）。为了让 MySQL Enterprise Backup 备份 MySQL 服务器，它必须能够访问服务器的数据目录。例如，可以在启动服务器时将主机目录绑定挂载到 MySQL 服务器的数据目录上来实现这一点

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

使用此命令，MySQL 服务器将使用 MySQL Enterprise Edition 的 Docker 镜像启动，并且主机目录 /path-on-host-machine/datadir/ 已挂载到服务器容器内服务器的数据目录（/var/lib/mysql）上。我们还假设，在服务器启动后，还为 MySQL Enterprise Backup 设置了访问服务器所需的权限（有关详细信息，请参阅向备份管理员授予 MySQL 权限）。请按照以下步骤备份和还原 MySQL 服务器实例。

要使用 Docker 中的 MySQL Enterprise Backup 备份在 Docker 容器中运行的 MySQL 服务器实例，请按照此处列出的步骤操作

要使用 Docker 中的 MySQL Enterprise Backup 还原 Docker 容器中的 MySQL 服务器实例，请按照此处列出的步骤操作

在 Docker 中使用 mysqldump

除了使用 MySQL Enterprise Backup 备份在 Docker 容器中运行的 MySQL 服务器之外，您还可以通过使用在 Docker 容器内运行的 mysqldump 实用程序来执行服务器的逻辑备份。

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

使用 Docker 中的 mysqldump 备份 MySQL 服务器数据:

使用 Docker 中的 mysqldump 还原 MySQL 服务器数据:

已知问题

Docker 环境变量

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

此处列出了可用于配置 MySQL 实例的环境变量