如何使用 docker container cp 命令复制文件

简介

在本实验中，你将学习如何高效使用 docker container cp 命令在本地文件系统与 Docker 容器之间复制文件。通过动手实践，你将掌握以下核心场景：将文件从本地机器复制到运行中的容器、从容器中提取文件到本地系统，以及利用流式传输能力通过 STDOUT 和 STDIN 传输数据。

通过实际案例，你将熟练管理容器化应用的数据流。学习如何复制单个文件、目录，甚至进行数据流传输，为各种开发和部署任务提供所需的灵活性。

Skills Graph

将本地文件复制到容器中

在本步骤中，你将学习如何将文件从本地文件系统复制到正在运行的 Docker 容器中。这是当你需要在容器启动后添加配置文件、脚本或其他数据时的常见操作。

首先，让我们在本地机器的 ~/project 目录下创建一个简单的文本文件。

echo "This is a test file." > ~/project/test_file.txt

该命令会在你的 ~/project 目录下创建名为 test_file.txt 的文件，并写入文本 "This is a test file."。

接下来，我们需要一个正在运行的容器来接收文件。为此我们将使用简单的 ubuntu 镜像。由于本地可能没有该镜像，我们需要先拉取它。

docker pull ubuntu:latest

该命令会从 Docker Hub 下载最新版的 ubuntu 镜像。

现在，让我们基于 ubuntu 镜像运行一个容器。我们将以分离模式 (-d) 运行它，并为其命名 (my_ubuntu_container) 以便识别。

docker run -d --name my_ubuntu_container ubuntu:latest sleep infinity

该命令使用 ubuntu:latest 镜像启动一个名为 my_ubuntu_container 的新容器。sleep infinity 命令会让容器无限期运行，这对演示很有帮助。

你可以使用 docker ps 命令验证容器是否正在运行。

docker ps

你应该能在输出中看到 my_ubuntu_container。

现在，我们可以使用 docker cp 命令将 test_file.txt 从本地机器复制到正在运行的容器中。语法是 docker cp <本地路径> <容器名称>:<容器路径>。

docker cp ~/project/test_file.txt my_ubuntu_container:/tmp/

该命令将文件 ~/project/test_file.txt 复制到 my_ubuntu_container 容器的 /tmp/ 目录中。

要验证文件是否成功复制，你可以使用 docker exec 在容器内执行命令。我们将使用 ls 列出容器 /tmp/ 目录中的文件。

docker exec my_ubuntu_container ls /tmp/

你应该能在输出中看到 test_file.txt，确认文件已成功复制。

最后，让我们清理创建的容器。

docker stop my_ubuntu_container
docker rm my_ubuntu_container

这些命令分别用于停止和移除容器。

从容器复制文件到本地文件系统

在本步骤中，你将学习如何从正在运行的 Docker 容器中复制文件到本地文件系统。这对于获取日志、配置文件或容器内生成/修改的其他数据非常有用。

首先，确保我们有一个正在运行的容器可供操作。我们将使用上一步中的 my_ubuntu_container。如果它没有运行，请先启动它。

docker start my_ubuntu_container

该命令会启动名为 my_ubuntu_container 的容器。

现在，让我们在容器内创建一个文件，稍后将其复制到本地机器。我们将使用 docker exec 在容器内执行命令，在 /root/ 目录下创建名为 container_file.txt 的文件。

docker exec my_ubuntu_container sh -c 'echo "This file is from the container." > /root/container_file.txt'

该命令在 my_ubuntu_container 容器内执行 shell 命令，创建包含指定内容的 /root/container_file.txt 文件。

要验证文件是否已在容器内创建，可以使用 docker exec 列出容器 /root/ 目录下的文件。

docker exec my_ubuntu_container ls /root/

你应该能在输出中看到 container_file.txt。

现在，我们可以使用 docker cp 命令将 container_file.txt 从容器复制到本地机器。从容器复制到本地的语法是 docker cp <容器名称>:<容器路径> <本地路径>。我们将把它复制到你的 ~/project 目录。

docker cp my_ubuntu_container:/root/container_file.txt ~/project/

该命令将 my_ubuntu_container 容器中的 /root/container_file.txt 文件复制到本地的 ~/project/ 目录。

要验证文件是否成功复制到本地机器，请列出 ~/project 目录中的文件。

ls ~/project/

你应该能在输出中看到 container_file.txt，以及上一步中的 test_file.txt。

