learn-tech/专栏/深入浅出Docker技术栈实践课（完）/02Docker命令行实践.md

                        因收到Google相关通知，网站将会择期关闭。相关通知内容
                        
                        
                        02 Docker 命令行实践
                        Docker 官方为了让用户快速上手，提供了一个交互式教程，旨在帮助用户掌握 Docker 命令行的使用方法。但是由于 Docker 技术的快速发展，此交互式教程已经无法满足用户的实际使用需求，所以让我们一起开始一次真正的命令行学习之旅。

首先，Docker 的命令清单可以通过运行 docker ，或者 docker help 命令得到： $ sudo docker。

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

功能划分 命令

环境信息相关

1. info 2. version

系统运维相关

1. attach 2. build 3. commit 4. cp 5. diff 6. images 7. export/ import / save / load 8. inspect 9. kill 10. port 11. pause / unpause 12. ps 13. rm 14. rmi 15. run 16. start / stop / restart 17. tag 18. top 19.wait 20. rename 21.stats 22. update 23. exec 24.deploy 25.create

日志信息相关

1. events 2. history 3. logs

Docker Hub服务相关

1. login/ logout 2. pull / push 3. search

参数约定

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

docker run -t -i --name test busybox sh

可以用这样的方式等同：

docker run -ti --name test busybox sh

布尔值约定

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

字符串和数字

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

后台进程

Docker 后台进程是一个常驻后台的系统进程，目前已经从 Docker 程序分离处理一份独立的程序 dockerd 来执行守护后台进程。这个后台进程是用来启动容器引擎的，使用 dockerd –help 可以得到更详细的功能参数配置。如下图：

Usage: dockerd COMMAND

A self-sufficient runtime for containers.

