月份：2017年1月

docker cp命令复制SRC_PATH的内容到DEST_PATH。可以从容器文件系统复制文件到本地机器或是反过来，从本地文件系统复制文件到容器。如果SRC_PATH或DEST_PATH指定了破折号-，可以从STDIN读取tar归档文件或输出到STDOUT。容器可以是运行或停止状态。SRC_PATH或DEST_PATH可以是文件或目录。

docker cp命令假设容器paths是相对于容器的根目录的。这意味着初始的左斜杠是可选的；compassionate_darwin:/tmp/foo/myfile.txt和compassionate_darwin:tmp/foo/myfile.txt是一样的。本地机器paths可以是一个绝对的或相对的值。这个命令解析本地机器的相对路径为相对于docker cp运行的当前目录。

cp命令行为像Unix cp -a命令，递归复制目录及其权限。文件的所有者设置为目标的用户和主用户组。例如，复制到容器的文件以root用户UID:GID创建。复制到本地机器的文件以调用docker cp命令的用户的UID:GID创建。如果指定-L选项，docker cp则跟随在SRC_PATH的软链接。docker cp不会创建DEST_PATH父级目录。

假设路径分隔符为/，第一个参数为SRC_PATH,第二个为DEST_PATH，它们的行为如下：

• SRC_PATH指定的是一个文件
  • DEST_PATH不存在
    • 文件保存到DEST_PATH文件
  • DEST_PATH不存在且以/结尾
    • Error condition: the destination directory must exist.
  • DEST_PATH存在且是一个文件
    • 源文件将覆盖目标文件
  • DEST_PATH存在且是一个目录
    • 文件使用原来文件名复制到这个目录
      SRC_PATH
• SRC_PATH指定的是一个目录
  • DEST_PATH不存在
    • 先创建DEST_PATH这个目录，然后源目录的内容复制到这个目录
  • DEST_PATH存在且是一个文件
    • Error condition: cannot copy a directory to a file
  • DEST_PATH存在且是一个目录
    • SRC_PATH不以/结尾
      • 源目录复制到这个目录
    • SRC_PATH以/结尾
      • 源目录的内容将复制到此目录

根据以上规则，命令要求SRC_PATH和DEST_PATH都存在。如果SRC_PATH是本地的软链接，默认下只复制软链接，不复制它指向的文件。要跟随这个软链接，指定-L选项。:冒号用来分隔CONTAINER和它的路径。

docker attach命令可以通过使用容器的ID或名称来附着到一个运行中的容器，来查看它的输出或以交互方式控制它。可以同时多次附着同一个容器进程，屏幕共享风格或快速查看进程的进度。

要停止一个容器，使用CTRL-c。此键序列向容器发送SIGKILL信号。如果–sig-proxy为true(默认)，CTRL-c发送SIGINT到容器。可以使用CTRL-p CTRL-q键序列与容器分离。
当附着到一个启用tty的容器时，将禁止重定向docker attach命令的标准输入。

当客户諯使用docker attach连接到容器的stdio时，docker使用大约1MB的内存缓冲来最大化应用的吞吐量。如果填充了缓冲，API连接的速度将开始影响进程输出的写入速度，因为如果API连接速度慢时，缓冲区无法及时释放，导致进程等待缓冲区。这里其它应用如SSH类似。所以，不推荐使用attach命令来查看那些运行在前台，产生大量输出进程的日志。而是用户应该使用docker logs命令来查看这些日志。

示例

在第二个示例中，可以看到bash进程返回的退出代码由docker attach命令返回给其调用者：

一个镜像名称由以斜杠分隔的名称组件组成，及可选的主机名前缀。主机名必须符合标准的DNS规则，不过不能包含下划线。如果名称存在主机名，可以在其后面加一个端口号，格式为:8080。没有不存在主机名，命令就使用默认的docker公共registry registry-1.docker.io。名称组件可以包含小写字符，数字和分隔符。分隔符可以是句点，一个或两个下划线或一个或多个破折号。
一个名称组件不能以分隔符开始或结束。
tag名称可以包含小写字符和大写字符，数字，下划线，名点和破折号。tag名称不能以名点或破折号开头，且最大支持128个字符。

示例

通过ID tag镜像

下面是tag一个id为0e5574283393的本地镜像到“fedora”存储库，tag名称version1.0:

通过名称tag镜像

使用名称“httpd” tag本地镜像到存储库”fedora”，且其tag名为version1.0

注意由于引用httpd的tag名称没有指定，默认引用httpd:latest。

通过名称和tag名称tag一个镜像

为名称为httpd和tag名称为test的本地镜像做标签，其存储库为fedora，标签名为version1.0.test。

tag一个镜像到私有的存储库

要推送一个镜像到一个私有的registry，而不是公共的docker registry，必须指定一个registry主机名和端口来tag此镜像。

可以使用镜像的短和长ID，它的digest来删除它。如果一个镜像有一个或多个tag引用它，在删除这个镜像之前必须先删除它们。当通过tag删除镜像时，它的digest的引用会自动删除。

