3. Docker 命令汇总
3.1 容器生命周期管理
run：创建一个新的容器并运行一个命令
- 语法：
docker run [OPTIONS] IMAGE [COMMAND] [ARG...]
- OPTIONS说明：
- -a stdin: 指定标准输入输出内容类型，可选 STDIN/STDOUT/STDERR 三项；
- -d: 后台运行容器，并返回容器ID；
- -i: 以交互模式运行容器，通常与 -t 同时使用；
- -P: 随机端口映射，容器内部端口随机映射到主机的高端口
- -p: 指定端口映射，格式为：主机(宿主)端口:容器端口；
- -t: 为容器重新分配一个伪输入终端，通常与 -i 同时使用；
- --name="nginx-lb": 为容器指定一个名称；
- --dns 8.8.8.8: 指定容器使用的DNS服务器，默认和宿主一致；
- --dns-search example.com: 指定容器DNS搜索域名，默认和宿主一致
- -h "mars": 指定容器的hostname；
- -e username="ritchie": 设置环境变量；
- --env-file=[]: 从指定文件读入环境变量；
- --cpuset="0-2" or --cpuset="0,1,2": 绑定容器到指定CPU运行；
- -m :设置容器使用内存最大值；
- --net="bridge": 指定容器的网络连接类型，支持 bridge/host/none/container: 四种类型；
- --link=[]: 添加链接到另一个容器；
- --expose=[]: 开放一个端口或一组端口；
- --volume , -v: 绑定一个卷；
- 实例：
# 使用docker镜像nginx:latest以后台模式启动一个容器,并将容器命名为mynginx。
$ docker run --name mynginx -d nginx:latest
# 使用镜像nginx:latest以后台模式启动一个容器,并将容器的80端口映射到主机随机端口。
$ docker run -P -d nginx:latest
# 使用镜像 nginx:latest，以后台模式启动一个容器,将容器的 80 端口映射到主机的 80 端口,主机的目录 /data 映射到容器的 /data。
$ docker run -p 80:80 -v /data:/data -d nginx:latest
# 绑定容器的 8080 端口，并将其映射到本地主机 127.0.0.1 的 80 端口上。
$ docker run -p 127.0.0.1:80:8080/tcp ubuntu bash
# 使用镜像nginx:latest以交互模式启动一个容器,在容器内执行/bin/bash命令。
$ runoob@runoob:~$ docker run -it nginx:latest /bin/bash
start/stop/restart：启动/停止/重启容器
# 启动一个或多个已经被停止的容器
$ docker start [OPTIONS] CONTAINER [CONTAINER...]
# 停止一个运行中的容器
$ docker stop [OPTIONS] CONTAINER [CONTAINER...]
# 重启容器
$ docker restart [OPTIONS] CONTAINER [CONTAINER...]
kill：杀掉一个运行中的容器
- 语法：
docker kill [OPTIONS] CONTAINER [CONTAINER...]
- OPTIONS说明：
- 实例：
$ docker kill -s KILL mynginx
rm：删除一个或多少容器
- 语法：
docker rm [OPTIONS] CONTAINER [CONTAINER...]
- OPTIONS说明：
- -f :通过SIGKILL信号强制删除一个运行中的容器；
- -l :移除容器间的网络连接，而非容器本身；
- -v :-v 删除与容器关联的卷
- 实例：
# 强制删除容器db01、db02
$ docker rm -f db01 db02
# 移除容器nginx01对容器db01的连接，连接名db
$ docker rm -l db
# 删除容器nginx01,并删除容器挂载的数据卷
$ docker rm -v nginx01
pause/unpause：暂停/恢复容器中所有的进程
$ docker pause [OPTIONS] CONTAINER [CONTAINER...]
$ docker unpause [OPTIONS] CONTAINER [CONTAINER...]
# 暂停数据库容器db01提供服务。
$ docker pause db01
# 恢复数据库容器db01提供服务。
$ docker unpause db01
create：创建一个新的容器但不启动它
- 语法：
docker create [OPTIONS] IMAGE [COMMAND] [ARG...]
- OPTIONS说明：(用法同 docker run一致，查看 run 指令的即可)
- 实例：
# 使用docker镜像nginx:latest创建一个容器,并将容器命名为myrunoob
$ docker create --name myrunoob nginx:latest
exec：在运行的容器中执行命令
- 语法：
docker exec [OPTIONS] CONTAINER COMMAND [ARG...]
- OPTIONS说明：
- -d :分离模式: 在后台运行；
- -i :即使没有附加也保持STDIN 打开；
- -t :分配一个伪终端；
- 实例：
# 在容器 mynginx 中以交互模式执行容器内 /root/runoob.sh 脚本:
$ runoob@runoob:~$ docker exec -it mynginx /bin/sh /root/runoob.sh
# 在容器 mynginx 中开启一个交互模式的终端:
$ runoob@runoob:~$ docker exec -i -t mynginx /bin/bash
# 还可以通过 docker ps -a 命令查看已经在运行的容器，然后使用容器 ID 进入容器：
$ docker ps -a
$ docker exec -it [容器ID] /bin/bash
3.2 容器操作
ps：列出容器
- 语法：
docker ps [OPTIONS]
- OPTIONS说明：
- -a :显示所有的容器，包括未运行的；
- -f :根据条件过滤显示的内容；
- --format :指定返回值的模板文件；
- -l :显示最近创建的容器；
- -n :列出最近创建的n个容器；
- --no-trunc :不截断输出；
- -q :静默模式，只显示容器编号；
- -s :显示总的文件大小；
- 实例：
# 列出所有在运行的容器信息
$ docker ps
# 列出最近创建的5个容器信息
$ docker ps -n 5
# 列出所有创建的容器ID
$ docker ps -a -q
inspect： 获取容器/镜像的元数据
- 语法：
docker inspect [OPTIONS] NAME|ID [NAME|ID...]
- OPTIONS说明：
- -f :指定返回值的模板文件。
- -s :显示总的文件大小。
- --type :为指定类型返回JSON。
- 实例：
# 获取镜像mysql:5.6的元信息
$ docker inspect mysql:5.6
# 获取正在运行的容器mymysql的 IP
$ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' mymysql
top：查看容器中运行的进程信息（支持 ps 命令参数）
- 语法：
docker top [OPTIONS] CONTAINER [ps OPTIONS]
- 说明：容器运行时不一定有
/bin/bash终端来交互执行top命令，而且容器还不一定有top命令，可以使用docker top来实现查看container中正在运行的进程；
- 实例：
# 查看容器mymysql的进程信息。
$ docker top mymysql
UID PID PPID C STIME TTY TIME CMD
999 40347 40331 18 00:58 ? 00:00:02 mysqld
# 查看所有运行容器的进程信息。
$ for i in `docker ps |grep Up|awk '{print $1}'`;do echo \ &&docker top $i; done
attach：连接到正在运行中的容器
- 语法：
docker attach [OPTIONS] CONTAINER
- 说明：测试中在container当前在运行bash，
CTRL-C自然是当前行的输入，没有退出；如果container当前正在前台运行进程，如输出nginx的access.log日志，CTRL-C不仅会导致退出容器，而且还stop了。这不是我们想要的，detach的意思按理应该是脱离容器终端，但容器依然运行。好在attach是可以带上--sig-proxy=false来确保CTRL-D或CTRL-C不会关闭容器。
- 实例：
# 容器 mynginx 将访问日志指到标准输出，连接到容器查看访问信息。
$ docker attach --sig-proxy=false mynginx
events：从服务器获取实时事件
- 语法：
docker events [OPTIONS]
- OPTIONS说明：
- -f ：根据条件过滤事件；
- --since ：从指定的时间戳后显示所有事件;
- --until ：流水时间显示到指定的时间为止；
- 实例：
# 显示docker 2016年7月1日后的所有事件。
$ docker events --since="1467302400"
# 显示docker 镜像为mysql:5.6 2016年7月1日后的相关事件。
$ docker events -f "image"="mysql:5.6" --since="1467302400"
# 如果指定的时间是到秒级的，需要将时间转成时间戳。如果时间为日期的话，可以直接使用，如--since="2016-07-01"。
logs：获取容器的日志
- 语法：
docker logs [OPTIONS] CONTAINER
- OPTIONS说明：
- -f : 跟踪日志输出；
- --since :显示某个开始时间的所有日志；
- -t : 显示时间戳；
- --tail :仅列出最新N条容器日志；
- 实例：
# 跟踪查看容器mynginx的日志输出。
$ docker logs -f mynginx
# 查看容器mynginx从2016年7月1日后的最新10条日志。
$ docker logs --since="2016-07-01" --tail=10 mynginx
wait：阻塞运行直到容器停止，然后打印出它的退出代码
- 语法：
docker wait [OPTIONS] CONTAINER [CONTAINER...]
- 实例：
$ docker wait CONTAINER
export：将文件系统作为一个tar归档文件导出到STDOUT
- 语法：
docker export [OPTIONS] CONTAINER
- OPTIONS说明：
- 实例：
# 将id为a404c6c174a2的容器按日期保存为tar文件。
$ docker export -o mysql-`date +%Y%m%d`.tar a404c6c174a2
$ ls mysql-`date +%Y%m%d`.tar
port：列出指定的容器的端口映射，或者查找将PRIVATE_PORT NAT到面向公众的端口
- 语法：
docker port [OPTIONS] CONTAINER [PRIVATE_PORT[/PROTO]]
- 实例：
# 查看容器mynginx的端口映射情况
$ docker port mymysql
3.3 容器rootfs命令
commit：从容器创建一个新的镜像
- 语法：
docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]
- OPTIONS说明：
- -a :提交的镜像作者；
- -c :使用Dockerfile指令来创建镜像；
- -m :提交时的说明文字；
- -p :在commit时，将容器暂停。
- 实例：
# 将容器a404c6c174a2 保存为新的镜像,并添加提交人信息和说明信息。
$ docker commit -a "runoob.com" -m "my apache" a404c6c174a2 mymysql:v1
sha256:37af1236adef1544e8886be23010b66577647a40bc02c0885a6600b33ee28057
$ docker images mymysql:v1
cp：用于容器与主机之间的数据拷贝
# 注意 : 前为拷贝对象， : 后为拷贝到的对象
$ docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH|-
$ docker cp [OPTIONS] SRC_PATH|- CONTAINER:DEST_PATH
# 将主机/www/runoob目录拷贝到容器96f7f14e99ab的/www目录下。
$ docker cp /www/runoob 96f7f14e99ab:/www/
# 将主机/www/runoob目录拷贝到容器96f7f14e99ab中，目录重命名为www。
$ docker cp /www/runoob 96f7f14e99ab:/www
# 将容器96f7f14e99ab的/www目录拷贝到主机的/tmp目录中。
$ docker cp 96f7f14e99ab:/www /tmp/
diff：检查容器里文件结构的更改
- 语法：
docker diff [OPTIONS] CONTAINER
- 实例：
# 查看容器mymysql的文件结构更改。
$ docker diff mymysql
3.4 镜像仓库
login/logout：登陆/退出到一个Docker镜像仓库，如果未指定镜像仓库地址，默认为官方仓库 Docker Hub
- 语法：
docker login/logout [OPTIONS] [SERVER]
- OPTIONS说明：
- 实例：
# 登陆到Docker Hub
$ docker login -u 用户名 -p 密码
# 登出Docker Hub
$ docker logout
pull：从镜像仓库中拉取或者更新指定镜像
- 语法：
docker pull [OPTIONS] NAME[:TAG|@DIGEST]
- OPTIONS说明：
- -a :拉取所有 tagged 镜像
- --disable-content-trust :忽略镜像的校验,默认开启
- 实例：
# 从Docker Hub下载java最新版镜像。
$ docker pull java
push：将本地的镜像上传到镜像仓库,要先登陆到镜像仓库
- 语法：
docker push [OPTIONS] NAME[:TAG]
- OPTIONS说明：
- --disable-content-trust :忽略镜像的校验,默认开启
- 实例：
# 上传本地镜像myapache:v1到镜像仓库中。
$ docker push myapache:v1
search：从Docker Hub查找镜像
- 语法：
docker search [OPTIONS] TERM
- OPTIONS说明：
- --automated :只列出 automated build类型的镜像；
- --no-trunc :显示完整的镜像描述；
- -s :列出收藏数不小于指定值的镜像；
- 实例：
# 从Docker Hub查找所有镜像名包含java，并且收藏数大于10的镜像
$ docker search -s 10 java
3.5 本地镜像管理
images：列出本地镜像
- 语法：
docker
- OPTIONS说明：
- -a :列出本地所有的镜像（含中间映像层，默认情况下，过滤掉中间映像层）；
- --digests :显示镜像的摘要信息；
- -f :显示满足条件的镜像；
- --format :指定返回值的模板文件；
- --no-trunc :显示完整的镜像信息；
- -q :只显示镜像ID；
- 实例：
# 查看本地镜像列表。
$ docker images
# 列出本地镜像中REPOSITORY为ubuntu的镜像列表。
$ docker images ubuntu
rmi：删除本地一个或多少镜像
- 语法：
docker rmi [OPTIONS] IMAGE [IMAGE...]
- OPTIONS说明：
- -f :强制删除；
- --no-prune :不移除该镜像的过程镜像，默认移除；
- 实例：
# 强制删除本地镜像 runoob/ubuntu:v4
$ docker rmi -f runoob/ubuntu:v4
tag：标记本地镜像，将其归入某一仓库
- 语法：
docker tag [OPTIONS] IMAGE[:TAG] [REGISTRYHOST/][USERNAME/]NAME[:TAG]
- OPTIONS说明：
- 实例：
# 将镜像ubuntu:15.10标记为 runoob/ubuntu:v3 镜像。
$ docker tag ubuntu:15.10 runoob/ubuntu:v3
build：用于使用 Dockerfile 创建镜像
- 语法：
docker build [OPTIONS] PATH | URL | -
- OPTIONS说明：
- --build-arg=[] :设置镜像创建时的变量；
- --cpu-shares :设置 cpu 使用权重；
- --cpu-period :限制 CPU CFS周期；
- --cpu-quota :限制 CPU CFS配额；
- --cpuset-cpus :指定使用的CPU id；
- --cpuset-mems :指定使用的内存 id；
- --disable-content-trust :忽略校验，默认开启；
- -f :指定要使用的Dockerfile路径；
- --force-rm :设置镜像过程中删除中间容器；
- --isolation :使用容器隔离技术；
- --label=[] :设置镜像使用的元数据；
- -m :设置内存最大值；
- --memory-swap :设置Swap的最大值为内存+swap，"-1"表示不限swap；
- --no-cache :创建镜像的过程不使用缓存；
- --pull :尝试去更新镜像的新版本；
- --quiet, -q :安静模式，成功后只输出镜像 ID；
- --rm :设置镜像成功后删除中间容器；
- --shm-size :设置/dev/shm的大小，默认值是64M；
- --ulimit :Ulimit配置；
- --tag, -t: 镜像的名字及标签，通常 name:tag 或者 name 格式；可以在一次构建中为一个镜像设置多个标签；
- --network: 默认 default。在构建期间设置RUN指令的网络模式；
- 实例：
# 使用当前目录的 Dockerfile 创建镜像，标签为 runoob/ubuntu:v1
$ docker build -t runoob/ubuntu:v1 .
# 使用URL github.com/creack/docker-firefox 的 Dockerfile 创建镜像
$ docker build github.com/creack/docker-firefox
# 可以通过 -f Dockerfile 文件的位置：
$ docker build -f /path/to/a/Dockerfile .
# 在 Docker 守护进程执行 Dockerfile 中的指令前，首先会对 Dockerfile 进行语法检查，有语法错误时会返回
$ docker build -t test/myapp .
history：查看指定镜像的创建历史
- 语法：
docker history [OPTIONS] IMAGE
- OPTIONS说明：
- -H :以可读的格式打印镜像大小和日期，默认为true；
- --no-trunc :显示完整的提交记录；
- -q :仅列出提交记录ID；
- 实例：
# 查看本地镜像runoob/ubuntu:v3的创建历史
$ docker history runoob/ubuntu:v3
save：将指定镜像保存成 tar 归档文件
- 语法：
docker save [OPTIONS] IMAGE [IMAGE...]
- OPTIONS说明：
- 实例：
# 将镜像 runoob/ubuntu:v3 生成 my_ubuntu_v3.tar 文档
$ docker save -o my_ubuntu_v3.tar runoob/ubuntu:v3
$ ll my_ubuntu_v3.tar
load：导入使用 docker save 命令导出的镜像
- 语法：
docker load [OPTIONS]
- OPTIONS说明：
- 实例：
# 导入镜像：
$ docker load -i ubuntu.tar
$ docker load < ubuntu.tar
import：从归档文件中创建镜像
- 语法：
docker import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]
- OPTIONS说明：
- -c :应用docker 指令创建镜像；
- -m :提交时的说明文字；
- 实例：
# 从镜像归档文件my_ubuntu_v3.tar创建镜像，命名为runoob/ubuntu:v4
$ docker import my_ubuntu_v3.tar runoob/ubuntu:v4
sha256:63ce4a6d6bc3fabb95dbd6c561404a309b7bdfc4e21c1d59fe9fe4299cbfea39
$ docker images runoob/ubuntu:v4
3.6 info|version
info：显示 Docker 系统信息，包括镜像和容器数
- 语法：
docker info [OPTIONS]
- OPTIONS说明：
- 实例：
# 查看docker系统信息。
$ docker info
version：显示 Docker 版本信息
- 语法：
docker version [OPTIONS]
- OPTIONS说明：
- 实例：
# 显示 Docker 版本信息
$ docker version
系列链接
- Docker学习(一)——基础知识
- Docker学习(二)——实例
- Docker学习(三)——命令汇总
