深入浅出Docker（二）：Docker命令行探秘

共计 13364 个字符，预计需要花费 34 分钟才能阅读完成。

1. Docker 命令行

Docker 官方为了让用户快速了解 Docker，提供了一个交互式教程，旨在帮助用户掌握 Docker 命令行的使用方法。但是由于 Docker 技术的快速发展，此交互式教程已经无法满足 Docker 用户的实际使用需求，所以让我们一起开始一次真正的命令行学习之旅。首先，Docker 的命令清单可以通过运行 docker，或者 docker help 命令得到:

$ sudo docker

在 Docker 容器技术不断演化的过程中，Docker 的子命令已经达到 34 个之多，其中核心子命令 (例如：run) 还会有复杂的参数配置。笔者通过结合功能和应用场景方面的考虑，把命令行划分为 4 个部分，方便我们快速概览 Docker 命令行的组成结构：

1.1 参数约定

单个字符的参数可以放在一起组合配置，例如

1. docker run –t –i —name test busybox sh

可以用这样的方式等同：

1. docker run –ti —name test busybox sh

1.2 Boolean

Boolean 参数形式如：-d=false。注意，当你声明这个 Boolean 参数时，比如 docker run -d=true，它将直接把启动的 Container 挂起放在后台运行。

1.3 字符串和数字

参数如 –name=“”定义一个字符串，它仅能被定义一次。同类型的如 -c=0 定义一个数字，它也只能被定义一次。

1.4 后台进程

Docker 后台进程是一个常驻后台的系统进程，值得注意的是 Docker 使用同一个文件来支持客户端和后台进程，其中角色切换通过 - d 来实现。这个后台进程是用来管理容器的，使用 Docker –help 可以得到更详细的功能参数配置, 如下图：

CentOS 6/ 7 系列安装 Docker http://www.linuxidc.com/Linux/2014-07/104768.htm

Docker 的搭建 Gitlab CI 全过程详解 http://www.linuxidc.com/Linux/2013-12/93537.htm

Docker 安装应用(CentOS 6.5_x64) http://www.linuxidc.com/Linux/2014-07/104595.htm

在 Docker 中使用 MySQL http://www.linuxidc.com/Linux/2014-01/95354.htm

在 Ubuntu Trusty 14.04 (LTS) (64-bit)安装 Docker http://www.linuxidc.com/Linux/2014-10/108184.htm

Docker 安装应用(CentOS 6.5_x64) http://www.linuxidc.com/Linux/2014-07/104595.htm

Ubuntu 14.04 安装 Docker  http://www.linuxidc.com/linux/2014-08/105656.htm

阿里云 CentOS 6.5 模板上安装 Docker http://www.linuxidc.com/Linux/2014-11/109107.htm

Docker 后台进程参数清单如下表

注意，其中带有[] 的启动参数可以指定多次，例如

1. $ docker run –a stdin –a stdout –a stderr –i –t ubuntu /bin/bash

更多详情见请继续阅读下一页的精彩内容：http://www.linuxidc.com/Linux/2014-12/110917p2.htm

2. Docker 命令行探秘

2.1 环境信息相关

info

使用方法：docker info

例子：

