Docker学习(三)——命令汇总

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说明：
  • -s :向容器发送一个信号
• 实例：

$ 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...]

• OPTIONS说明：
• 实例：

# 暂停数据库容器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说明：
  • -o :将输入内容写到文件；
• 实例：

# 将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

• OPTIONS说明：
  • -L :保持源目标中的链接
• 实例：

# 将主机/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说明：
  • -u :登陆的用户名
  • -p :登陆的密码
• 实例：

# 登陆到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说明：
  • -o :输出到的文件；
• 实例：

# 将镜像 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说明：
  • -i :指定导出的文件；
  • -q :精简输出信息；
• 实例：

# 导入镜像：
$ 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说明：
  • -f :指定返回值的模板文件
• 实例：

# 显示 Docker 版本信息
$ docker version

系列链接

1. Docker学习(一)——基础知识
2. Docker学习(二)——实例
3. Docker学习(三)——命令汇总