Docker常用命令介绍

本文记录了一些docker的常用命令。

一容器生命周期管理

1. run

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

OPTIONS说明

-a stdin: 指定标准输入输出内容类型，可选 STDIN/STDOUT/STDERR 三项；

-d: 后台运行容器，并返回容器ID；

-i: 以交互模式运行容器，通常与 -t 同时使用；

-P: 随机端口映射，容器内部端口随机映射到主机的高端口

-p: 指定端口映射，格式为：主机(宿主)端口:容器端口

-t: 为容器重新分配一个伪输入终端，通常与 -i 同时使用；

--restart=always：容器的重启策略，always表示在容器退出时总是重启容器

--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 run -d -p 9000:9000 \
--restart=always \
-v /var/run/docker.sock:/var/run/docker.sock \
--name portainer_20200108 \
portainer/portainer

2. start/stop/restart

1
2
3

$ docker start [OPTIONS] CONTAINER [CONTAINER...]
$ docker stop [OPTIONS] CONTAINER [CONTAINER...]
$ docker restart [OPTIONS] CONTAINER [CONTAINER...]

3. kill

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

示例

1	$ docker kill -s KILL mynginx # 杀掉运行中的容器mynginx

4. rm

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

OPTIONS说明

-f :通过 SIGKILL 信号强制删除一个运行中的容器。

-l :移除容器间的网络连接，而非容器本身。

-v :删除与容器关联的卷。

示例

1 2	$ docker rm db1 db2 # 删除db1、db2容器 $ docker rm `docker ps -a -q` # 删除所有容器

5. pause/unpause

1 2	$ docker pause [OPTIONS] CONTAINER [CONTAINER...] # 暂停容器中所有的进程 $ docker unpause [OPTIONS] CONTAINER [CONTAINER...] # 恢复容器中所有的进程

6. create

1	$ docker create [OPTIONS] IMAGE [COMMAND] [ARG...] # 创建一个新的容器但不启动它

示例

1 2	# 使用docker镜像nginx:latest创建一个容器,并将容器命名为myrunoob $ docker create --name myrunoob nginx:latest

7. exec

1	$ docker exec [OPTIONS] CONTAINER COMMAND [ARG...] # 在运行的容器中执行命令

OPTIONS说明

-d :分离模式: 在后台运行

-i :即使没有附加也保持STDIN 打开

-t :分配一个伪终端

示例

# 在容器 mynginx 中以交互模式执行容器内 /root/runoob.sh 脚本
$ docker exec -it mynginx /bin/sh /root/runoob.sh

# 在容器 mynginx 中开启一个交互模式的终端
$ docker exec -i -t  mynginx /bin/bash

# 通过 exec 命令对指定的容器执行 bash
$ docker exec -it 9df70f9a0714 /bin/bash

二容器操作

1. ps

1	$ docker ps [OPTIONS] # 列出容器

OPTIONS说明

a :显示所有的容器，包括未运行的。

-f :根据条件过滤显示的内容。

--format :指定返回值的模板文件。

-l :显示最近创建的容器。

-n :列出最近创建的n个容器。

--no-trunc :不截断输出。

-q :静默模式，只显示容器编号。

-s :显示总的文件大小。

示例

$ docker ps # 列出所有在运行的容器信息

# 输出详情介绍
CONTAINER ID: 容器 ID。
IMAGE: 使用的镜像。
COMMAND: 启动容器时运行的命令。
CREATED: 容器的创建时间。
STATUS: 容器状态。
    状态有7种：
    created（已创建）
    restarting（重启中）
    running（运行中）
    removing（迁移中）
    paused（暂停）
    exited（停止）
    dead（死亡）
PORTS: 容器的端口信息和使用的连接类型（tcp\udp）。
NAMES: 自动分配的容器名称。

$ docker ps -n 5  # 列出最近创建的5个容器信息
$ docker ps -a -q  # 列出所有创建的容器ID

2. inspect

