在 Docker 容器中为您的项目使用 MySQL

发布于2024-08-18

Using MySQL in a Docker Container for your Projects

我坚信保持主机系统清洁。 Docker 容器是解决这个问题的完美解决方案。假设您正在开发一个带有 Node / Express 后端和 MySQL 服务器的 React 应用程序来满足您的数据库需求。通常，您将在主机系统中安装 mysql、创建数据库、创建具有密码的用户并授予用户使用该数据库的权限。

我不再浪费时间为每个项目进行每次配置，而是使用 Docker 映像来创建我的 MySQL 数据库服务器，只需几秒钟即可准备好、启动并运行，并完成所有必要的设置曾经需要。

相信我，一旦您使用这条路线弄清楚了您的工作流程，您将永远不会回到旧的方式。所以，这就是我的做法，一种非常简单、基本的方式。

如果您有一些 Docker 经验并希望跳过本教程并直接使用 TLDR 版本，那么这个 Gist 会更快。

我们需要什么？

要使用 Docker，我们需要 Docker，呃！这里不再赘述安装Docker的细节。如果您不习惯 CLI 或者您使用的是 Windows/MacOS，请使用 Docker Desktop，它将在幕后为您完成所有繁重的工作。

如果您不喜欢，Linux 用户也可以使用 Docker Compose 插件或 Docker Desktop 安装 Docker Engine。

您通常不需要 Docker Hub 上的帐户来下载公共镜像，例如我们将使用的 MySQL 官方镜像。

好吧，现在怎么办？

有两种方法可以做到这一点。

使用 Docker Run（不推荐）

为了能够使用 docker run 命令直接运行容器，您必须首先在系统上下载 MySQL 映像。要将映像拉取到您的系统，只需使用以下命令：

docker pull mysql

注意：如果您不需要特定版本的MySQL，那么此命令将下载最新版本（带有最新标签的版本）。如果需要，您可以从 Docker Hub 探索更多标签和版本。

Docker 下载完成后，您可以看到下载的镜像，如下所示：

docker image ls

现在，要运行容器，您必须使用 docker run 命令添加许多标志。您可以访问此链接来检查您拥有的所有选项。您还需要记住需要添加的所有标志，因为缺少一些标志可能会引发错误或启动无法运行的容器。

此外，每次您希望运行容器时，您要么必须从终端历史记录中找出这个长命令，要么再次输入它。这样做毫无意义。

这就是我不推荐这种方法的原因。有更好的方法。

Docker 组合

我们将创建一个 Docker Compose 文件，该文件将告诉 Docker 我们在启动容器时需要什么。一旦所有内容都布置在文件中，启动容器就变得轻而易举。

注意：您可以使用任何名称创建撰写文件。如果您使用自己的名称或将撰写文件存储在其他文件夹中，则必须提供标志 -f 才能使其工作。或者，如果您从文件所在的同一文件夹运行命令，则可以将文件命名为 docker-compose.yaml。

Docker Compose 文件是一个 YAML 文件。我们的看起来像这样：

# This Docker Compose YAML deploys a MySQL database
services:
  container-name:

    image: mysql # Official MySQL image from Docker Hub
    restart: always

    environment:
      # Note - Root password is mandatory for the container to run and grant privileges to our User.
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}

      MYSQL_DATABASE: ${MYSQL_DATABASE} # Same name as used in your project

      # DB User Details
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}

    ports:
      # Adjust this port as per your needs -> :
      - 3308:3306 # DB is available at localhost:3308 on the host.

    volumes:
      - ./volumes/db-mnt:/var/lib/mysql

这个文件也可以在开头提到的要点上找到。

重要信息

端口映射：第一个端口是主机端口（您的系统），映射到第二个端口（docker 容器内的端口）。这意味着，在上面的示例中，您可以访问 localhost:3308 处的数据库。除非你知道自己在做什么，否则请将第二个端口保留为 3306。这是 MySQL 的默认端口。
卷绑定挂载：我们将本地卷挂载到容器以将数据保存在数据库中。这使得在需要时可以轻松备份和移动。您还可以让 Docker 管理它自己的卷并在主机系统上创建定期备份。 #### 环境文件为了在创建容器时向 Docker 提供必要的凭据，我们将创建一个 .env 文件，就像我们在 React 或后端应用程序中所做的那样。

您可以在您的 compose 文件所在的同一文件夹中创建此文件，也可以在您喜欢的任何位置创建它，但需要在调用 docker-compose 时提供路径。

# Content of the Environment Variables file
MYSQL_ROOT_PASSWORD=rootpassword
MYSQL_DATABASE=nameofdatabase
MYSQL_USER=dbusername
MYSQL_PASSWORD=dbuserpassword

一旦我们完成了所有这些，我们只需使用一个小命令，我们的数据库就会启动并准备好等待我们。