你还可以使用 cat 命令查看复制文件的内容。

cat ~/project/container_file.txt

输出应为 "This file is from the container."，确认内容已正确复制。

最后，让我们清理容器。

docker stop my_ubuntu_container
docker rm my_ubuntu_container

将容器中的文件内容流式输出到 STDOUT

在本步骤中，你将学习如何将运行中的 Docker 容器内的文件内容直接流式输出到本地机器的标准输出（STDOUT）。这种方法可以快速查看容器内文件内容，而无需显式复制文件。

首先，确保 my_ubuntu_container 容器正在运行。如果未运行，请启动它。

docker start my_ubuntu_container

现在，我们将在容器内创建另一个文件用于流式输出。我们将在容器的 /var/log/ 目录下创建名为 stream_test.log 的文件。

docker exec my_ubuntu_container sh -c 'echo "This is a log entry." > /var/log/stream_test.log'

该命令在 my_ubuntu_container 容器内执行 shell 命令，创建包含指定内容的 /var/log/stream_test.log 文件。

要将该文件内容流式输出到本地 STDOUT，可以使用 docker exec 命令配合容器内的 cat 命令。

docker exec my_ubuntu_container cat /var/log/stream_test.log

该命令在 my_ubuntu_container 容器内执行 cat /var/log/stream_test.log 命令。容器内该命令的输出会直接流式传输到你本地终端的 STDOUT。

你应该会看到内容 "This is a log entry." 直接打印到你的终端。这演示了如何快速查看容器内文件内容，而无需复制整个文件。

最后，让我们清理容器。

docker stop my_ubuntu_container
docker rm my_ubuntu_container

通过 STDIN 将本地 tar 归档流式传输到容器

在本步骤中，你将学习如何通过标准输入（STDIN）将本地 tar 归档直接流式传输到运行中的 Docker 容器。这是一种高效的方法，可以在不创建本地中间文件的情况下，将多个文件或目录传输到容器中。

首先，我们在本地 ~/project 目录下创建一些文件和目录用于归档和传输。

mkdir ~/project/my_files
echo "File 1 content." > ~/project/my_files/file1.txt
echo "File 2 content." > ~/project/my_files/file2.txt

这会创建一个 my_files 目录和其中的两个文本文件。

现在，确保 my_ubuntu_container 容器正在运行。如果未运行，请启动它。

docker start my_ubuntu_container

要将 tar 归档流式传输到容器，我们将使用 tar 命令创建 my_files 目录的归档，并通过管道（|）将其输出传递给 docker exec 命令。在容器内部，我们将再次使用 tar 命令来解压归档。

我们将把归档流式传输到容器内的 /opt/ 目录。

tar -cvf - ~/project/my_files | docker exec -i my_ubuntu_container tar -xvf - -C /opt/

让我们分解这个命令：

• tar -cvf - ~/project/my_files：该命令创建 ~/project/my_files 目录的 tar 归档（-c），并显示详细信息（-v）。-f - 选项指示 tar 将归档写入标准输出。
• |：将 tar 命令的标准输出（tar 归档）通过管道传递给下一个命令的标准输入。
• docker exec -i my_ubuntu_container tar -xvf - -C /opt/：在 my_ubuntu_container 容器内执行 tar 命令。-i 标志非常重要，它保持 STDIN 开放以接收管道数据。tar -xvf - 命令从标准输入（-f -）解压（-x）并显示详细信息（-v）。-C /opt/ 选项在解压前将目录切换到 /opt/，因此归档内容将被解压到容器内的 /opt/my_files 目录。

要验证文件是否成功流式传输并在容器内解压，可以使用 docker exec 列出容器内 /opt/my_files/ 目录的内容。

docker exec my_ubuntu_container ls /opt/my_files/

你应该能在输出中看到 file1.txt 和 file2.txt，确认 tar 归档已正确流式传输并解压。

最后，让我们清理容器和本地文件。

docker stop my_ubuntu_container
docker rm my_ubuntu_container
rm -rf ~/project/my_files

总结

在本实验中，你学习了如何使用 docker container cp 命令在本地文件系统和运行中的 Docker 容器之间复制文件。你练习了将本地文件复制到容器中，演示了如何在容器启动后添加必要的数据或配置。这包括创建本地文件、拉取并运行一个简单的 Ubuntu 容器，然后使用 docker cp 将文件传输到容器的 /tmp 目录。