1. [Fedora@docker–devel–cli docker]$ sudo docker –D info
2. Containers:0
3. Images:32
4. StorageDriver: devicemapper
5. PoolName: docker–252:1–130159–pool
6. Data file:/var/lib/docker/devicemapper/devicemapper/data
7. Metadata file:/var/lib/docker/devicemapper/devicemapper/metadata
8. DataSpaceUsed:1616.9Mb
9. DataSpaceTotal:102400.0Mb
10. MetadataSpaceUsed:2.4Mb
11. MetadataSpaceTotal:2048.0Mb
12. ExecutionDriver:native–0.2
13. KernelVersion:3.11.10–301.fc20.x86_64
14. Debug mode (server):false
15. Debug mode (client):true
16. Fds:11
17. Goroutines:14
18. EventsListeners:0
19. Init SHA1:2c5adb59737b8a01fa3fb968519a43fe140bc9c9
20. InitPath:/usr/libexec/docker/dockerinit
21. Sockets:[fd://]

使用说明：

这个命令在开发者报告 Bug 时会非常有用，结合 docker vesion 一起，可以随时使用这个命令把本地的配置信息提供出来，方便 Docker 的开发者快速定位问题。

version

使用方法：docker version

使用说明：

显示 Docker 的版本号，API 版本号，Git commit，Docker 客户端和后台进程的 Go 版本号。

2.2 系统运维相关

attach

使用方法：docker attach [OPTIONS] CONTAINER

例子：

1. $ ID=$(sudo docker run –d Ubuntu /usr/bin/top –b)
2. $ sudo docker attach $ID
3. top –17:21:49 up 5:53,0 users, load average:0.63,1.15,0.78
4. Tasks:1 total,1 running,0 sleeping,0 stopped,0 zombie
5. %Cpu(s):1.0 us,0.7 sy,0.0 ni,97.7 id,0.7 wa,0.0 hi,0.0 si,0.0 st
6. KiBMem:2051644 total,723700 used,1327944 free,33032 buffers
7. KiBSwap:0 total,0 used,0 free.565836 cached Mem
8.  
9. PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
10. 1 root 2001974812801008 R 0.00.10:00.04 top
11. $ sudo docker stop $ID

使用说明：

使用这个命令可以挂载正在后台运行的容器，在开发应用的过程中运用这个命令可以随时观察容器內进程的运行状况。开发者在开发应用的场景中，这个命令是一个非常有用的命令。

build

使用方法：docker build [OPTIONS] PATH | URL | –

例子：

1. $ docker build .
2. Uploading context 18.829 MB
3. Uploading context
4. Step0: FROM busybox
5. —>769b9341d937
6. Step1: CMD echo Hello world
7. —>Using cache
8. —>99cc1ad10469
9. Successfully built 99cc1ad10469

使用说明：

这个命令是从源码构建新 Image 的命令。因为 Image 是分层的，最关键的 Base Image 是如何构建的是用户比较关心的，Docker 官方文档给出了构建方法，请参考这里。

commit

使用方法：docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]

例子：

1. $ sudo docker ps
2. ID IMAGE COMMAND CREATED STATUS PORTS
3. c3f279d17e0a ubuntu:12.04/bin/bash 7 days ago Up25 hours
4. 197387f1b436 ubuntu:12.04/bin/bash 7 days ago Up25 hours
5. $ docker commit c3f279d17e0a SvenDowideit/testimage:version3
6. f5283438590d
7. $ docker images | head
8. REPOSITORY TAG ID CREATED VIRTUAL SIZE
9. SvenDowideit/testimage version3 f5283438590d 16 seconds ago 335.7 MB

使用说明：

这个命令的用处在于把有修改的 container 提交成新的 Image，然后导出此 Imange 分发给其他场景中调试使用。Docker 官方的建议是，当你在调试完 Image 的问题后，应该写一个新的 Dockerfile 文件来维护此 Image。commit 命令仅是一个临时创建 Imange 的辅助命令。

cp

使用方法：cp CONTAINER:PATH HOSTPATH

使用说明：

使用 cp 可以把容器內的文件复制到 Host 主机上。这个命令在开发者开发应用的场景下，会需要把运行程序产生的结果复制出来的需求，在这个情况下就可以使用这个 cp 命令。

diff

使用方法：docker diff CONTAINER

例子：

1. $ sudo docker diff 7bb0e258aefe
2.  
3. C /dev
4. A /dev/kmsg
5. C /etc
6. A /etc/mtab
7. A /go
8. A /go/src
9. A /go/src/github.com
10. A /go/src/github.com/dotcloud
11. ….

