一卓的博客

怕什么真理无穷，
进一寸有一寸的欢喜。

0%

Docker 常用命令整理

发表于 阅读次数： Valine： 12k 11 分钟

显示版本信息 docker version

docker version :显示 Docker 版本信息。

语法

1
docker version [OPTIONS]

显示 Docker 系统信息 docker info

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

语法

1
docker info [OPTIONS]

docker search : 从 Docker Hub 查找镜像

语法

1
docker search [OPTIONS] TERM

OPTIONS 说明：

  • –automated :只列出 automated build类型的镜像；
  • –no-trunc :显示完整的镜像描述；
  • –filter=stars=:列出收藏数不小于指定值的镜像。

实例

从 Docker Hub 查找所有镜像名包含 hello-world，并且收藏数大于 1000 的镜像

hello-world 是 Docker 官方提供的一个镜像，通常用来验证 Docker 是否安装成功。

1
2
3
➜  ~ docker search --filter=stars=1000 hello-world
NAME                DESCRIPTION                                     STARS               OFFICIAL            AUTOMATED
hello-world         Hello World! (an example of minimal Dockeriz…   1278                [OK]

下载或更新镜像 docker pull

docker pull : 从镜像仓库中拉取或者更新指定镜像

语法

1
docker pull [OPTIONS] NAME[:TAG|@DIGEST]

OPTIONS 说明：

  • -a :拉取所有 tagged 镜像
  • –disable-content-trust :忽略镜像的校验,默认开启

实例

从 Docker Hub下载 hello-world 最新版镜像。

1
2
3
4
5
6
7
➜  ~ docker pull hello-world
Using default tag: latest
latest: Pulling from library/hello-world
0e03bdcc26d7: Pull complete
Digest: sha256:7f0a9f93b4aa3022c3a4c147a449bf11e0941a1fd0bf4a8e6c9408b2600777c5
Status: Downloaded newer image for hello-world:latest
docker.io/library/hello-world:latest

查看已下载的镜像 docker images

docker images : 列出本地镜像。

语法

1
docker images [OPTIONS] [REPOSITORY[:TAG]]

OPTIONS 说明：

  • -a :列出本地所有的镜像（含中间映像层，默认情况下，过滤掉中间映像层）；
  • –digests :显示镜像的摘要信息；
  • -f :显示满足条件的镜像；
  • –format :指定返回值的模板文件；
  • –no-trunc :显示完整的镜像信息；
  • -q :只显示镜像ID。

实例

查看本地镜像列表。

1
2
3
4
5
➜  ~ docker images
REPOSITORY                                             TAG                 IMAGE ID            CREATED             SIZE
redis                                                  latest              235592615444        2 months ago        104MB
nginx                                                  latest              2622e6cca7eb        2 months ago        132MB
hello-world                                            latest              bf756fb1ae65        7 months ago        13.3kB

列出本地镜像中 REPOSITORY 为 nginx 的镜像列表。

1
2
3
➜  ~ docker images nginx
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
nginx               latest              2622e6cca7eb        2 months ago        132MB

删除镜像 docker rmi

docker rmi : 删除本地一个或多少镜像。

语法

1
docker rmi [OPTIONS] IMAGE [IMAGE...]

OPTIONS说明：

  • -f :强制删除；
  • –no-prune :不移除该镜像的过程镜像，默认移除；

实例

强制删除本地镜像 hello-world。

1
2
3
4
➜  ~ docker rmi -f hello-world
Untagged: hello-world:latest
Untagged: hello-world@sha256:7f0a9f93b4aa3022c3a4c147a449bf11e0941a1fd0bf4a8e6c9408b2600777c5
Deleted: sha256:bf756fb1ae65adf866bd8c456593cd24beb6a0a061dedf42b26a993176745f6b

如果本地有多个 IMAGE ID 相同的镜像，可以通过 docker rmi [REPOSITORY]:[TAG] 来删除

如下

1
2
3
4
5
6
➜  ~ docker images
REPOSITORY                                             TAG                 IMAGE ID            CREATED             SIZE
zhuyizhuo/hello-world                                  v1                  c1004e8ed398        3 hours ago         105MB
hello-world                                            latest              c1004e8ed398        2 months ago        105MB
➜  ~ docker rmi zhuyizhuo/hello-world:v1
Untagged: zhuyizhuo/hello-world:v1

删除容器 docker rm

docker rm ：删除一个或多个容器

语法

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

OPTIONS说明：

  • -f :通过SIGKILL信号强制删除一个运行中的容器
  • -l :移除容器间的网络连接，而非容器本身
  • -v :-v 删除与容器关联的卷

实例

强制删除容器 mynginx

1
docker rm -f mynginx

运行镜像 docker run

docker run ：创建一个新的容器并运行一个命令

语法

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

OPTIONS说明：

  • -a stdin: 指定标准输入输出内容类型，可选 STDIN/STDOUT/STDERR 三项；
  • -d: 后台运行容器，并返回容器ID；
  • -i: 以交互模式运行容器，通常与 -t 同时使用；
  • -p: 端口映射，格式为：主机(宿主)端口:容器端口；
  • -v: 挂载一个目录或者一个已存在的数据卷容器，可以直接使用 [HOST:CONTAINER] 格式，或者使用[HOST:CONTAINER:ro] 格式，后者对于容器来说，数据卷是只读的，可以有效保护宿主机的文件系统。
  • -t: 为容器重新分配一个伪输入终端，通常与 -i 同时使用；
  • –name=: 为容器指定一个名称；
  • –dns 8.8.8.8: 指定容器使用的DNS服务器，默认和宿主一致；
  • –dns-search example.com: 指定容器DNS搜索域名，默认和宿主一致；
  • -h: 指定容器的 hostname；
  • -e: 设置环境变量；
  • –env: 设置环境变量；
  • –env-file=[]: 从指定文件读入环境变量；
  • –cpuset=”0-2” or –cpuset=”0,1,2”: 绑定容器到指定CPU运行；
  • -m :设置容器使用内存最大值；
  • –net=”bridge”: 指定容器的网络连接类型，支持 bridge/host/none/container: 四种类型；
  • –link=[]: 添加链接到另一个容器；
  • –expose=[]: 开放一个端口或一组端口；

实例

使用 docker 镜像 nginx:latest 以后台模式启动一个容器,并将容器命名为 mynginx。

1
docker run --name mynginx -d nginx:latest

使用镜像 nginx:latest，以后台模式启动一个容器,将容器的 80 端口映射到主机的 80 端口,主机的目录 /Users/zhuo/logs 映射到容器的 /logs。

1
2
➜  ~ docker run -p 80:80 -v /Users/zhuo/logs:/logs -d nginx:latest
d200a19a4e87ee5e8367aad121538b872151ed2c799646f5aae1e516d05345c2

使用镜像 nginx:latest 以交互模式启动一个容器,在容器内执行 /bin/bash 命令。

1
2
➜  ~ docker run -it nginx:latest /bin/bash
root@51363b25e1a4:/#

使用远程 registry.cn-hangzhou.aliyuncs.com/log-service/logtail 镜像启动容器，挂载根目录到 /logtail_host（只读模式） 挂载 /var/run 目录到容器的 /var/run 目录，设置环境变量

1
docker run -d -v /:/logtail_host:ro -v /var/run:/var/run --env ALIYUN_LOGTAIL_CONFIG=/etc/ilogtail/conf/demo/ilogtail_config.json  registry.cn-hangzhou.aliyuncs.com/log-service/logtail

创建镜像 docker build

docker build 命令用于使用 Dockerfile 创建镜像。

语法

1
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；
  • –tag, -t: 镜像的名字及标签，通常 name:tag 或者 name 格式；可以在一次构建中为一个镜像设置多个标签。
  • –network: 默认 default。在构建期间设置RUN指令的网络模式

实例

使用当前目录的 Dockerfile 创建镜像，标签为 hello-world。

1
2
3
4
5
6
7
8
9
10
11
➜  ~ docker build -t hello-world .
Sending build context to Docker daemon  2.048kB
Step 1/2 : FROM openjdk:8-jdk-alpine
 ---> a3562aa0b991
Step 2/2 : RUN echo 'hello world.'
 ---> Running in 97b643c912bc
hello world.
Removing intermediate container 97b643c912bc
 ---> c1004e8ed398
Successfully built c1004e8ed398
Successfully tagged hello-world:latest

在 Docker 守护进程执行 Dockerfile 中的指令前，首先会对 Dockerfile 进行语法检查，有语法错误时会返回错误信息

列出容器 docker ps

docker ps : 列出容器

语法

1
docker ps [OPTIONS]

OPTIONS说明：

  • -a :显示所有的容器，包括未运行的。
  • -f :根据条件过滤显示的内容。
  • –format :指定返回值的模板文件。
  • -l :显示最近创建的容器。
  • -n :列出最近创建的n个容器。
  • –no-trunc :不截断输出。
  • -q :静默模式，只显示容器编号。
  • -s :显示总的文件大小。

实例

列出所有在运行的容器信息。

1
2
3
➜  ~ docker ps
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                               NAMES
ab56115efc9e        redis               "docker-entrypoint.s…"   2 days ago          Up 2 days           0.0.0.0:6379->6379/tcp              redis

列出最近创建的5个容器信息。

1
2
3
4
5
6
7
➜  ~ docker ps -n 5
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS                            PORTS                    NAMES
51363b25e1a4        nginx:latest        "/docker-entrypoint.…"   3 minutes ago       Exited (127) About a minute ago                            inspiring_roentgen
d200a19a4e87        nginx:latest        "/docker-entrypoint.…"   10 minutes ago      Exited (0) 6 minutes ago                                   stupefied_curie
b0314e3afbf3        nginx:latest        "/docker-entrypoint.…"   13 minutes ago      Created                                                    charming_babbage
3ddfa2c0733e        bf756fb1ae65        "/hello"                 46 minutes ago      Exited (0) 46 minutes ago                                  gifted_thompson
ab56115efc9e        redis               "docker-entrypoint.s…"   2 days ago          Up 2 days                         0.0.0.0:6379->6379/tcp   redis

容器与主机之间的数据拷贝 复制 docker cp

docker cp :用于容器与主机之间的数据拷贝。

语法

1
2
docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH|-
docker cp [OPTIONS] SRC_PATH|- CONTAINER:DEST_PATH

OPTIONS说明：

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

实例

将主机 /www/test 目录拷贝到容器 8cd821c0fac7 的 /www 目录下。

1
docker cp /www/test 8cd821c0fac7:/www

将容器 8cd821c0fac7 的 /www 目录拷贝到主机的 /tmp 目录中。

1
docker cp  8cd821c0fac7:/www /tmp/

在运行的容器中执行命令 docker exec

docker exec ：在运行的容器中执行命令

语法

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

OPTIONS说明：

  • -d :分离模式: 在后台运行
  • -i :即使没有附加也保持STDIN 打开
  • -t :分配一个伪终端

实例

在容器 mynginx 中以交互模式执行容器内 /root/helloworld.sh 脚本

1
2
➜  ~ docker exec -it mynginx /bin/sh /root/helloworld.sh
hello world

在容器 mynginx 中开启一个交互模式的终端

1
2
➜  ~ docker exec -it mynginx /bin/bash
root@e66c098a5a0d:/#

设置容器自动重启

reboot 后 Docker 服务及容器自动启动设置，已启动容器：

1
docker update --restart=always 8c965ffd0761

获取容器/镜像的元数据 docker inspect

docker inspect : 获取容器/镜像的元数据。

语法

1
docker inspect [OPTIONS] NAME|ID [NAME|ID...]

OPTIONS说明：

  • -f :指定返回值的模板文件。
  • -s :显示总的文件大小。
  • –type :为指定类型返回JSON。

实例

获取镜像 nginx 的元信息。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
➜  ~ docker inspect nginx
[
    {
        "Id": "sha256:2622e6cca7ebbb6e310743abce3fc47335393e79171b9d76ba9d4f446ce7b163",
        "RepoTags": [
            "nginx:latest"
        ],
        "RepoDigests": [
            "nginx@sha256:21f32f6c08406306d822a0e6e8b7dc81f53f336570e852e25fbe1e3e3d0d0133"
        ],
        "Parent": "",
        "Comment": "",
        "Created": "2020-06-09T16:57:42.632836191Z",
        "Container": "53e54c20f21e263548ac09475373e20dfef58dd38aebc6caec258b4ff6c2446c",
        "ContainerConfig": {
            "Hostname": "53e54c20f21e",
            "Domainname": "",
            "User": "",
            "AttachStdin": false,
            "AttachStdout": false,
            "AttachStderr": false,
            "ExposedPorts": {
                "80/tcp": {}
            },
            "Tty": false,
            "OpenStdin": false,
            "StdinOnce": false,
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "NGINX_VERSION=1.19.0",
                "NJS_VERSION=0.4.1",
                "PKG_RELEASE=1~buster"
            ],
            "Cmd": [
                "/bin/sh",
                "-c",
                "#(nop) ",
                "CMD [\"nginx\" \"-g\" \"daemon off;\"]"
            ],
            "ArgsEscaped": true,
            "Image": "sha256:096f75b5300eeb60b7ec16dcf3bcd48abcde14a9a379a96f42d5ffc26fcfdf1b",
            "Volumes": null,
            "WorkingDir": "",
            "Entrypoint": [
                "/docker-entrypoint.sh"
            ],
            "OnBuild": null,
            "Labels": {
                "maintainer": "NGINX Docker Maintainers <docker-maint@nginx.com>"
            },
            "StopSignal": "SIGTERM"
        },
        "DockerVersion": "18.09.7",
        "Author": "",
        "Config": {
            "Hostname": "",
            "Domainname": "",
            "User": "",
            "AttachStdin": false,
            "AttachStdout": false,
            "AttachStderr": false,
            "ExposedPorts": {
                "80/tcp": {}
            },
            "Tty": false,
            "OpenStdin": false,
            "StdinOnce": false,
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "NGINX_VERSION=1.19.0",
                "NJS_VERSION=0.4.1",
                "PKG_RELEASE=1~buster"
            ],
            "Cmd": [
                "nginx",
                "-g",
                "daemon off;"
            ],
            "ArgsEscaped": true,
            "Image": "sha256:096f75b5300eeb60b7ec16dcf3bcd48abcde14a9a379a96f42d5ffc26fcfdf1b",
            "Volumes": null,
            "WorkingDir": "",
            "Entrypoint": [
                "/docker-entrypoint.sh"
            ],
            "OnBuild": null,
            "Labels": {
                "maintainer": "NGINX Docker Maintainers <docker-maint@nginx.com>"
            },
            "StopSignal": "SIGTERM"
        },
        "Architecture": "amd64",
        "Os": "linux",
        "Size": 132122017,
        "VirtualSize": 132122017,
        "GraphDriver": {
            "Data": {
                "LowerDir": "/var/lib/docker/overlay2/a186ce1c7e774439e0d2f1248c882767da3a76ade5aecbf776ca4d24eef9b653/diff:/var/lib/docker/overlay2/f334f37d35f72e5045b141167665d3f1e31025835d51a3b703b7d21e75351394/diff:/var/lib/docker/overlay2/77b46c9a92885bab12ac9feca5df425d6caa34e7cfb80e526a2ce72e61dd13ed/diff:/var/lib/docker/overlay2/b4416b53f656e25aa6ec1e0e3574495d0accdb697d12488c562173b311875a3f/diff",
                "MergedDir": "/var/lib/docker/overlay2/6812b7407448ad5ba84978b9bdff1e078e393ca8d9cb812d1210ac37db16aeed/merged",
                "UpperDir": "/var/lib/docker/overlay2/6812b7407448ad5ba84978b9bdff1e078e393ca8d9cb812d1210ac37db16aeed/diff",
                "WorkDir": "/var/lib/docker/overlay2/6812b7407448ad5ba84978b9bdff1e078e393ca8d9cb812d1210ac37db16aeed/work"
            },
            "Name": "overlay2"
        },
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:13cb14c2acd34e45446a50af25cb05095a17624678dbafbcc9e26086547c1d74",
                "sha256:d4cf327d8ef50eb2e31b646f17217a3baf455391bfd59bce47df50c770ff8c07",
                "sha256:7c7d7f4461826dd22f9234a81f9bed9c0bdb0b70b3ce66228bfc87418a9b8313",
                "sha256:9040af41bb6677b114134de15ddeb10b070eb1f940dbbe277574ee154d89f6b9",
                "sha256:f978b9ed3f26a49b55cf4849e4cadb29335be45a633cbe95a2f4e445e70086bf"
            ]
        },
        "Metadata": {
            "LastTagTime": "0001-01-01T00:00:00Z"
        }
    }
]