Options: --add-runtime runtime Register an additional OCI compatible runtime (default []) --allow-nondistributable-artifacts list Push nondistributable artifacts to specified registries (default []) --api-cors-header string Set CORS headers in the Engine API --authorization-plugin list Authorization plugins to load (default []) --bip string Specify network bridge IP -b, --bridge string Attach containers to a network bridge --cgroup-parent string Set parent cgroup for all containers --cluster-advertise string Address or interface name to advertise --cluster-store string URL of the distributed storage backend --cluster-store-opt map Set cluster store options (default map[]) --config-file string Daemon configuration file (default "/etc/docker/daemon.json") --containerd string Path to containerd socket --cpu-rt-period int Limit the CPU real-time period in microseconds --cpu-rt-runtime int Limit the CPU real-time runtime in microseconds --data-root string Root directory of persistent Docker state (default "/var/lib/docker") -D, --debug Enable debug mode --default-gateway ip Container default gateway IPv4 address --default-gateway-v6 ip Container default gateway IPv6 address --default-runtime string Default OCI runtime for containers (default "runc") --default-ulimit ulimit Default ulimits for containers (default []) --disable-legacy-registry Disable contacting legacy registries (default true) --dns list DNS server to use (default []) --dns-opt list DNS options to use (default []) --dns-search list DNS search domains to use (default []) --exec-opt list Runtime execution options (default []) --exec-root string Root directory for execution state files (default "/var/run/docker") --experimental Enable experimental features --fixed-cidr string IPv4 subnet for fixed IPs --fixed-cidr-v6 string IPv6 subnet for fixed IPs -G, --group string Group for the unix socket (default "docker") --help Print usage -H, --host list Daemon socket(s) to connect to (default []) --icc Enable inter-container communication (default true) --init Run an init in the container to forward signals and reap processes --init-path string Path to the docker-init binary --insecure-registry list Enable insecure registry communication (default []) --ip ip Default IP when binding container ports (default 0.0.0.0) --ip-forward Enable net.ipv4.ip_forward (default true) --ip-masq Enable IP masquerading (default true) --iptables Enable addition of iptables rules (default true) --ipv6 Enable IPv6 networking --label list Set key=value labels to the daemon (default []) --live-restore Enable live restore of docker when containers are still running --log-driver string Default driver for container logs (default "json-file") -l, --log-level string Set the logging level ("debug", "info", "warn", "error", "fatal") (default "info") --log-opt map Default log driver options for containers (default map[]) --max-concurrent-downloads int Set the max concurrent downloads for each pull (default 3) --max-concurrent-uploads int Set the max concurrent uploads for each push (default 5) --metrics-addr string Set default address and port to serve the metrics api on --mtu int Set the containers network MTU --no-new-privileges Set no-new-privileges by default for new containers --oom-score-adjust int Set the oom_score_adj for the daemon (default -500) -p, --pidfile string Path to use for daemon PID file (default "/var/run/docker.pid") --raw-logs Full timestamps without ANSI coloring --registry-mirror list Preferred Docker registry mirror (default []) --seccomp-profile string Path to seccomp profile --selinux-enabled Enable selinux support --shutdown-timeout int Set the default shutdown timeout (default 15) -s, --storage-driver string Storage driver to use --storage-opt list Storage driver options (default []) --swarm-default-advertise-addr string Set default address or interface for swarm advertised address --tls Use TLS; implied by --tlsverify --tlscacert string Trust certs signed only by this CA (default "/.docker/ca.pem") --tlscert string Path to TLS certificate file (default "/.docker/cert.pem") --tlskey string Path to TLS key file (default ~/.docker/key.pem") --tlsverify Use TLS and verify the remote --userland-proxy Use userland proxy for loopback traffic (default true) --userland-proxy-path string Path to the userland proxy binary --userns-remap string User/Group setting for user namespaces -v, --version Print version information and qui

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

参数 解释

–add-runtime runtime 选择容器运行时引擎，默认 containerd

–allow-nondistributable-artifacts list 因为类如 window base image 包含版权限制，所以配置指定的私有镜像仓库，可以帮助应用正常发布

–api-cors-header string 提供跨站 API 请求自定义包头信息

–authorization-plugin list 认证插件配置

–bip string 配置网桥地址

-b, –bridge string 连接网桥

–cgroup-parent string 配置容器的父 cgroup 信息

–cluster-advertise string 集群广播网络地址

–cluster-store string 集群存储支持

–cluster-store-opt map 集群存储参数配置

–config-file string 后台引擎参数配置文件

–containerd string 容器引擎实例网络套接字路径

–cpu-rt-period int 限制 CPU 间隔频率（微秒级别）

–cpu-rt-runtime int 限制 CPU 运行时频率（微秒级别）

–data-root string 容器引擎数据根目录地址

-D, –debug 调试信息

–default-gateway ip 容器默认 IPv4 网络网关

–default-gateway-v6 ip 容器默认 IPv6 网络网关

–default-runtime string 容器运行时，默认 runc

–default-ulimit ulimit 配置容器默认最大文件限制数，改善运行性能

–disable-legacy-registry 废弃老版本镜像仓库

–dns list DNS 服务地址

–dns-opt list DNS 服务参数

–dns-search list DNS服务查询域名配置

–exec-opt list 运行时执行参数

–exec-root string 运行时执行根目录地址

–experimental 启用实验性特性

–fixed-cidr string 固定 IPv4 网段

–fixed-cidr-v6 string 固定 IPv6 网段

-G, –group string 网络套接字所属组

–help 帮助信息

-H, –host list 后台进程连接地址

–icc 启用容器间的网络互联，默认启用

–init 在容器运行时启动一个 init 程序，来统一管理进程

–init-path string docker init 的路径地址

–insecure-registry list 非安全镜像仓库地址列表

–ip ip 默认容器绑定 IP 地址，默认 0.0.0.0

–ip-forward 启动 net.ipv4.ip_forward

–ip-masq 启动IP混淆

–iptables 启动默认的iptable规则

–ipv6 启动 IPv6 网络

–label list 配置键值对参数到引擎后台

–live-restore 启用容器热迁移特性

–log-driver string 日志驱动配置，默认 json-file

-l, –log-level string 日志级别

–log-opt map 日志驱动参数

–max-concurrent-downloads int 每次 pull 的最大下载线程数

–max-concurrent-uploads int 每次 push 最大上传线程数

–metrics-addr string 监控地址

–mtu int 网络数据包 MTU 配置

–no-new-privileges 去掉 nonewprivs 权限

–oom-score-adjust int OOM 阈值配置

-p, –pidfile string 引擎后台进程文件地址

–raw-logs 无 ANSI 颜色的日志

–registry-mirror list 镜像仓库同步镜像地址

–seccomp-profile string seccomp 文件地址

–selinux-enabled 启用 selinux

–shutdown-timeout int 默认停机超时时间，默认15 秒

-s, –storage-driver string 容器存储驱动

–storage-opt list 容器存储驱动参数

–swarm-default-advertise-addr string swarm 集群广播地址

–tls 使用 TLS 认证

–tlscacert string CA 文件地址

–tlscert string TLS 认证文件地址

–tlskey string TLS 私钥地址

–tlsverify 使用 TLS 认证

–userland-proxy 使用用户态 proxy 来路由 loopback 流量

–userland-proxy-path string 用户态 proxy 地址

–userns-remap string 用户命令空间的用户、用户组配置

-v, –version 版本

Docker 命令行探秘

环境信息相关

info

使用方法：docker info

例子：

[fedora@docker-devel-cli docker]$ sudo docker -D info Containers: 0 Images: 32 Storage Driver: devicemapper Pool Name: docker-252:1-130159-pool Data file: /var/lib/docker/devicemapper/devicemapper/data Metadata file: /var/lib/docker/devicemapper/devicemapper/metadata Data Space Used: 1616.9 Mb Data Space Total: 102400.0 Mb Metadata Space Used: 2.4 Mb Metadata Space Total: 2048.0 Mb Execution Driver: native-0.2 Kernel Version: 3.11.10-301.fc20.x86_64 Debug mode (server): false Debug mode (client): true Fds: 11 Goroutines: 14 EventsListeners: 0 Init SHA1: 2c5adb59737b8a01fa3fb968519a43fe140bc9c9 Init Path: /usr/libexec/docker/dockerinit Sockets: [fd://]

使用说明：

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

version

使用方法：docker version

使用说明：

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

系统运维相关

attach

使用方法：docker attach [OPTIONS] CONTAINER

例子：

$ ID=$(sudo docker run -d ubuntu /usr/bin/top -b) $ sudo docker attach $ID top - 17:21:49 up 5:53, 0 users, load average: 0.63, 1.15, 0.78 Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie %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 KiB Mem: 2051644 total, 723700 used, 1327944 free, 33032 buffers KiB Swap: 0 total, 0 used, 0 free. 565836 cached Mem

PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND 1 root 20 0 19748 1280 1008 R 0.0 0.1 0:00.04 top $ sudo docker stop $ID

使用说明：

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

build

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

例子：

$ docker build . Uploading context 18.829 MB Uploading context Step 0 : FROM busybox ---> 769b9341d937 Step 1 : CMD echo Hello world ---> Using cache ---> 99cc1ad10469 Successfully built 99cc1ad10469

使用说明：

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

commit

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

例子：

$ sudo docker ps ID IMAGE COMMAND CREATED STATUS PORTS c3f279d17e0a ubuntu:12.04 /bin/bash 7 days ago Up 25 hours 197387f1b436 ubuntu:12.04 /bin/bash 7 days ago Up 25 hours $ docker commit c3f279d17e0a SvenDowideit/testimage:version3 f5283438590d $ docker images | head REPOSITORY TAG ID CREATED VIRTUAL SIZE 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

例子：

$ sudo docker diff 7bb0e258aefe

C /dev A /dev/kmsg C /etc A /etc/mtab A /go A /go/src A /go/src/github.com A /go/src/github.com/dotcloud ....

使用说明：

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

images

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

例子：

$ sudo docker images | head REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 77af4d6b9913 19 hours ago 1.089 GB committest latest b6fa739cedf5 19 hours ago 1.089 GB 78a85c484f71 19 hours ago 1.089 GB $ docker latest 30557a29d5ab 20 hours ago 1.089 GB 0124422dd9f9 20 hours ago 1.089 GB 18ad6fad3402 22 hours ago 1.082 GB f9f1e26352f0 23 hours ago 1.089 GB tryout latest 2629d1fa0b81 23 hours ago 131.5 MB 5ed6274db6ce 24 hours ago 1.089 GB

使用说明：

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

export/ import / save / load

使用方法：

docker export red_panda > latest.tar docker import URL|- [REPOSITORY[:TAG]] docker save IMAGE docker load

使用说明：

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

inspect

使用方法：

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

例子：

$ sudo docker inspect --format='{{.NetworkSettings.IPAddress}}' $INSTANCE_ID

使用说明：

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

kill

使用方法：

docker kill [OPTIONS] CONTAINER [CONTAINER...]

使用说明：

杀掉容器的进程。

port

使用方法：

docker port CONTAINER PRIVATE_PORT

使用说明：

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

pause / unpause

使用方法：

docker pause CONTAINER

使用说明：

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

ps

使用方法：

docker ps [OPTIONS]

例子：

$ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up 16 seconds webapp d7886598dbe2 crosbymichael/redis:latest /redis-server --dir 33 minutes ago Up 33 minutes 6379/tcp redis,webapp/db

使用说明：

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

rm

使用方法：

docker rm [OPTIONS] CONTAINER [CONTAINER...]

例子：

$ sudo docker rm /redis /redis

使用说明：

删除指定的容器。

rmi

使用方法：

docker rmi IMAGE [IMAGE...]

例子：

$ sudo docker images REPOSITORY TAG IMAGE ID CREATED SIZE test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) test2 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB)