使用说明：

diff 会列出 3 种容器内文件状态变化（A – Add, D – Delete, C – Change）的列表清单。构建 Image 的过程中需要的调试指令。

export

使用方法：docker export CONTAINER

例子：

1. $ sudo docker export red_panda > latest.tar

使用说明：

把容器系统文件打包并导出来，方便分发给其他场景使用。

images

使用方法：docker images [OPTIONS] [NAME]

例子：

1. $ sudo docker images | head
2. REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
3. <none><none>77af4d6b991319 hours ago 1.089 GB
4. committest latest b6fa739cedf5 19 hours ago 1.089 GB
5. <none><none>78a85c484f7119 hours ago 1.089 GB
6. $ docker latest 30557a29d5ab20 hours ago 1.089 GB
7. <none><none>0124422dd9f920 hours ago 1.089 GB
8. <none><none>18ad6fad340222 hours ago 1.082 GB
9. <none><none> f9f1e26352f0 23 hours ago 1.089 GB
10. tryout latest 2629d1fa0b8123 hours ago 131.5 MB
11. <none><none>5ed6274db6ce24 hours ago 1.089 GB

使用说明：

Docker Image 是多层结构的，默认只显示最顶层的 Image。不显示的中间层默认是为了增加可复用性、减少磁盘使用空间，加快 build 构建的速度的功能，一般用户不需要关心这个细节。

import / save / load

使用方法：

1. docker import URL|-[REPOSITORY[:TAG]]
2. docker save IMAGE
3. docker load

使用说明：

这一组命令是系统运维里非常关键的命令。加载 (两种方法: import, load)，导出(一种方法: save) 容器系统文件。

inspect

使用方法：

1. docker inspect CONTAINER|IMAGE [CONTAINER|IMAGE…]

例子：

1. $ sudo docker inspect —format=‘{{.NetworkSettings.IPAddress}}’ $INSTANCE_ID

使用说明：

查看容器运行时详细信息的命令。了解一个 Image 或者 Container 的完整构建信息就可以通过这个命令实现。

kill

使用方法：

1. docker kill [OPTIONS] CONTAINER [CONTAINER…]

使用说明：

杀掉容器的进程。

port

使用方法：

1. docker port CONTAINER PRIVATE_PORT

使用说明：

打印出 Host 主机端口与容器暴露出的端口的 NAT 映射关系

pause / unpause

使用方法：

1. docker pause CONTAINER

使用说明：

使用 cgroup 的 freezer 顺序暂停、恢复容器里的所有进程。详细 freezer 的特性，请参考官方文档。

ps

使用方法：

1. docker ps [OPTIONS]

例子：

1. $ docker ps
2. CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
3. 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up16 seconds webapp
4. d7886598dbe2 crosbymichael/redis:latest /redis–server —dir 33 minutes ago Up33 minutes 6379/tcp redis,webapp/db

使用说明：

docker ps 打印出正在运行的容器，docker ps - a 打印出所有运行过的容器。

rm

使用方法：

1. docker rm [OPTIONS] CONTAINER [CONTAINER…]

例子：

1. $ sudo docker rm /redis
2. /redis

使用说明：

删除指定的容器。

rmi

使用方法：

1. docker rmi IMAGE [IMAGE…]

例子：

1. $ sudo docker images
2. REPOSITORY TAG IMAGE ID CREATED SIZE
3. test1 latest fd484f19954f 23 seconds ago 7 B (virtual4.964 MB)
4. test latest fd484f19954f 23 seconds ago 7 B (virtual4.964 MB)
5. test2 latest fd484f19954f 23 seconds ago 7 B (virtual4.964 MB)
6.  
7. $ sudo docker rmi fd484f19954f
8. Error:Conflict, cannot delete image fd484f19954f because it is tagged in multiple repositories
9. 2013/12/1105:47:16Error: failed to remove one or more images
10.  
11. $ sudo docker rmi test1
12. Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
13.  
14. $ sudo docker rmi test2
15. Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
16.  
17. $ sudo docker images
18. REPOSITORY TAG IMAGE ID CREATED SIZE
19. test latest fd484f19954f 23 seconds ago 7 B (virtual4.964 MB)
20.  
21. $ sudo docker rmi test
22. Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
23. Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8