如果使用-f参数和指定镜像的短或长ID，那么这个命令将untag和删除所有匹配指定ID的镜像。

通过digest拉取的镜像没有与之关联的tag:

通过它的digest删除一个镜像：

docker load用来导入由docker save备份的镜像。

输出镜像tar数据流到标准输出。包含了所有父级数据层和所有tag+version或特定的repo:tag。
一般用来备份镜像，然后使用docker load恢复。

甚至可以转存特定镜像的tag到另一个tag:

可以指定一个URL或-[破折号]直接从STDIN获取数据。URL可以是指向包含文件系统的归档文件 (.tar, .tar.gz, .tgz, .bzip, .tar.xz, 或 .txz) ，或者是docker主机的一个单独的文件。如果指定的是归档文件，docker将解压到容器的根目录下。如果指定的是一个单独文件，必须是主机上的绝对路径。要从远程路径导入，指定以http://或https://协议开头的URL。
–change选项将应用Dockerfile指令到要创建的镜像。支持的Dockerfile指令有：CMD|ENTRYPOINT|ENV|EXPOSE|ONBUILD|USER|VOLUME|WORKDIR。

示例

从远程路径导入

下面创建一个无tag的新镜像。

从本地文件导入

通过管道和STDIN导入:

带提交信息导入：

从本地归档文件导入：

从本地目录导入

使用新配置从本地目录导入

默认下docker images显示所有顶层的镜像，它们的仓库,tag和它们的大小。
docker镜像有中间数据层来提高可重用性，减小硬盘占用和通过允许每一个步骤缓存来加速docker build。这些中间层默认不显示。
SIZE列显示的是该镜像和其所有父镜像累积的空间大小。这也是在Docker save镜像时创建的Tar文件的内容使用的磁盘空间。
如果一个镜像有多个存储库名称或tag，将会列出多次。

列出最近创建的镜像

基于名称和tag列出镜像

docker images命令接受一个可选的[REPOSITORY[:TAG]]参数来限制列出匹配参数的镜像。如果只指定存储库名称没有指定tag，docker images命令列出匹配的存储库名称的所有镜像。
例如，列出所有”java”镜像，命令如下：

[REPOSITORY[:TAG]]值必须是完全匹配的。例如,docker images jav不会匹配镜像java。
如果REPOSITORY和TAG都提供了，只列出出匹配repository和tag的镜像。例如:

如果没有匹配REPOSITORY[:TAG]，列表为空：

列出完整的镜像ID

列出镜像digests

使用v2或之后格式的镜像有一个称为digest的内容可寻址标识符。只要用来生成镜像的输入没有更改，这个digest值是可预测的。要列出镜像的digest值，使用–digests参数：

过滤

过滤标志-f or –filter格式为key=value。如果超过一个过滤，那么就传递多个标志[如–filter “foo=bar” –filter “bif=baz”]。
目前支持的过滤有：

dangling [布尔值 true或false]

label (label=或label==)

before ([:], or ) – 过滤出指定镜像之前的镜像

since ([:], or ) – 过滤出指定镜像之后的镜像

无tag镜像(dangling)

这会显示无tag镜像。当新构建的镜像占用这个镜像ID的repo:tag时，会出现这些图像，将其保留为：或untagged。可以使用如下命令批量删除这类镜像：

Labeled镜像

label过滤匹配指定label的镜像。
下面示例列出匹配com.example.version label的镜像。

下面示例列出匹配label名称为com.example.version，值为1.0的镜像。

Before

before过滤出指定镜像之前创建的镜像。例如：

使用before过滤将得到：

Since

since过滤出指定镜像之后创建的镜像。例如：

使用since过滤将得到：

格式

–format选项使用Go模板打印出指定格式的列表。
Go模板的有效占位符如下所示：

.ID – 镜像ID

.Repository – 镜像存储库名称

.Tag – 镜像tag

.Digest – 镜像digest

.CreatedSince – 从镜像创建到现在过去的时间

.CreatedAt – 镜像创建的时间

.Size – 镜像硬盘占用大小

当使用–format选项时，images命令输出模板声明的完全相同的数据，或者使用table指令，将包括列标题。
如下显示无列标题的数据：

显示带列标题的数据：

显示docker:latest镜像是如何构建的：

显示Apache是如何添加到Fedora base镜像的：

此命令可以提交一个容器的文件更改或设置到一个新的镜像。这允许你通过运行一个交互shell调试一个容器或输出一个工作集到另一台服务器。通常最好使用Dockerfile以文档化和可维护的方式来管理镜像。
这个commit操作不会包括在挂载在容器内的volumes的任何数据。
默认下，当正在提交更改到镜像时，容器的进程将暂停直到提交完成。这减小了在创建提交的过程中数据损坏的可能性。如果不想暂停进程，可以设置–pause选项为false。
–change选项用来应用Dockerfile指令到将要创建的镜像。支持的Dockerfile指令为CMD|ENTRYPOINT|ENV|EXPOSE|LABEL|ONBUILD|USER|VOLUME|WORKDIR。

使用新配置提交一个容器

使用新的CMD和EXPOSE指令提交一个容器