1	$ docker inspect [OPTIONS] NAME\|ID [NAME\|ID...] # 获取容器/镜像的元数据

OPTIONS说明

-f :指定返回值的模板文件。

-s :显示总的文件大小。

--type :为指定类型返回JSON。

示例

1 2	$ docker inspect mysql:5.6 # 获取镜像mysql:5.6的元信息 $ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' mymysql # 获取正在运行的容器mymysql的IP

3. top

$ docker top [OPTIONS] CONTAINER [ps OPTIONS]  # 查看容器中运行的进程信息，支持 ps 命令参数
# 容器运行时不一定有/bin/bash终端来交互执行top命令，而且容器还不一定有top命令，可以使用docker top来实现查看container中正在运行的进程。

$ docker top mymysql  # 查看容器mymysql的进程信息

# 查看所有运行容器的进程信息
for i in  `docker ps |grep Up|awk '{print $1}'`;do echo \ &&docker top $i; done

4. attach

1
2

$ docker attach [OPTIONS] CONTAINER
# 要attach上去的容器必须正在运行，可以同时连接上同一个container来共享屏幕（与screen命令的attach类似）。官方文档中说attach后可以通过CTRL-C来detach，但实际上经过我的测试，如果container当前在运行bash，CTRL-C自然是当前行的输入，没有退出；如果container当前正在前台运行进程，如输出nginx的access.log日志，CTRL-C不仅会导致退出容器，而且还stop了。这不是我们想要的，detach的意思按理应该是脱离容器终端，但容器依然运行。好在attach是可以带上--sig-proxy=false来确保CTRL-D或CTRL-C不会关闭容器。

示例

1 2	# 容器mynginx将访问日志指到标准输出，连接到容器查看访问信息 $ docker attach --sig-proxy=false mynginx

5. enents

1	$ docker events [OPTIONS] # 从服务器获取实时事件

OPTIONS说明

-f ：根据条件过滤事件；

--since ：从指定的时间戳后显示所有事件;

--until ：流水时间显示到指定的时间为止；

示例

1
2
3

$ docker events --since="1467302400"  # 显示docker 2016年7月1日后的所有事件
$ docker events -f "image"="mysql:5.6" --since="1467302400"  # 显示docker 镜像为mysql:5.6 2016年7月1日后的相关事件
# 如果指定的时间是到秒级的，需要将时间转成时间戳。如果时间为日期的话，可以直接使用，如--since="2016-07-01"

6. logs

1	$ docker logs [OPTIONS] CONTAINER # 获取容器的日志

OPTIONS说明

-f : 跟踪日志输出

--since :显示某个开始时间的所有日志

-t : 显示时间戳

--tail :仅列出最新N条容器日志

示例

1 2	$ docker logs -f mynginx # 跟踪查看容器mynginx的日志输出 $ docker logs --since="2016-07-01" --tail=10 mynginx # 查看容器mynginx从2016年7月1日后的最新10条日志

7. wait

1	$ docker wait [OPTIONS] CONTAINER [CONTAINER...] # 阻塞运行直到容器停止，然后打印出它的退出代码

8. export

1	$ docker export [OPTIONS] CONTAINER # 将文件系统作为一个tar归档文件导出到STDOUT

OPTIONS说明

1	-o :将输入内容写到文件

示例

1	$ docker export -o mysql-`date +%Y%m%d`.tar a404c6c174a2 # 将id为a404c6c174a2的容器按日期保存为tar文件

9. port

1 2	# 列出指定的容器的端口映射，或者查找将PRIVATE_PORT NAT到面向公众的端口 $ docker port [OPTIONS] CONTAINER [PRIVATE_PORT[/PROTO]]

示例

1	$ docker port mymysql # 查看容器mynginx的端口映射情况

三容器rootfs命令

1. commit

1	$ docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]] # 从容器创建一个新的镜像

OPTIONS说明

-a :提交的镜像作者；

-c :使用Dockerfile指令来创建镜像；