登陆/登出命令 docker login/logout

docker login : 登陆到一个 Docker 镜像仓库，如果未指定镜像仓库地址，默认为官方仓库 Docker Hub

docker logout : 登出一个 Docker 镜像仓库，如果未指定镜像仓库地址，默认为官方仓库 Docker Hub

语法

1
2
docker login [OPTIONS] [SERVER]
docker logout [OPTIONS] [SERVER]

OPTIONS说明：

  • -u :登陆的用户名
  • -p :登陆的密码

实例

登陆到 Docker Hub

1
docker login -u 用户名 -p 密码

登出 Docker Hub

1
docker logout

将本地的镜像上传到镜像仓库 docker push

docker push : 将本地的镜像上传到镜像仓库,要先登陆到镜像仓库

语法

1
docker push [OPTIONS] NAME[:TAG]

OPTIONS说明：

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

实例

上传本地镜像 mynginx:v1 到镜像仓库中。

1
docker push mynginx:v1

获取容器日志 docker logs

docker logs : 获取容器的日志

语法

1
docker logs [OPTIONS] CONTAINER

OPTIONS说明：

  • -f : 跟踪日志输出
  • –since :显示某个开始时间的所有日志
  • -t : 显示时间戳
  • –tail :仅列出最新N条容器日志