$ sudo docker rmi fd484f19954f Error: Conflict, cannot delete image fd484f19954f because it is tagged in multiple repositories 2013/12/11 05:47:16 Error: failed to remove one or more images

$ sudo docker rmi test1 Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8

$ sudo docker rmi test2 Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8

$ sudo docker images REPOSITORY TAG IMAGE ID CREATED SIZE test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB)

$ sudo docker rmi test Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8

使用说明：

指定删除 Image 文件。

run

使用方法：

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

例子：

$ sudo docker run --cidfile /tmp/docker_test.cid ubuntu echo "test"

使用说明：

这个命令是核心命令，可以配置的子参数详细解释可以通过 docker run –help 列出。

start / stop / restart

使用方法：

docker start CONTAINER [CONTAINER...]

使用说明：

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

tag

使用方法：

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

使用说明：

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

top

使用方法：

docker top CONTAINER [ps OPTIONS]

使用说明：

显示容器內运行的进程。

wait

使用方法：

docker wait CONTAINER [CONTAINER...]

使用说明：

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

rename

使用方法：

docker rename CONTAINER NEW_NAME

使用说明：

重新命名一个容器。

stats

使用方法：

docker stats [OPTIONS] [CONTAINER...]

使用说明：

实时显示容器资源使用监控指标。