-m :提交时的说明文字；

-p :在commit时，将容器暂停。

示例

1 2	# 将容器a404c6c174a2 保存为新的镜像,并添加提交人信息和说明信息 $ docker commit -a "runoob.com" -m "my apache" a404c6c174a2 mymysql:v1

2. cp

1
2
3

# 用于容器与主机之间的数据拷贝
$ docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH|-
$ docker cp [OPTIONS] SRC_PATH|- CONTAINER:DEST_PATH

OPTIONS说明

1	-L :保持源目标中的链接

示例

1
2
3

$ docker cp /www/runoob 96f7f14e99ab:/www/  # 将主机/www/runoob目录拷贝到容器96f7f14e99ab的/www目录下
$ docker cp /www/runoob 96f7f14e99ab:/www   # 将主机/www/runoob目录拷贝到容器96f7f14e99ab中，目录重命名为www
$ docker cp  96f7f14e99ab:/www /tmp/   # 将容器96f7f14e99ab的/www目录拷贝到主机的/tmp目录中

3. diff

1	$ docker diff [OPTIONS] CONTAINER # 检查容器里文件结构的更改

四镜像仓库

1
2

$ docker login [OPTIONS] [SERVER] # 登陆到一个Docker镜像仓库，如果未指定镜像仓库地址，默认为官方仓库 Docker Hub
$ docker logout [OPTIONS] [SERVER] # 登出一个Docker镜像仓库，如果未指定镜像仓库地址，默认为官方仓库 Docker Hub

OPTIONS说明

1
2
3

-u :登陆的用户名

-p :登陆的密码

示例

1 2	$ docker login -u 用户名 -p 密码 # 登陆到Docker Hub $ docker logout # 登出Docker Hub

2. pull

1	$ docker pull [OPTIONS] NAME[:TAG\|@DIGEST] # 从镜像仓库中拉取或者更新指定镜像

OPTIONS说明

1
2
3

-a :拉取所有 tagged 镜像

--disable-content-trust :忽略镜像的校验,默认开启

示例

1 2	$ docker pull java # 从Docker Hub下载java最新版镜像 $ docker pull -a java # 从Docker Hub下载REPOSITORY为java的所有镜像

3. push

1	$ docker push [OPTIONS] NAME[:TAG] # 将本地的镜像上传到镜像仓库,要先登陆到镜像仓库

OPTIONS说明

1	--disable-content-trust :忽略镜像的校验,默认开启

4. search

1	$ docker search [OPTIONS] TERM # 从Docker Hub查找镜像

OPTIONS说明

--automated :只列出 automated build类型的镜像；

--no-trunc :显示完整的镜像描述；

-s :列出收藏数不小于指定值的镜像。

示例

$ docker search -s 10 java  # 从Docker Hub查找所有镜像名包含java，并且收藏数大于10的镜像
结果参数说明：
NAME: 镜像仓库源的名称
DESCRIPTION: 镜像的描述
OFFICIAL: 是否 docker 官方发布
stars: 类似 Github 里面的 star，表示点赞、喜欢的意思。
AUTOMATED: 自动构建。

五本地镜像管理

1. images

1	$ docker images [OPTIONS] [REPOSITORY[:TAG]] # 列出本地镜像

OPTIONS说明

-a :列出本地所有的镜像（含中间映像层，默认情况下，过滤掉中间映像层）；

--digests :显示镜像的摘要信息；

-f :显示满足条件的镜像；

--format :指定返回值的模板文件；

--no-trunc :显示完整的镜像信息；

-q :只显示镜像ID。

示例

1	$ docker images ubuntu # 列出本地镜像中REPOSITORY为ubuntu的镜像列表

2. rmi

1	$ docker rmi [OPTIONS] IMAGE [IMAGE...] # 删除本地一个或多少镜像

OPTIONS说明

1
2
3

-f :强制删除；

--no-prune :不移除该镜像的过程镜像，默认移除；

示例