实例

跟踪查看容器 mynginx 的日志输出。

1
2
3
4
5
6
7
8
9
➜  ~ docker logs -f mynginx
/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
/docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
/docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
10-listen-on-ipv6-by-default.sh: Getting the checksum of /etc/nginx/conf.d/default.conf
10-listen-on-ipv6-by-default.sh: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf
/docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
/docker-entrypoint.sh: Configuration complete; ready for start up
172.17.0.1 - - [29/Aug/2020:14:38:22 +0000] "GET / HTTP/1.1" 304 0 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.135 Safari/537.36" "-"

查看容器 mynginx 的最新 3 条日志。

1
2
3
4
➜  ~ docker logs --tail=3 mynginx
172.17.0.1 - - [29/Aug/2020:14:38:22 +0000] "GET / HTTP/1.1" 304 0 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.135 Safari/537.36" "-"
172.17.0.1 - - [29/Aug/2020:14:38:23 +0000] "GET / HTTP/1.1" 304 0 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.135 Safari/537.36" "-"
172.17.0.1 - - [29/Aug/2020:14:38:23 +0000] "GET / HTTP/1.1" 304 0 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.135 Safari/537.36" "-"

列出指定的容器的端口映射 docker port

docker port :列出指定的容器的端口映射，或者查找将PRIVATE_PORT NAT到面向公众的端口。

语法

1
docker port [OPTIONS] CONTAINER [PRIVATE_PORT[/PROTO]]

实例

查看容器 mynginx 的端口映射情况。

1
2
➜  ~ docker port mynginx
80/tcp -> 0.0.0.0:80

查看容器中运行的进程信息 docker top

docker top :查看容器中运行的进程信息，支持 ps 命令参数。

语法

1
docker top [OPTIONS] CONTAINER [ps OPTIONS]

容器运行时不一定有/bin/bash 终端来交互执行 top 命令，而且容器还不一定有 top 命令，可以使用 docker top 来实现查看 container 中正在运行的进程。

实例

查看容器 mynginx 的进程信息

1
2
3
4
➜  ~ docker top mynginx
PID                 USER                TIME                COMMAND
4571                root                0:00                nginx: master process nginx -g daemon off;
4626                101                 0:00                nginx: worker process
请作者喝杯咖啡吧