使用说明：

指定删除 Image 文件。

run

使用方法：

1. docker run [OPTIONS] IMAGE [COMMAND][ARG…]

例子：

1. $ sudo docker run —cidfile /tmp/docker_test.cid ubuntu echo “test”

使用说明：

这个命令是核心命令，可以配置的参数多达 28 个参数。详细的解释可以通过 docker run –help 列出。官方文档中提到的 Issue 2702：”lxc-start: Permission denied – failed to mount” could indicate a permissions problem with AppArmor. 在最新版本的 Dcoker 中已经解决。

start / stop / restart

使用方法：

1. docker start CONTAINER [CONTAINER…]

使用说明：

这组命令可以开启 (两个：start, restart)，停止(一个：stop) 一个容器。

tag

使用方法：

1. docker tag [OPTIONS] IMAGE[:TAG][REGISTRYHOST/][USERNAME/]NAME[:TAG]

使用说明：

组合使用用户名，Image 名字，标签名来组织管理 Image。

top

使用方法：

1. docker top CONTAINER [ps OPTIONS]

使用说明：

显示容器內运行的进程。

wait

使用方法：

1. docker wait CONTAINER [CONTAINER…]

使用说明：

阻塞对指定容器的其他调用方法，直到容器停止后退出阻塞。

1. Docker 命令行

Docker 官方为了让用户快速了解 Docker，提供了一个交互式教程，旨在帮助用户掌握 Docker 命令行的使用方法。但是由于 Docker 技术的快速发展，此交互式教程已经无法满足 Docker 用户的实际使用需求，所以让我们一起开始一次真正的命令行学习之旅。首先，Docker 的命令清单可以通过运行 docker，或者 docker help 命令得到:

$ sudo docker

在 Docker 容器技术不断演化的过程中，Docker 的子命令已经达到 34 个之多，其中核心子命令 (例如：run) 还会有复杂的参数配置。笔者通过结合功能和应用场景方面的考虑，把命令行划分为 4 个部分，方便我们快速概览 Docker 命令行的组成结构：

1.1 参数约定

单个字符的参数可以放在一起组合配置，例如

1. docker run –t –i —name test busybox sh

可以用这样的方式等同：

1. docker run –ti —name test busybox sh

1.2 Boolean

Boolean 参数形式如：-d=false。注意，当你声明这个 Boolean 参数时，比如 docker run -d=true，它将直接把启动的 Container 挂起放在后台运行。

1.3 字符串和数字

参数如 –name=“”定义一个字符串，它仅能被定义一次。同类型的如 -c=0 定义一个数字，它也只能被定义一次。

1.4 后台进程

Docker 后台进程是一个常驻后台的系统进程，值得注意的是 Docker 使用同一个文件来支持客户端和后台进程，其中角色切换通过 - d 来实现。这个后台进程是用来管理容器的，使用 Docker –help 可以得到更详细的功能参数配置, 如下图：

CentOS 6/ 7 系列安装 Docker http://www.linuxidc.com/Linux/2014-07/104768.htm

Docker 的搭建 Gitlab CI 全过程详解 http://www.linuxidc.com/Linux/2013-12/93537.htm

Docker 安装应用(CentOS 6.5_x64) http://www.linuxidc.com/Linux/2014-07/104595.htm

在 Docker 中使用 MySQL http://www.linuxidc.com/Linux/2014-01/95354.htm

在 Ubuntu Trusty 14.04 (LTS) (64-bit)安装 Docker http://www.linuxidc.com/Linux/2014-10/108184.htm