1	$ docker rmi -f runoob/ubuntu:v4 # 强制删除本地镜像 runoob/ubuntu:v4

附录 docker prune 命令

prune 命令用来删除不再使用的 docker 对象。

删除所有未被 tag 标记和未被容器使用的镜像：

1
2
3

$ docker image prune 
WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N] y

删除所有未被容器使用的镜像:

1	$ docker image prune -a

删除所有停止运行的容器:

1	$ docker container prune

删除所有未被挂载的卷:

1	$ docker volume prune

删除所有网络:

1	$ docker network prune

删除 docker 所有资源:

1	$ docker system prune

3. tag

1 2	# 标记本地镜像，将其归入某一仓库 $ docker tag [OPTIONS] IMAGE[:TAG] [REGISTRYHOST/][USERNAME/]NAME[:TAG]

示例

1	$ docker tag ubuntu:15.10 runoob/ubuntu:v3 # 将镜像ubuntu:15.10标记为 runoob/ubuntu:v3 镜像

4. build

1	$ docker build [OPTIONS] PATH \| URL \| - # 命令用于使用 Dockerfile 创建镜像

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 .
Sending build context to Docker daemon 2.048 kB
Error response from daemon: Unknown instruction: RUNCMD

5. history

1	$ docker history [OPTIONS] IMAGE # 查看指定镜像的创建历史

OPTIONS说明

-H :以可读的格式打印镜像大小和日期，默认为true；

--no-trunc :显示完整的提交记录；

-q :仅列出提交记录ID。

示例

1	$ docker history runoob/ubuntu:v3 # 查看本地镜像runoob/ubuntu:v3的创建历史

6. save

1	$ docker save [OPTIONS] IMAGE [IMAGE...] # 将指定镜像保存成 tar 归档文件

OPTIONS 说明

1	-o :输出到的文件

示例

# 将镜像 runoob/ubuntu:v3 生成 my_ubuntu_v3.tar 文档
$ docker save -o my_ubuntu_v3.tar runoob/ubuntu:v3  
$ ll my_ubuntu_v3.tar
-rw------- 1 runoob runoob 142102016 Jul 11 01:37 my_ubuntu_v3.ta

7. load

1	$ docker load [OPTIONS] # 导入使用 docker save 命令导出的镜像

OPTIONS 说明

1
2
3

--input , -i : 指定导入的文件，代替 STDIN。

--quiet , -q : 精简输出信息。

示例

$ docker load < busybox.tar.gz
Loaded image: busybox:latest

$ docker load --input fedora.tar
Loaded image: fedora:rawhide
Loaded image: fedora:20

8. import

1	$ docker import [OPTIONS] file\|URL\|- [REPOSITORY[:TAG]] # 从归档文件中创建镜像

OPTIONS说明

1
2
3

-c :应用docker 指令创建镜像；

-m :提交时的说明文字；

示例

1 2	# 从镜像归档文件my_ubuntu_v3.tar创建镜像，命名为runoob/ubuntu:v4 $ docker import my_ubuntu_v3.tar runoob/ubuntu:v4

六 docker基本信息

1. info

1	$ docker info # 显示 Docker 系统信息，包括镜像和容器数

2. version

1	$ docker version [OPTIONS] # 查看docker版本信息

OPTIONS说明

1	-f : 指定返回值的模板文件

一 容器生命周期管理

1. run

2. start/stop/restart

3. kill

4. rm

5. pause/unpause

6. create

7. exec

二 容器操作

1. ps

2. inspect

3. top

4. attach

5. enents

6. logs

7. wait

8. export

9. port

三 容器rootfs命令

1. commit

2. cp

3. diff

四 镜像仓库

1. login/logout

2. pull

3. push

4. search

五 本地镜像管理

1. images

2. rmi

3. tag

4. build

5. history

6. save

7. load

8. import

六 docker基本信息

1. info

2. version

一容器生命周期管理

二容器操作

三容器rootfs命令

四镜像仓库

五本地镜像管理