作用

在容器和主机之间复制文件/文件夹

 

语法格式

docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH|-
docker cp [OPTIONS] SRC_PATH|- CONTAINER:DEST_PATH

 

重点

  • 容器 container 可以是正在运行或已停止的容器
  • SRC_PATH 或 DEST_PATH可以是文件或目录 
  • 该命令会假定容器路径相对于容器的 /（根）目录
  • 而主机路径则是相对于执行 docker cp 命令的当前目录

 

options 说明

option 作用
-a 存档模式（复制所有uid / gid信息）
-L  保持源目标中的链接

备注：暂时没发现这两个 options 有啥用

 

SRC_PATH 和 DEST_PATH 的讲解

SRC_PATH 指定一个文件

若 DEST_PATH 不存在

创建 DEST_PATH 所需的文件夹，文件正常保存到 DEST_PATH 中

 

若 DEST_PATH 不存在，并以 / 结尾

错误：目标目录必须存在

 

若 DEST_PATH 存在并且是一个文件

目标被源文件的内容覆盖

 

若 DEST_PATH 存在并且是目录

使用 SRC_PATH 中的基本名称将文件复制到此目录中

 

SRC_PATH指定目录

若 DEST_PATH 不存在

将 DEST_PATH 创建为目录，并将源目录的内容复制到该目录中

 

若 DEST_PATH存在并且是一个文件

错误：无法将目录复制到文件

 

若 DEST_PATH存在并且是目录

  • SRC_PATH 不以 /. 结尾，源目录复制到此目录
  • SRC_PATH 以 /. 结尾，源目录的内容被复制到该目录中

 

实际栗子

从容器复制文件到主机

已存在的目录

docker cp tomcat7:usr/local/tomcat/README.md ./

Docker（16）- docker cp 命令详解_Docker教程

 

不存在的目录

docker cp tomcat7:usr/local/tomcat/README.md test/

Docker（16）- docker cp 命令详解_Docker教程_02

 

已存在的文件

docker cp tomcat7:usr/local/tomcat/README.md test.txt

 

从主机复制文件到容器

docker cp test.txt tomcat7:/

Docker（16）- docker cp 命令详解_Docker教程_03

 

从主机复制目录到容器

目标目录不存在

docker cp test tomcat7:test/

Docker（16）- docker cp 命令详解_Docker教程_04

 

目标是一个文件

docker cp test tomcat7:polo

Docker（16）- docker cp 命令详解_Docker_05

 

目标目录已存在

docker cp test tomcat7:test/

Docker（16）- docker cp 命令详解_Docker_06

 

从容器复制目录到主机

docker cp tomcat7:/usr/local/tomcat/webapps.list /usr/local/