Docker 安装应用(CentOS 6.5_x64) http://www.linuxidc.com/Linux/2014-07/104595.htm

Ubuntu 14.04 安装 Docker  http://www.linuxidc.com/linux/2014-08/105656.htm

阿里云 CentOS 6.5 模板上安装 Docker http://www.linuxidc.com/Linux/2014-11/109107.htm

Docker 后台进程参数清单如下表

注意，其中带有[] 的启动参数可以指定多次，例如

1. $ docker run –a stdin –a stdout –a stderr –i –t ubuntu /bin/bash

更多详情见请继续阅读下一页的精彩内容：http://www.linuxidc.com/Linux/2014-12/110917p2.htm

2.3 日志信息相关

events

使用方法：

1. docker events [OPTIONS]

使用说明：

打印容器实时的系统事件。

history

使用方法：

1. docker history [OPTIONS] IMAGE

例子：

1. $ docker history docker
2. IMAGE CREATED CREATED BY SIZE
3. 3e23a5875458790b7a806f95f7ec0d0b2a5c1659bfc899c89f939f6d5b8f70948 days ago
4. /bin/sh –c #(nop) ENV LC_ALL=C.UTF-8 0 B
5. 8578938dd17054dce7993d21de79e96a037400e8d28e15e7290fea4f65128a368 days ago
6. /bin/sh –c dpkg–reconfigure locales && locale–gen C.UTF–8&&
7. /usr/sbin/update–locale LANG=C.UTF–81.245 MB
8. be51b77efb42f67a5e96437b3e102f81e0a1399038f77bf28cea0ed23a65cf60 8 days ago /bin/sh
9. –c apt–get update && apt–get install –y git libxml2–dev Python build–essential
10. make gcc python–dev locales python–pip 338.3 MB
11. 4b137612be55ca69776c7f30c2d2dd0aa2e7d72059820abf3e25b629f887a0846 weeks ago
12. /bin/sh –c #(nop) ADD jessie.tar.xz in / 121 MB
13. 750d58736b4b6cc0f9a9abe8f258cef269e3e9dceced1146503522be9f985ada6 weeks ago
14. /bin/sh –c #(nop) MAINTAINER Tianon Gravi <admwiggin@gmail.com>
15. – mkimage–debootstrap.sh –t jessie.tar.xz jessie http://http.debian.net/debian 0 B
16. 511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c1589 months ago 0 B

使用说明：

打印指定 Image 中每一层 Image 命令行的历史记录。

logs

使用方法：

1. docker logs CONTAINER

使用说明：

批量打印出容器中进程的运行日志。

2.4 Dcoker Hub 服务相关

login

使用方法：

1. docker login [OPTIONS][SERVER]

使用说明：

登录 Hub 服务。

pull / push

使用方法：

1. docker push NAME[:TAG]

使用说明：

通过此命令分享 Image 到 Hub 服务或者自服务的 Registry 服务。

search

使用方法：

1. docker search TERM

使用说明：

通过关键字搜索分享的 Image。

3. 总结

通过以上 Docker 命令行的详细解释，可以强化对 Docker 命令的全面理解。考虑到 Docker 命令行的发展变化非常快，读者可以参考官方的命令行解释文档更新相应的命令行解释。另外，通过以上 Docker 命令行的分析，可以知道 Docker 命令行架构设计的特点在于客户端和服务端的运行文件是同一个文件，内部实现代码应该是重用的设计。笔者希望开发者在开发类似的命令行应用时参考这样的设计，减少前后台容错的复杂度。

Docker 的详细介绍：请点这里
Docker 的下载地址：请点这里

参考文献

[1] https://docs.docker.com/reference/commandline/cli/

[2] https://en.wikipedia.org/wiki/Cross-Origin_Resource_Sharing

[3] https://en.wikipedia.org/wiki/CIDR_notation#CIDR_notation