与容器共享本地文件

目录

说明

每个容器都拥有其运行所需的一切，无需依赖主机上的任何预安装依赖项。由于容器在隔离环境中运行，它们对主机和其他容器的影响最小。这种隔离具有一个主要优点：容器最大程度地减少了与主机系统和其他容器的冲突。但是，这种隔离还意味着容器默认情况下无法直接访问主机上的数据。

假设您有一个 Web 应用程序容器，它需要访问存储在主机系统上的文件中的配置设置。此文件可能包含敏感数据，例如数据库凭据或 API 密钥。将此类敏感信息直接存储在容器镜像中会带来安全风险，尤其是在共享镜像时。为了解决此问题，Docker 提供了存储选项，可以弥合容器隔离与主机数据之间的差距。

Docker 提供了两种主要的存储选项，用于持久化数据并在主机与容器之间共享文件：卷和绑定挂载。

卷与绑定挂载

如果您希望确保即使在容器停止运行后，容器内部生成或修改的数据也能持久化，则可以选择卷。请参阅 持久化容器数据，详细了解卷及其用例。

如果您想直接与容器共享主机系统上的特定文件或目录，例如配置文件或开发代码，则可以使用绑定挂载。这就像在主机与容器之间打开一个直接通道，用于共享数据。绑定挂载非常适合开发环境，在这种环境中，实时文件访问和主机与容器之间的共享至关重要。

在主机和容器之间共享文件

docker run 命令使用的 -v（或 --volume）和 --mount 标志都可以让您在本地机器（主机）和 Docker 容器之间共享文件或目录。但是，它们的行为和用法有一些关键区别。

-v 标志更简单，更便于进行基本的卷或绑定挂载操作。如果使用 -v 或 --volume 时主机位置不存在，则会自动创建目录。

假设您是一名开发人员，正在开发一个项目。您的开发机器上有一个源目录，其中包含您的代码。当您编译或构建代码时，生成的工件（编译后的代码、可执行文件、镜像等）将保存到源目录内的另一个子目录中。在以下示例中，此子目录为 /HOST/PATH。现在，您希望这些构建工件能够在运行您的应用程序的 Docker 容器内访问。此外，您希望容器在您重建代码时自动访问最新的构建工件。

以下是如何使用 docker run 启动一个使用绑定挂载的容器，并将其映射到容器文件位置。

$ docker run -v /HOST/PATH:/CONTAINER/PATH -it nginx

--mount 标志提供了更高级的功能和更细粒度的控制，使其适用于复杂的挂载场景或生产部署。如果您使用 --mount 绑定挂载 Docker 主机上尚不存在的文件或目录，则 docker run 命令不会自动为您创建它，而是会生成错误。

$ docker run --mount type=bind,source=/HOST/PATH,target=/CONTAINER/PATH,readonly nginx

注意

Docker 建议使用 --mount 语法，而不是 -v。它提供了对挂载过程的更好控制，并避免了因缺少目录而可能出现的问题。

Docker 访问主机文件的权限

使用绑定挂载时，确保 Docker 拥有访问主机目录的必要权限至关重要。要授予读/写访问权限，您可以在创建容器时使用 :ro 标志（只读）或 :rw 标志（读写）与 -v 或 --mount 标志结合使用。例如，以下命令授予读写访问权限。

$ docker run -v HOST-DIRECTORY:/CONTAINER-DIRECTORY:rw nginx

只读绑定挂载允许容器读取主机上挂载的文件，但不能更改或删除这些文件。使用读写绑定挂载，容器可以修改或删除挂载的文件，这些更改或删除也会反映在主机系统上。只读绑定挂载可确保主机上的文件不会被容器意外修改或删除。

同步文件共享

随着代码库的增长，传统的共享文件方法，例如绑定挂载，可能会变得效率低下或速度变慢，尤其是在开发环境中，需要频繁访问文件。 同步文件共享 通过利用同步文件系统缓存来提高绑定挂载性能。这种优化可确保主机与虚拟机 (VM) 之间的文件访问快速高效。

试一试

在本动手指南中，您将练习如何创建和使用绑定挂载，以在主机和容器之间共享文件。

运行容器

  1. 下载并安装 Docker Desktop。

  2. 使用 httpd 镜像启动容器，使用以下命令

    $ docker run -d -p 8080:80 --name my_site httpd:2.4

    这将在后台启动 httpd 服务，并将网页发布到主机上的端口 8080。

  3. 打开浏览器并访问 https://127.0.0.1:8080 或使用 curl 命令验证它是否正常工作。

    $ curl localhost:8080

使用绑定挂载

使用绑定挂载，您可以将主机计算机上的配置文件映射到容器内的特定位置。在本示例中，您将了解如何使用绑定挂载更改网页的外观和风格

  1. 使用 Docker 仪表盘删除现有容器

    A screenshot of Docker dashboard showing how to delete the httpd container

  2. 在您的主机系统上创建一个名为 public_html 的新目录。

    $ mkdir public_html

  3. 更改到 public_html 目录，并创建一个名为 index.html 的文件，内容如下。这是一个基本的 HTML 文档，它创建一个简单的网页，用友好的鲸鱼向您问好。

    <!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title> My Website with a Whale & Docker!</title>
</head>
<body>
<h1>Whalecome!!</h1>
<p>Look! There's a friendly whale greeting you!</p>
<pre id="docker-art">
   ##         .
  ## ## ##        ==
 ## ## ## ## ##    ===
 /"""""""""""""""""\___/ ===
{                       /  ===-
\______ O           __/
\    \         __/
 \____\_______/

Hello from Docker!
</pre>
</body>
</html>

  4. 现在该运行容器了。--mount 和 -v 示例会产生相同的结果。您不能同时运行它们，除非您在运行第一个示例后删除 my_site 容器。

    $ docker run -d --name my_site -p 8080:80 -v .:/usr/local/apache2/htdocs/ httpd:2.4

    $ docker run -d --name my_site -p 8080:80 --mount type=bind,source=./,target=/usr/local/apache2/htdocs/ httpd:2.4

    提示
    在 Windows PowerShell 中使用 -v 或 --mount 标志时，您需要提供目录的绝对路径，而不仅仅是 ./。这是因为 PowerShell 处理相对路径的方式与 bash（通常用于 Mac 和 Linux 环境）不同。

    现在一切正常运行后，您应该能够通过 https://127.0.0.1:8080 访问该网站，并找到一个用友好的鲸鱼向您问好的新网页。

在 Docker 仪表盘访问文件

  1. 您可以通过选择容器的“文件”选项卡，然后选择 /usr/local/apache2/htdocs/ 目录中的文件来查看容器中的挂载文件。然后，选择“打开文件编辑器”。

    A screenshot of Docker dashboard showing the mounted files inside the a container

  2. 删除主机上的文件，并验证该文件是否也从容器中删除。您会发现该文件不再存在于 Docker 仪表盘的“容器”下的“文件”中。

    A screenshot of Docker dashboard showing the deleted files inside the a container

  3. 在主机系统上重新创建 HTML 文件，您会看到该文件重新出现在 Docker 仪表盘的“容器”下的“文件”选项卡中。现在，您也可以访问该网站。

停止您的容器

容器将一直运行，直到您停止它。

  1. 转到 Docker 仪表盘的“容器”视图。

  2. 找到您要停止的容器。

  3. 在“操作”列中选择“删除”操作。

A screenshot of Docker dashboard showing how to delete the container

其他资源

以下资源将帮助您详细了解绑定挂载

下一步

现在您已经了解了如何与容器共享本地文件，是时候学习多容器应用程序了。

多容器应用程序