update

使用方法：

docker update [OPTIONS] CONTAINER [CONTAINER...]

使用说明：

更新一或多个容器实例的 IO、CPU、内存，启动策略参数。

exec

使用方法：

docker exec [OPTIONS] CONTAINER COMMAND [ARG...]

使用说明：

在运行中容器中运行命令。

deploy

使用方法：

docker deploy [OPTIONS] STACK

使用说明：

部署新的 stack 文件，两种格式 DAB 格式和 Compose 格式，当前使用趋势来看，Compose 成为默认标准。

create

使用方法：

docker create [OPTIONS] IMAGE [COMMAND] [ARG...]

使用说明：

这是一个重要的命令，可以创建容器但并不执行它。

日志信息相关

events

使用方法：

docker events [OPTIONS]

使用说明：

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

history

使用方法：

docker history [OPTIONS] IMAGE

例子：

$ docker history docker IMAGE CREATED CREATED BY SIZE 3e23a5875458790b7a806f95f7ec0d0b2a5c1659bfc899c89f939f6d5b8f7094 8 days ago /bin/sh -c #(nop) ENV LC_ALL=C.UTF-8 0 B 8578938dd17054dce7993d21de79e96a037400e8d28e15e7290fea4f65128a36 8 days ago /bin/sh -c dpkg-reconfigure locales && locale-gen C.UTF-8 && /usr/sbin/update-locale LANG=C.UTF-8 1.245 MB be51b77efb42f67a5e96437b3e102f81e0a1399038f77bf28cea0ed23a65cf60 8 days ago /bin/sh -c apt-get update && apt-get install -y git libxml2-dev python build-essential make gcc python-dev locales python-pip 338.3 MB 4b137612be55ca69776c7f30c2d2dd0aa2e7d72059820abf3e25b629f887a084 6 weeks ago /bin/sh -c #(nop) ADD jessie.tar.xz in / 121 MB 750d58736b4b6cc0f9a9abe8f258cef269e3e9dceced1146503522be9f985ada 6 weeks ago /bin/sh -c #(nop) MAINTAINER Tianon Gravi <[email protected]>

• mkimage-debootstrap.sh -t jessie.tar.xz jessie http://http.debian.net/debian 0 B 511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158 9 months ago 0 B

使用说明：

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

logs

使用方法：

docker logs CONTAINER

使用说明：

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

Hub服务相关

login/ logout

使用方法：

docker login [OPTIONS] [SERVER] docker logout [SERVER]

使用说明：

登录登出 Docker Hub 服务。

pull / push

使用方法：

docker push NAME[:TAG]

使用说明：

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

search

使用方法：

docker search TERM

使用说明：

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

总结

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