Docker 官网 :https://www.docker.com/
Docker Hub:https://registry.hub.docker.com/search?q=kali
Docker 容器超详细讲解:https://www.linuxidc.com/Linux/2018-08/153712.htm
Docker Compose:https://www.runoob.com/docker/docker-compose.html
菜鸟教程 — Docker 教程:http://www.runoob.com/docker/docker-tutorial.html
W3school Docker 教程:https://www.w3cschool.cn/docker/
Docker教程:Docker入门实践(精讲版):http://c.biancheng.net/docker/
github 地址:https://github.com/yeasy/docker_practice
一、Docker 简介
Docker 是一个开源的应用容器引擎,基于 Go 语言 并遵从 Apache2.0 协议开源。
Docker 可以让开发者打包他们的应用以及依赖包到一个轻量级、可移植的容器中,然后发布到任何流行的 Linux 机器上,也可以实现虚拟化。
容器是完全使用沙箱机制,相互之间不会有任何接口(类似 iPhone 的 app),更重要的是容器性能开销极低。
Docker 从 17.03 版本之后分为 CE(Community Edition: 社区版) 和 EE(Enterprise Edition: 企业版)
docker容器可以理解为在沙盒中运行的进程。这个沙盒包含了该进程运行所必须的资源,包括文件系统、系统类库、shell 环境等等。但这个沙盒默认是不会运行任何程序的。你需要在沙盒中运行一个进程来启动某一个容器。这个进程是该容器的唯一进程,所以当该进程结束的时候,容器也会完全的停止。
Docker 引擎
Docker 引擎是一个 c/s 结构的应用,主要组件见下图:
- Server :是一个一直运行的后台守护进程(dockerd)。
- REST API :应用程序通过REST API与后台进程通信,执行相应的指令。实现了 client 和server 间的交互协议
- Client :客户端是一个命令行接口(docker)。CLI 实现容器和镜像的管理,为用户提供统一的操作界面
Docker CLI Client 通过脚本或 CLI 命令 通过 REST API 与 Docker Server 守护进程交互。Docker Server 负责创建和管理 Docker 对象,如 images,containers,networks 和 volumes。
Docker 构架
Docker 使用 C/S 架构,Client 通过接口与 Server 进程通信实现容器的构建,运行和发布。client 和 server 可以运行在同一个系统上,也可以运行在不同的机器上跨主机实现远程通信。
- Docker 客户端 :Docker client 是 Docker 用户与 Docker 交互的主要方式。当用户执行docker run 命令时,客户端会发送这些命令给 dockerd,dockerd 来执行这些命令。docker 的命令通过 Docker API 发送给 dockerd。Docker client 可以与多个守护进程进行通信。
- Docker 守护进程:Docker 守护进程(dockerd)监听 Docker API 请求和管理 Docker 对象,如 images,containers,networks 和 volumes。Docker 守护进程也会与其他守护进程通信来管理 Docker 服务。
- Docker 对象:使用 Docker 时,会创建和使用 images、containers、networks、volumes、plugins 等对象,
核心概念 ( image、container、仓库 )
Docker 镜像 - Docker images、Docker 仓库 - Docker registeries、Docker 容器 - Docker containers
Docker 包括三个基本概念:
- 镜像( Image ):Docker 镜像(Image),就相当于是一个 root 文件系统。比如官方镜像 ubuntu:16.04 就包含了完整的一套 Ubuntu16.04 最小系统的 root 文件系统。
- 容器( Container ):镜像(Image)和容器(Container)的关系,就像是面向对象程序设计中的 类和实例 一样,镜像是静态的定义,容器是镜像运行时的实体。容器是从镜像创建的运行实例,容器可以被创建、启动、停止、删除、暂停等。
- 仓库( Repository ):仓库可看成一个代码控制中心,用来保存镜像。Docker 仓库的概念跟 Git 类似,注册服务器可以理解为 GitHub 这样的托管服务。仓库分为公开仓库(Public)和私有仓库(Private)两种形式。最大的公开仓库是 Docker Hub,存放了数量庞大的镜像供用户下载。国内的公开仓库包括 时速云 、网易云 等,可以提供大陆用户更稳定快速的访问。当然,用户也可以在本地网络内创建一个私有仓库。当用户创建了自己的镜像之后就可以使用 push 命令将它上传到公有或者私有仓库,这样下次在另外一台机器上使用这个镜像时候,只需要从仓库上 pull 下来就可以了。Docke r默认情况下去 Docker Hub 里查找镜像。
镜像(IMAGES)
Docker 镜像(Image)就是一个只读的模板,用来创建 Docker 容器的。通常情况下,一个镜像是基于另一个镜像,并带有一些额外的自定义内容。例如,你可以构建一个基于ubuntu镜像的镜像,但需要安装Apache Web Server和应用程序,以及应用程序运行所需的配置详细信息。
- 使用别人的镜像:可以使用他人创建并推送到镜像仓库里的镜像。
- 自己创建镜像:要构建自己的镜像,需要创建一个 Dockerfile 文件,其中包含一些简单的语法,用于定义构建镜像以及运行镜像的步骤。Dockerfile 中的每条指令都会在镜像中创建一层。当修改Dockerfile 并重新构建时,只有被修改的层会重新构建。与其他虚拟化技术相比,这是使得镜像如此轻量、体积小和快速的原因之一。
每一个镜像由一系列的层 (layers) 组成。Docker 使用 UnionFS 来将这些层联合到单独的镜像中。UnionFS 允许独立文件系统中的文件和文件夹(称之为分支)被透明覆盖,形成一个单独连贯的文件系统。正因为有了这些层的存在,Docker 是如此的轻量。当你改变了一个 Docker 镜像,比如升级到某个程序到新的版本,一个新的层会被创建。因此,不用替换整个原先的镜像或者重新建立(在使用虚拟机的时候你可能会这么做),只是一个新 的层被添加或升级了。现在你不用重新发布整个镜像,只需要升级,层使得分发 Docker 镜像变得简单和快速。
运行态容器被定义为一个可读写的统一文件系统加上隔离的进程空间和包含其中的进程。下面这张图片展示了一个运行中的容器。
容器(CONTAINERS)
容器是镜像运行的一个实例,Docker 利用容器(Container)来运行应用。可以通过 Docker CLI命令创建、启动、停止和删除一个容器。容器是从镜像创建的运行实例。它可以被启动、开始、停止、删除。每个容器都是相互隔离的、保证安全的平台。可以把容器看做是一个简易版的 Linux 环境(包括root用户权限、进程空间、用户空间和网络空间等)和运行在其中的应用程序。容器的定义和镜像几乎一模一样。
以 docker run 这个命令为例:
下面的命令运行一个 ubuntu 的容器,以交互的方式连接到容器里的本地命令行会话,并运行/bin/bash。命令:$ docker run -i -t ubuntu /bin/bash
假设使用的是默认的镜像仓库配置,执行这个命令的步骤是:
- 1、如果本地没有 ubuntu 镜像,Docker 会从镜像仓库拉取这个镜像,和手动执行 docker pull ubuntu 命令一样。
- 2、Docker 创建了一个新的容器,和手动执行 docker container create 命令一样。
- 3、Docker 为容器分配一个读写文件系统,作为容器的最后一层。这就允许正在运行的容器在本地文件系统中创建和修改文件和目录。
- 4、Docker 创建一个网络接口,因为没有指定任何网络选项,比如为容器分配IP地址等,所以容器会连接到默认网络。默认容器可以使用主机网络连接到外部网络。
- 5、Docker 启动容器并且执行 /bin/bash。由于容器是以交互方式执行并连接到本地终端(-i -t参数),你可以使用本地的键盘输入信息以及在本地终端上看到日志。
- 6、当输入exit 终止 /bin/bash 命令时,容器停止但不会被删除。
服务(SERVICES)
服务是可以跨多个 Docker 守护进程扩展容器,服务允许定义预期的状态,比如任意时刻服务副本的数量。默认情况下,服务的负载是通过集群node节点来做的,对消费者来说,Docker 服务表现出来的就是一个单独的应用。
Docker 是用 GO 语言编写的,利用了 Linux内核 的一些特性来提供功能。
命名空间(Namespaces)
Docker 利用了命名空间的技术来为容器提供独立的工作区域。当运行容器时,Docker会为这个容器创建一组命名空间。这些命名空间提供了一个隔离层,容器的每个方面都在一个单独的命名空间中运行并且其访问权限仅限于该命名空间。
Docker 引擎使用如下的命名空间:
- 1、pid 命名空间:进程隔离(PID:Process ID)
- 2、net 命名空间:管理网络接口(NET:Networking)
- 3、ipc 命名空间:管理对IPC资源的访问(IPC:InterProcess Communication)
- 4、mnt 命名空间:管理文件挂载点(MNT:Mount)
- 5、uts 命名空间:隔离内核和版本标识符(UTS:Unix Timesharing System)
pid namespace:不同用户的进程就是通过 pid namespace 隔离开的,且不同 namespace 中可以有相同 PID。( 参考文档:Introduction to Linux namespaces – Part 3: PID ) 具有以下特征:
- 每个 namespace 中的 pid 是有自己的 pid=1 的进程(类似 /sbin/init 进程)
- 每个 namespace 中的进程只能影响自己的同一个 namespace 或子 namespace 中的进程
- 因为 /proc 包含正在运行的进程,因此在 container 中的 pseudo-filesystem 的 /proc 目录只能看到自己 namespace 中的进程
- 因为 namespace 允许嵌套,父 namespace 可以影响子 namespace 的进程,所以子 namespace 的进程可以在父 namespace 中看到,但是具有不同的 pid
mnt namespace:类似 chroot,将一个进程放到一个特定的目录执行。mnt namespace 允许不同 namespace 的进程看到的文件结构不同,这样每个 namespace 中的进程所看到的文件目录就被隔离开了。同 chroot 不同,每个 namespace 中的 container 在 /proc/mounts 的信息只包含所在 namespace 的 mount point。
net namespace:网络隔离是通过 net namespace 实现的, 每个 net namespace 有独立的 network devices, IP addresses, IP routing tables, /proc/net 目录。这样每个 container 的网络就能隔离开来。 docker 默认采用 veth 的方式将 container 中的虚拟网卡同 host 上的一个 docker bridge 连接在一起。参考文档:Introduction to Linux namespaces – Part 5: NET
uts namespace:UTS ("UNIX Time-sharing System") namespace 允许每个 container 拥有独立的 hostname 和 domain name, 使其在网络上可以被视作一个独立的节点而非 Host 上的一个进程。参考文档:Introduction to Linux namespaces – Part 1: UTS
ipc namespace:container 中进程交互还是采用 Linux 常见的进程间交互方法 (interprocess communication - IPC), 包括常见的信号量、消息队列和共享内存。然而同 VM 不同,container 的进程间交互实际上还是 host 上具有相同 pid namespace 中的进程间交互,因此需要在IPC资源申请时加入 namespace 信息 - 每个 IPC 资源有一个唯一的 32bit ID。参考文档:Introduction to Linux namespaces – Part 2: IPC
user namespace:每个 container 可以有不同的 user 和 group id, 也就是说可以以 container 内部的用户在 container 内部执行程序而非 Host 上的用户。
有了以上 6 种 namespace 从进程、网络、IPC、文件系统、UTS 和用户角度的隔离,一个 container 就可以对外展现出一个独立计算机的能力,并且不同 container 从 OS 层面实现了隔离。 然而不同 namespace 之间资源还是相互竞争的,仍然需要类似 ulimit 来管理每个 container 所能使用的资源 - cgroup。
Reference
- Docker Getting Start: Related Knowledge
- Docker 介绍以及其相关术语、底层原理和技术
控制组(Control groups)
Docker 引擎还依赖于另一种称为控制组(cgroup)的技术。cgroup将应用程序限制为特定的资源集。控制组允许Docker引擎将可用的硬件资源共享给容器,并实施限制和约束。例如,限制特定容器的可用内存。
联合文件系统(Union file systems)
联合文件系统(UnionFS),是通过创建层来操作的文件系统,使得非常轻量级和快速。Docker引擎使用UnionFS为容器提供构建块。Docker引擎可以使用多个UnionFS变体,包括AUFS、btrfs、vfs和DeviceMapper。
容器格式(Container format)
Docker引擎将命名空间、控制组和UnionFS组合成一个容器格式的包装器,默认的容器格式是libcontainer。
二、Docker 安装、使用
docker 的相关安装方法这里不作介绍,具体安装参考 https://docs.docker.com/installation/
菜鸟教程 Docker 安装:https://www.runoob.com/docker/ubuntu-docker-install.html
sudo apt-get update
sudo apt-get install docker
sudo apt install docker.io
安装成后,记得更换国内的 docker 镜像源
获取当前 docker 版本
$ sudo docker version
Client version: 1.3.2
Client API version: 1.15
Go version (client): go1.3.3
Git commit (client): 39fa2fa/1.3.2
OS/Arch (client): linux/amd64
Server version: 1.3.2
Server API version: 1.15
Go version (server): go1.3.3
Git commit (server): 39fa2fa/1.3.2
安装完成后,就开始使用了。开始之前先看一张图,现在看不懂没关系。
Image 文件
Docker 把应用程序及其依赖打包在一个 image 文件里面,可以理解为一个容器的说明书。通过这个image文件可以生成容器的实例。同一个image文件可以生成同时运行的多个实例。
image 文件是一个二进制文件,实际上,一个 image 文件往往继承自另外一个 image 文件,加上一些个性化设置而成。举例来说:你可以在 ubuntu 的 image 基础上加上 Apache 服务器,形成你自己的 image。
# 列出本机的所有 image 文件。
$ docker image ls# 删除 image 文件
$ docker image rm [imageName]
image 文件是通用的,一台机器上的 image 文件拷贝到另一台机器上,照样可以使用。一般是使用别人制作好的 image 文件,即使要定制也可以对已有的 image 文件进行加工,而不是从头制作,这样可以节省很多时间。为了方便,image 制作完成后,可以上传到网上的仓库,Docker 的官方仓库 ( https://hub.docker.com/ ) 是最重要、最常用的 image 仓库。此外,出售自己制作的 image 文件也是可以的。
实例: Hello world
下面,我们通过最简单的 image 文件 https://hub.docker.com/r/library/hello-world/,感受一下 Docker。首先,运行下面的命令,将 image 文件从仓库抓取到本地。
$ docker image pull library/hello-world
上面的代码中,docker image pull 是 抓取(拉取) image 文件的命令,library/hello-world 是 image 文件在仓库里面的位置,其中 library是 image 文件所在的组,hello-world 是 image 文件的名字。由于 Docker 官方提供的文件都放在 library 组 里面,所以他是默认组,可以省略。因此上面的命令可以写成下面这样:
$ docker image pull hello-world
抓取成功后就可以看到本地的 image 文件了
ig:~ itguang$ docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-world latest e38bc07ac18e 3 weeks ago 1.85kB
现在运行这个image文件,可以看到如些输出:
ig:~ itguang$ docker container run hello-worldHello from Docker!
This message shows that your installation appears to be working correctly.To generate this message, Docker took the following steps:1. The Docker client contacted the Docker daemon.2. The Docker daemon pulled the "hello-world" image from the Docker Hub.(amd64)3. The Docker daemon created a new container from that image which runs theexecutable that produces the output you are currently reading.4. The Docker daemon streamed that output to the Docker client, which sent itto your terminal.To try something more ambitious, you can run an Ubuntu container with:$ docker run -it ubuntu bashShare images, automate workflows, and more with a free Docker ID:https://hub.docker.com/For more examples and ideas, visit:https://docs.docker.com/engine/userguide/
docker container run 会从一个镜像文件中生成一个容器实例,并且运行它。注意,docker container run 命令具有自动抓取 image 文件的功能。如果发现本地没有指定的 image 文件,就会从仓库自动抓取。因此,前面的 docker image pull命令并不是必需的步骤。
待上面那段提示输出后,hello-world 就会停止运行,容器就会终止。
有些容器不会终止,因为提供的是服务,比如安装 unbuntu 的 image,就可以在命令行体验unbutu系 统。
对于那些不会自动终止的容器,必须使用 docker container kill [container_id] 来终止。我们可以新打开一个终端窗口:
ig:~ itguang$ docker container ls # 查看当前运行容器
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
649a6b785a86 ubuntu "bash" 3 seconds ago Up 4 seconds loving_austinig:~ itguang$ docker container kill 649a6b785a86 # 杀死某个容器
649a6b785a86ig:~ itguang$ docker container ls 再次查看
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMESig:~ itguang$
container 容器文件
image文件生成的实例本身也是一个文件,称为:容器文件。也即是说,一旦容器生成,就会存在两个文件:一个image文件,一个容器文件。而且关闭容器并不会删除容器文件,只是容器停止运行而已。
# 列出本机正在运行的容器
$ docker container ls# 列出本机所有容器,包括终止运行的容器
ig:~ itguang$ docker container ls --all
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
649a6b785a86 ubuntu "bash" 10 minutes ago Exited (137) 9 minutes ago loving_austin
85b9c705e73f hello-world "/hello" 10 minutes ago Exited (0) 10 minutes ago silly_lumiere
c9281ad7f7b8 ubuntu "bash" 17 minutes ago Exited (127) 11 minutes ago stupefied_curran
e06bf36259ef hello-world "/hello" 24 minutes ago Exited (0) 24 minutes ago flamboyant_chaplygin
ig:~ itguang$
可以看出,我现在已经有了四个容器,终止运行的容器文件依然会占用硬盘空间,可以使用 docker container rm [container_id] 命令删除。
ig:~ itguang$ docker container ls --all
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
c9281ad7f7b8 ubuntu "bash" 22 minutes ago Exited (127) 17 minutes ago stupefied_curran
e06bf36259ef hello-world "/hello" 29 minutes ago Exited (0) 29 minutes ago flamboyant_chaplygin
ig:~ itguang$ docker container rm c9281ad7f7b8 e06bf36259ef
Dockerfile 文件
学会了如何使用 image文件 和 生成容器文件 之后,接下来你可能会想直到这个 image 文件是如何生成的呢? 如果你要推广自己的软件,势必要制作自己的 image 文件。
这时候就要用到 Dockerfile 文件,他是一个文本文件,用来配置 image。Docker容器根据 Dockerfile 文件生成 image 二进制文件。
下面通过一个实例,来演示如何编写 Dockerfile 文件生成自己的 image 二进制文件。
实例:制作自己的 Docker 容器
下面我以 koa-demos 项目为例,介绍怎么写 Dockerfile 文件,实现让用户在 Docker 容器里面运行 Koa 框架。
1. 下载源代码:
$ git clone https://github.com/ruanyf/koa-demos.git
$ cd koa-demos
2. 编写 Dockerfile 文件
首先,在项目的根目录下,新建一个文本文件 .dockerignore 然后写入下面的内容。
.git
node_modules
npm-debug.log
上面的代码表示,这三个路径要排除,不要打包进 image 文件,如果你没有路径可以排除,这个文件也可以不用建立。
然后在项目根目录下再新建一个 Dockerfile 文本文件,写入下面的内容:
FROM node:8.4
COPY . /app
WORKDIR /app
RUN npm install --registry=https://registry.npm.taobao.org
EXPOSE 3000
上面代码解释如下:
- From node:8.4 : 该image继承自官方的node image,冒号表示标签,这里表示8.4版本的node。
- COPY . /app : 将当前目录下的所有文件都拷贝到 image文件的 /app 目录。
- WORKDIR /app : 指定接下来的工作目录为 /app 。
- RUN npm install : 在/app目录下,运行npm install命令安装依赖。注意,安装后所有的依赖,都将打包进入 image 文件。
- EXPOSE 3000 : 将容器的3000 端口暴露出来,允许外部连接这个端口。
FROM 指定使用哪个镜像源。RUN 指令告诉 docker 在镜像内执行命令,安装了什么。
3. 创建 image 文件
有了 Dockerfile 文件以后,就可以使用 docker image build 命令创建 image 文件了。
$ docker image build -t koa-demo .
# 或者
$ docker image build -t koa-demo:0.0.1 .
上面代码中,-t
参数用来指定 image 文件的名字,后面还可以用冒号指定标签,如果不指定,默认标签就是latest,
最后那个.
表示 Dockerfile 文件所在的路径。这个例子 Dockerfile 文件在当前路径,所以就是一个.
上面代码中,
- -t 参数 指定 image 文件的名字,后面还可以用冒号指定标签,如果不指定,默认标签就是latest,
- 最后那个 . 表示 Dockerfile 文件所在的路径。这个例子 Dockerfile 文件在当前路径,所以就是一个 .
可以使用 docker tag 命令,为镜像添加一个新的标签。
如果构建成功,会有如下提示信息:
...
Successfully built 979e0930e4b6
Successfully tagged koa-demo:latest
我们使用 docker images 查看当前的 image 文件
ig:koa-demos itguang$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
koa-demo latest 979e0930e4b6 About a minute ago 676MB
ubuntu latest 452a96d81c30 8 days ago 79.6MB
hello-world latest e38bc07ac18e 3 weeks ago 1.85kB
node 8.4 386940f92d24 8 months ago 673MB
- 生成容器
前面讲过,docker container run 命令会 从 image 文件 生成容器,
$ docker container run -p 8000:3000 -it koa-demo /bin/bash
# 或者
$ docker container run -p 8000:3000 -it koa-demo:0.0.1 /bin/bash
上面各个参数解释如下:
-p : 容器的3000端口映射到本地的8000端口.
-it : 容器的shell会映射到当前本地的shell,你在本机窗口输入的命令会传入到容器中.
koa-demo:0.0.1 : image 文件的名字(如果有标签,还需要提供标签,默认是 latest 标签)。
/bin/bash : 容器启动以后,容器内部第一个执行的命令.这里是启用Bash,以保证用户可以使用shell
如果一切正常,运行上面的命令以后,就会返回一个命令行提示符。
root@6be4c4a279df:/app#
这表示你已经在容器里面了,返回的提示符就是容器内部的 Shell 提示符。执行下面的命令。
root@6be4c4a279df:/app# node demos/01.js
这时,Koa 框架已经运行起来了。打开本机的浏览器,访问 http://127.0.0.1:8000,网页显示”Not Found”,这是因为这个 demo 没有写路由。
这个例子中 node 进程运行在 Docker 容器的虚拟环境里面,进程接触到的文件系统和网络接口都是虚拟的,与本机文件系统和网络接口都是隔离的,因此需要定义容器与物理机的端口映射(map)。
现在,在容器的命令行下,按 ctrl+c 停止 node 进程, 按 ctrl+d ( 或者exit)退出容器。此外,也可以使用 docker container kill [container-id] 终止容器的运行。
# 在本机的另一个终端窗口,查出容器的 ID
$ docker container ls# 停止指定的容器运行
$ docker container kill [containerID]
也可以使用 docker container run
命令的 --rm
参数,在容器终止运行后自动删除容器文件。
$ docker container run --rm -p 8000:3000 -it koa-demo /bin/bash
CMD 命令
上面容器启动以后,需要手动输入命令 node demos/01.js。我们可以把这个命令写在 Dockerfile 里面,这样容器启动以后,这个命令就已经执行了,不用再手动输入了。
FROM node:8.4
COPY . /app
WORKDIR /app
RUN npm install --registry=https://registry.npm.taobao.org
EXPOSE 3000
CMD node demos/01.js
上面的 Dockerfile 文件最后面多了一行 CMD node demos/01.js,表示容器启动后,自动执行 node demos/01.js
你可能会问 RUN 命令和 CMD 命令的区别是什么呢?
简单来说:
- RUN 命令 在 image 文件的构建阶段执行,执行结果会打包进 image 文件;
- CMD 命令 则是在容器启动后执行。
- Dockerfile 文件只能可以包含多个RUN命令,但只能包含一个CMD命令
注意:指定了 CMD 命令后,docker container run 命令就不能附加命令了,比如前面的 /bin/bash,否则,它会覆盖CMD命令
现在启动容器可以用下面的命令:
$ docker container run --rm -p 8000:3000 -it koa-demo:0.0.1
发布 image 文件
容器运行成功后,就确认了 image文件的有效性,这是我们就可以考虑把 image 文件分享到网上。
首先,去 hub.docker.com 或 cloud.docker.com 注册一个账户。然后,用下面的命令登录。
$ docker login
接着,为本地的 image 标注用户名和版本。
$ docker image tag [imageName] [username]/[repository]:[tag]
# 实例
$ docker image tag koa-demos:0.0.1 ruanyf/koa-demos:0.0.1
也可以不标注用户名,重新构建一下 image 文件。
$ docker image build -t [username]/[repository]:[tag] .
最后,发布 image 文件。
$ docker image push [username]/[repository]:[tag]
发布成功以后,登录 hub.docker.com,就可以看到已经发布的 image 文件。
其他有用的命令
docker的主要用法就是上面这些。另外还有一些常见的命令:
- docker container start。前面的 docker container run 命令是新建容器,每运行一次,就会新建一个容器。同样的命令运行两次就会生成两个一模一样的容器文件。如果希望重复使用容器,就需要使用 docker container start 命令,它用来启动已经生成,已经停止运行的容器文件。命令:docker container start [container_id]
- docker container stop。前面的 docker container kill 命令终止容器的运行,相当于向容器的主进程发送SIGKILL信号,而docker container stop 也是用来终止容器的运行,相当于向容器的主进程发送 SIGTERM 信号,然后过一段时间在发送SIGKILL信号。这个信号的差别就是:程序收到 SIGTERM 信号后,可自行进行收尾清理工作,但也可以不理会这个信号,但如果收到 SIGKILL信号,就会立即终止这个容器的运行,那些正在进行的操作会全部丢失。命令:docker container stop [container_id]。
- docker container logs。docker container logs 用来查看容器的输出,即容器里shell的标准输出。比如: 如果 docker run 命令运行容器的时候,没有使用 -it 参数,就要使用这个命令查看输出。命令:docker container logs [container_id]
- docker container exec。docker container exec 命令用于进行一个正在运行的容器。如果 docker container run 命令运行容器的时候,没有使用 -it 参数,就要使用这个命令进入进入容器,一旦进入容器,就可以在容器的shell执行命令了。命令格式:docker container exec [container_id] /bin/bash
- docker container cp。docker container cp 命令用于从正在运行的容器里,将文件拷贝到本机。下面是拷贝当前 目录的写法:docker container cp [container_id]:[/path/to/file] .
小结
到了这里对 docker 的基本操作与相关概念已经有了大概了解,现在看开头的那个图:
可以看出: Dockerfile,Docker hub,image镜像文件,container容器文件,容器实例 的关系一目了然。
- image文件 来源有两个:Dockfile文件 和 Docker hub。
- 可以使用 docker container run 命令从 image 文件生成并运行容器。
更新 镜像
:https://zhuanlan.zhihu.com/p/413767660
更新镜像之前,需要使用镜像来创建一个容器。
runoob@runoob:~$ docker run -t -i ubuntu:15.10 /bin/bash
root@e218edb10161:/#
在运行的容器内使用 apt-get update 命令更新容器内的软件。在完成操作之后,输入 exit 命令来退出这个容器。此时 ID为 e218edb10161 的容器是按需求更改的容器。我们可以通过命令 docker commit 来提交容器副本。
runoob@runoob:~$ docker commit -m="has update" -a="runoob" e218edb10161 runoob/ubuntu:v2
sha256:70bf1840fd7c0d2d8ef0a42a817eb29f854c1af8f7c59fc03ac7bdee9545aff8
各个参数说明:
- -m: 提交的描述信息
- -a: 指定镜像作者
- e218edb10161:容器ID
- runoob/ubuntu:v2: 指定要创建的目标镜像名
有时,手动更新容器内的软件可能很诱人。这应该避免。apt-get update && apt get upgrade -y在管理裸机 Linux 服务器时,按计划运行(或您的包管理器的对应项)是标准做法。这些命令通常不在 Docker 容器中运行,尽管它们可能作为 a 的一部分包含 Dockerfile 在映像构建期间获取最新的安全补丁。定期拉取基础镜像并重新创建容器是保持它们更新的首选方式。这为您提供了所有上游安全修复并缩短了单个容器的寿命。容器环境不应在创建实例后进行修改;文件系统更改应仅限于写入临时路径和比容器寿命更长的专用 Docker 卷。
Docker自动更新 镜像、容器
在使用 Docker 时有的镜像可能需要经常更新,通常手动更新容器比较繁琐,需要四个步骤:
- 1.停止容器 docker stop <CONTAINER>
- 2.删除容器 docker rm <CONTAINER>
- 3.检查镜像更新情况,更新镜像 docker pull <IMAGE>
- 4.重新启动容器 docker run <ARG> …… <IMAGE>
容器较少还比较好,如果有大量容器需要更新,那将会产生巨大的工作量。
现在介绍一种自动更新容器的方式,Watchtower 是一种流行的选择,它监视正在运行的容器并在其 Docker Hub 映像更改时替换它们。Watchtower 本身被部署为一个容器:
docker run -d -v /var/run/docker.sock:/var/run/docker.sock container/watchtower
docker run -d -v /var/run/docker.sock:/var/run/docker.sock --name watchtower用上面的代码即可在后台启动 watchtower 容器,并监控当前所有镜像的更新情况。因为 watchtower 需要与 Docker API 进行交互以监控正在运行的容器,所以在使用时需要加上 -v 参数将 /var/run/docker.sock 映射到容器内。
现在您已经安装了一个正常运行的 Watchtower。您主机的 Docker 套接字已挂载到 Watchtower 容器中,允许它运行 Docker 命令来创建和删除容器。
watchtower 的官方文档:https://containrrr.dev/watchtower/usage-overview/
Watchtower 将自动检测 Docker Hub 上的新镜像发布,将它们拉到您的机器上,并使用该镜像替换容器。现有容器将被关闭,并在其位置创建新的相同容器。您提供的相同标志docker run
将提供给替换容器。
默认情况下,Watchtower 仅适用于 Docker Hub。您可以通过在配置文件中提供凭据将其与私有映像注册表一起使用。创建一个包含以下内容的 JSON 文件:
{"auths": {"example.com": {"auth": "credentials"}}
}
替换example.com
为您的注册表路径。
接下来从您的注册表用户名和密码生成凭据字符串:echo -n 'username:password' | base64
将生成的 Base64 编码字符串粘贴到配置文件中,替换credentials
占位符文本。
将配置文件挂载到 Watchtower 容器中以启用对注册表的访问:
docker run -d \-v config.json:/config.json-v /var/run/docker.sock:/var/run/docker.sock \containrrr/watchtower
在 docker 中更新镜像 --- 基于Prometheus
:https://blog.csdn.net/sinat_16643223/article/details/120655976
三、Docker 基础用法
https://registry.hub.docker.com/ :Docker镜像首页,包括官方镜像和其它公开镜像
因为国情的原因,国内下载 Docker HUB 官方的相关镜像比较慢,可以使用 http://opskumu.github.io/docker.cn 镜像,镜像保持和官方一致,关键是速度块,推荐使用。
3.1 Search images
$ sudo docker search ubuntu
搜索可用的 docker 镜像
使用 docker 最简单的方式莫过于从现有的容器镜像开始。Docker 官方网站专门有一个页面来存储所有可用的镜像,网址是:https://index.docker.io/ 。通过浏览这个网页来查找你想要使用的镜像,或者使用命令行的工具来检索。
命令格式:docker search 镜像名字
正确的命令:$ docker search tutorial
3.2 Pull images
$ sudo docker pull ubuntu # 获取 ubuntu 官方镜像
$ sudo docker images # 查看当前镜像列表
使用 docker pull 命令即可。( docker命令 和 git 有一些类似的地方)。在 docker 的镜像索引网站上面,镜像都是按照 用户名/镜像名 的方式来存储的。有一组比较特殊的镜像,比如ubuntu 这类基础镜像,经过官方的验证,值得信任,可以直接用 镜像名来检索到。
提示:执行pull命令的时候要写完整的名字,比如 "learn/tutorial"。
示例命令:$ docker pull learn/tutorial
3.3 运行 容器内的 shell
$ sudo docker run -i -t ubuntu:14.04 /bin/bash
- docker run - 运行一个容器
- -t - 分配一个(伪)tty (link is external)
- -i - 交互模式 (so we can interact with it)
- ubuntu:14.04 - 使用 ubuntu 基础镜像 14.04
- /bin/bash - 运行命令 bash shell
注: ubuntu 会有多个版本,通过指定 tag 来启动特定的版本 [image]:[tag]
$ sudo docker ps # 查看当前运行的容器, ps -a 列出当前系统所有的容器
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
6c9129e9df10 ubuntu:14.04 /bin/bash 6 minutes ago Up 6 minutes cranky_babbage
3.4 相关快捷键
- 退出:Ctrl-Dorexit
- detach:Ctrl-P + Ctrl-Q
- attach:docker attach CONTAINER-ID
3.5 Docker 删除镜像
1. 查询镜像:docker images
可以看到所有已经存在的镜像的 ID (IMAGE ID)
2. 查询容器:docker ps -a
可以看到所有容器的 ID (CONTAINER ID)
3. 先删除容器:docker rm 容器ID
4. 再删除镜像:docker rmi 镜像ID
注意点:
1. 删除前需要保证容器是停止的 stop
2. 需要注意删除镜像和容器的命令不一样。
docker rm CONTAINER_ID 删除容器
docker rmi IMAGE_ID 删除镜像
3. 顺序需要先删除容器,再删除镜像
在 docker 容器中运行 hello world
简介:通过 docker run 命令可以启动某一个镜像,并运行一个命令。
在 容器中 运行 hello world
目标:上面已经下载了 helloworld 镜像,现在在镜像中输出 "hello word"。为了达到这个目的,需要在运行 "echo" 命令,输出"hello word"。
提示:docker run 命令有两个参数,一个是镜像名,一个是要在镜像中运行的命令。
正确的命令:$docker run learn/tutorial echo "hello word"
在 容器中 安装 程序
下一步我们要做的事情是在容器里面安装一个简单的程序(ping)。我们之前下载的 tutorial 镜像是基于 ubuntu 的,所以你可以使用 ubuntu 的 apt-get 命令来安装 ping 程序: apt-get install -y ping。
备注:apt-get 命令执行完毕之后,容器就会停止,但对容器的改动不会丢失。
目标:在 learn/tutorial 镜像里面安装 ping 程序。
提示:在执行 apt-get 命令的时候,要带上-y参数。如果不指定-y参数的话,apt-get命令会进入交互模式,需要用户输入命令来进行确认,但在 docker 环境中是无法响应这种交互的。
正确的命令:$docker run learn/tutorial apt-get install -y ping
保存对容器的修改
简介:通过docker commit 命令保存对容器的修改
当对容器做了修改之后(通过在容器中运行某一个命令),可以把对容器的修改保存下来,这样下次就可以从保存后的最新状态运行该容器。docker 中保存状态的过程称之为 committing,它保存的新旧状态之间的区别,从而产生一个新的版本。
目标:首先使用 docker ps -l 命令获得安装完 ping 命令之后容器的 id。然后把这个镜像保存为 learn/ping。
提示:
1. 运行 docker commit,可以查看该命令的参数列表。
2. 你需要指定要提交保存容器的ID。(译者按:通过docker ps -l 命令获得)
3. 无需拷贝完整的id,通常来讲最开始的三至四个字母即可区分。(译者按:非常类似 git 里面的版本号)
正确的命令:$ docker commit 698 learn/ping
执行完 docker commit 命令之后,会返回新版本镜像的id号。
运行 修改后的镜像
对一个镜像提交修改之后,就可以运行它里面新安装的命令了。到现在为止,你已经建立了一个完整的、自成体系的docker环境,并且安装了ping命令在里面。它可以在任何支持docker环境的系统中运行了。
目标:在新的镜像中运行 ping www.google.com 命令。
提示:一定要使用新的镜像名 learn/ping来运行ping命令。(译者按:最开始下载的learn/tutorial镜像中是没有ping命令的)
正确的命令:$ docker run lean/ping ping www.google.com
检查运行中的镜像
简介:使用docker ps命令可以查看所有正在运行中的容器列表,使用docker inspect命令我们可以查看更详细的关于某一个容器的信息。
现在你已经运行了一个docker容器,让我们来看下正在运行的容器。
使用 docker ps命令 可以查看所有正在运行中的容器列表,
使用 docker inspect命令 我们可以查看更详细的关于某一个容器的信息。
目标:查找某一个运行中容器的id,然后使用docker inspect命令查看容器的信息。
提示:可以使用镜像id的前面部分,不需要完整的id。无需拷贝完整的id,通常来讲最开始的三至四个字母即可区分
正确的命令:$ docker inspect efe
发布自己的镜像
简介:我们也可以把我们自己编译的镜像发布到索引页面,一方面可以自己重用,另一方面也可以分享给其他人使用。
现在我们已经验证了新镜像可以正常工作,下一步我们可以将其发布到官方的索引网站。还记得我们最开始下载的learn/tutorial镜像吧,我们也可以把我们自己编译的镜像发布到索引页面,一方面可以自己重用,另一方面也可以分享给其他人使用。
目标:把 learn/ping 镜像发布到docker的index网站。
提示:
1. docker images 命令可以列出所有安装过的镜像。
2. docker push 命令可以将某一个镜像发布到官方网站。
3. 你只能将镜像发布到自己的空间下面。这个模拟器登录的是learn帐号。
预期的命令:$ docker push learn/ping
四、Docker 命令帮助
示例:
docker image --help
docker container --help
docker images 或者 docker image ls 列出镜像列表
docker pull ubuntu:14.04
docker search httpd 查找 名为 httpd 镜像
4.1 docker help
docker command
$ sudo docker # docker 命令帮助Commands:attach Attach to a running container # 当前 shell 下 attach 连接指定运行镜像build Build an image from a Dockerfile # 通过 Dockerfile 定制镜像commit Create a new image from a container's changes # 提交当前容器为新的镜像cp Copy files/folders from the containers filesystem to the host path# 从容器中拷贝指定文件或者目录到宿主机中create Create a new container # 创建一个新的容器,同 run,但不启动容器diff Inspect changes on a container's filesystem # 查看 docker 容器变化events Get real time events from the server # 从 docker 服务获取容器实时事件exec Run a command in an existing container # 在已存在的容器上运行命令export Stream the contents of a container as a tar archive # 导出容器的内容流作为一个 tar 归档文件[对应 import ]history Show the history of an image # 展示一个镜像形成历史images List images # 列出系统当前镜像import Create a new filesystem image from the contents of a tarball # 从tar包中的内容创建一个新的文件系统映像[对应 export]info Display system-wide information # 显示系统相关信息inspect Return low-level information on a container # 查看容器详细信息kill Kill a running container # kill 指定 docker 容器load Load an image from a tar archive # 从一个 tar 包中加载一个镜像[对应 save]login Register or Login to the docker registry server # 注册或者登陆一个 docker 源服务器logout Log out from a Docker registry server # 从当前 Docker registry 退出logs Fetch the logs of a container # 输出当前容器日志信息port Lookup the public-facing port which is NAT-ed to PRIVATE_PORT# 查看映射端口对应的容器内部源端口pause Pause all processes within a container # 暂停容器ps List containers # 列出容器列表pull Pull an image or a repository from the docker registry server# 从docker镜像源服务器拉取指定镜像或者库镜像push Push an image or a repository to the docker registry server# 推送指定镜像或者库镜像至docker源服务器restart Restart a running container # 重启运行的容器rm Remove one or more containers # 移除一个或者多个容器rmi Remove one or more images # 移除一个或多个镜像[无容器使用该镜像才可删除,否则需删除相关容器才可继续或 -f 强制删除]run Run a command in a new container# 创建一个新的容器并运行一个命令save Save an image to a tar archive # 保存一个镜像为一个 tar 包[对应 load]search Search for an image on the Docker Hub # 在 docker hub 中搜索镜像start Start a stopped containers # 启动容器stop Stop a running containers # 停止容器tag Tag an image into a repository # 给源中镜像打标签top Lookup the running processes of a container # 查看容器中运行的进程信息unpause Unpause a paused container # 取消暂停容器version Show the docker version information # 查看 docker 版本号wait Block until a container stops, then print its exit code # 截取容器停止时的退出状态值
Run 'docker COMMAND --help' for more information on a command.
docker option
Usage of docker:--api-enable-cors=false Enable CORS headers in the remote API # 远程 API 中开启 CORS 头-b, --bridge="" Attach containers to a pre-existing network bridge # 桥接网络use 'none' to disable container networking--bip="" Use this CIDR notation address for the network bridge's IP, not compatible with -b# 和 -b 选项不兼容,具体没有测试过-d, --daemon=false Enable daemon mode # daemon 模式-D, --debug=false Enable debug mode # debug 模式--dns=[] Force docker to use specific DNS servers # 强制 docker 使用指定 dns 服务器--dns-search=[] Force Docker to use specific DNS search domains # 强制 docker 使用指定 dns 搜索域-e, --exec-driver="native" Force the docker runtime to use a specific exec driver # 强制 docker 运行时使用指定执行驱动器--fixed-cidr="" IPv4 subnet for fixed IPs (ex: 10.20.0.0/16)this subnet must be nested in the bridge subnet (which is defined by -b or --bip)-G, --group="docker" Group to assign the unix socket specified by -H when running in daemon modeuse '' (the empty string) to disable setting of a group-g, --graph="/var/lib/docker" Path to use as the root of the docker runtime # 容器运行的根目录路径-H, --host=[] The socket(s) to bind to in daemon mode # daemon 模式下 docker 指定绑定方式[tcp or 本地 socket]specified using one or more tcp://host:port, unix:///path/to/socket, fd://* or fd://socketfd.--icc=true Enable inter-container communication # 跨容器通信--insecure-registry=[] Enable insecure communication with specified registries (no certificate verification for HTTPS and enable HTTP fallback) (e.g., localhost:5000 or 10.20.0.0/16)--ip="0.0.0.0" Default IP address to use when binding container ports # 指定监听地址,默认所有 ip--ip-forward=true Enable net.ipv4.ip_forward # 开启转发--ip-masq=true Enable IP masquerading for bridge's IP range--iptables=true Enable Docker's addition of iptables rules # 添加对应 iptables 规则--mtu=0 Set the containers network MTU # 设置网络 mtuif no value is provided: default to the default route MTU or 1500 if no default route is available-p, --pidfile="/var/run/docker.pid" Path to use for daemon PID file # 指定 pid 文件位置--registry-mirror=[] Specify a preferred Docker registry mirror -s, --storage-driver="" Force the docker runtime to use a specific storage driver # 强制 docker 运行时使用指定存储驱动--selinux-enabled=false Enable selinux support # 开启 selinux 支持--storage-opt=[] Set storage driver options # 设置存储驱动选项--tls=false Use TLS; implied by tls-verify flags # 开启 tls--tlscacert="/root/.docker/ca.pem" Trust only remotes providing a certificate signed by the CA given here--tlscert="/root/.docker/cert.pem" Path to TLS certificate file # tls 证书文件位置--tlskey="/root/.docker/key.pem" Path to TLS key file # tls key 文件位置--tlsverify=false Use TLS and verify the remote (daemon: verify client, client: verify daemon) # 使用 tls 并确认远程控制主机-v, --version=false Print version information and quit # 输出 docker 版本信息
4.2 docker search
$ sudo docker search --helpUsage: docker search TERMSearch the Docker Hub for images # 从 Docker Hub 搜索镜像 --automated=false Only show automated builds--no-trunc=false Don't truncate output-s, --stars=0 Only displays with at least xxx stars
示例:
# 查找 star 数至少为 100 的镜像,找出只有官方镜像 start 数超过 100,
# 默认不加 s 选项找出所有相关 ubuntu 镜像 $ sudo docker search -s 100 ubuntu
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
ubuntu Official Ubuntu base image 425 [OK]
4.3 docker info
# 容器个数 Images: 22 # 镜像个数 Storage Driver: devicemapper # 存储驱动 Pool
$ sudo docker info Containers: 1 Name: docker-8:17-3221225728-poolPool Blocksize: 65.54 kBData file: /data/docker/devicemapper/devicemapper/dataMetadata file: /data/docker/devicemapper/devicemapper/metadataData Space Used: 1.83 GBData Space Total: 107.4 GBMetadata Space Used: 2.191 MBMetadata Space Total: 2.147 GBLibrary Version: 1.02.84-RHEL7 (2014-03-26) Execution Driver: native-0.2 # 存储驱动 Kernel Version: 3.10.0-123.el7.x86_64
Operating System: CentOS Linux 7 (Core)
4.4 docker pull && docker push
$ sudo docker pull --help # pull 拉取镜像 Usage: docker pull [OPTIONS] NAME[:TAG] Pull an image or a repository from the registry-a, --all-tags=false Download all tagged images in the repository $ sudo docker push # push 推送指定镜像 Usage: docker push NAME[:TAG] Push an image or a repository to the registry
示例:
# 下载官方 ubuntu docker 镜像,默认下载所有 ubuntu 官方库镜像
$ sudo docker pull ubuntu # 下载指定版本 ubuntu 官方镜像
$ sudo docker pull ubuntu:14.04 # 推送镜像库到私有源[可注册 docker 官方账户,推送到官方自有账户]
$ sudo docker push 192.168.0.100:5000/ubuntu # 推送指定镜像到私有源
$ sudo docker push 192.168.0.100:5000/ubuntu:14.04
4.5 docker images
列出当前系统镜像
$ sudo docker images --helpUsage: docker images [OPTIONS] [NAME] List images# -a 显示当前系统的所有镜像,包括过渡层镜像,默认 docker images 显示最终镜像,不包括过渡层镜像 -a, --all=false Show all images (by default filter out the intermediate image layers) -f, --filter=[] Provide filter values (i.e. 'dangling=true') --no-trunc=false Don't truncate output -q, --quiet=false Only show numeric IDs
示例:
$ sudo docker images # 显示当前系统镜像,不包括过渡层镜像
$ sudo docker images -a # 显示当前系统所有镜像,包括过渡层镜像
$ sudo docker images ubuntu # 显示当前系统 docker ubuntu 库中的所有镜像
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
ubuntu 12.04 ebe4be4dd427 4 weeks ago 210.6 MB
ubuntu 14.04 e54ca5efa2e9 4 weeks ago 276.5 MB
ubuntu 14.04-ssh 6334d3ac099a 7 weeks ago 383.2 MB
4.6 docker rmi
删除一个或者多个镜像
$ sudo docker rmi --helpUsage: docker rmi IMAGE [IMAGE...] 移除一个或者多个镜像-f, --force=false Force removal of the image # 强制移除镜像不管是否有容器使用该镜像 --no-prune=false Do not delete untagged parents # 不要删除未标记的父镜像
4.7 docker run
$ sudo docker run --helpUsage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...] Run a command in a new container-a, --attach=[] Attach to stdin, stdout or stderr.-c, --cpu-shares=0 CPU shares (relative weight) # 设置 cpu 使用权重 --cap-add=[] Add Linux capabilities--cap-drop=[] Drop Linux capabilities--cidfile="" Write the container ID to the file # 把容器 id 写入到指定文件 --cpuset="" CPUs in which to allow execution (0-3, 0,1) # cpu 绑定 -d, --detach=false Detached mode: Run container in the background, print new container id # 后台运行容器 --device=[] Add a host device to the container (e.g. --device=/dev/sdc:/dev/xvdc) --dns=[] Set custom dns servers # 设置 dns --dns-search=[] Set custom dns search domains # 设置 dns 域搜索 -e, --env=[] Set environment variables # 定义环境变量 --entrypoint="" Overwrite the default entrypoint of the image # ? --env-file=[] Read in a line delimited file of ENV variables # 从指定文件读取变量值 --expose=[] Expose a port from the container without publishing it to your host # 指定对外提供服务端口 -h, --hostname="" Container host name # 设置容器主机名 -i, --interactive=false Keep stdin open even if not attached # 保持标准输出开启即使没有 attached --link=[] Add link to another container (name:alias) # 添加链接到另外一个容器 --lxc-conf=[] (lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" -m, --memory="" Memory limit (format: <number><optional unit>, where unit = b, k, m or g) # 内存限制 --name="" Assign a name to the container # 设置容器名 --net="bridge" Set the Network mode for the container # 设置容器网络模式 'bridge': creates a new network stack for the container on the docker bridge 'none': no networking for this container 'container:<name|id>': reuses another container network stack 'host': use the host network stack inside the container. Note: the host mode gives the container full access to local system services such as D-bus and is therefore considered insecure.-P, --publish-all=false Publish all exposed ports to the host interfaces # 自动映射容器对外提供服务的端口 -p, --publish=[] Publish a container's port to the host # 指定端口映射 format: ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort (use 'docker port' to see the actual mapping) --privileged=false Give extended privileges to this container # 提供更多的权限给容器 --restart="" Restart policy to apply when a container exits (no, on-failure[:max-retry], always) --rm=false Automatically remove the container when it exits (incompatible with -d) # 如果容器退出自动移除和 -d 选项冲突 --security-opt=[] Security Options--sig-proxy=true Proxify received signals to the process (even in non-tty mode). SIGCHLD is not proxied.-t, --tty=false Allocate a pseudo-tty # 分配伪终端 -u, --user="" Username or UID # 指定运行容器的用户 uid 或者用户名 -v, --volume=[] Bind mount a volume (e.g., from the host: -v /host:/container, from docker: -v /container) # 挂载卷 --volumes-from=[] Mount volumes from the specified container(s) # 从指定容器挂载卷 -w, --workdir="" Working directory inside the container # 指定容器工作目录
示例:
$ sudo docker images ubuntu
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
ubuntu 14.04 e54ca5efa2e9 4 weeks ago 276.5 MB
... ... # 创建一个 cpu 优先级为 100,内存限制 512MB,主机名为 test1,
名为 docker_test1 后台运行 bash 的容器 a424ca613c9f2247cd3ede95adfbaf8d28400cbcb1d5f9b69a7b56f97b2b52e5
$ sudo docker run -t -i -c 100 -m 512MB -h test1 -d --name="docker_test1" ubuntu /bin/bash $ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
a424ca613c9f ubuntu:14.04 /bin/bash 6 seconds ago Up 5 seconds docker_test1 $ sudo docker attach docker_test1
root@test1:/# pwd /
root@test1:/# exit exit
关于cpu优先级:
By default all groups have 1024 shares. A group with 100 shares will get a ~10% portion of the CPU time - archlinux cgroups
4.8 docker start|stop|kill... ...
docker start | stop | kill | restart | pause | unpause | rm | commit | inspect | logs
- docker start CONTAINER [CONTAINER...] # 运行一个或多个停止的容器
- docker stop CONTAINER [CONTAINER...] # 停掉一个或多个运行的容器-t选项可指定超时时间
- docker kill [OPTIONS] CONTAINER [CONTAINER...] # 默认 kill 发送 SIGKILL 信号-s可以指定发送 kill 信号类型
- docker restart [OPTIONS] CONTAINER [CONTAINER...] # 重启一个或多个运行的容器-t选项可指定超时时间
- docker pause CONTAINER # 暂停一个容器,方便 commit
- docker unpause CONTAINER # 继续暂停的容器
- docker rm [OPTIONS] CONTAINER [CONTAINER...] # 移除一个或多个容器
- -f, --force=false Force removal of running container
- -l, --link=false Remove the specified link and not the underlying container
- -v, --volumes=false Remove the volumes associated with the container
- docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]] # 提交指定容器为镜像
- -a, --author="" Author (e.g., "John Hannibal Smith hannibal@a-team.com")
- -m, --message="" Commit message
- -p, --pause=true Pause container during commit # 默认 commit 是暂停状态
- docker inspect CONTAINER|IMAGE [CONTAINER|IMAGE...] # 查看容器或者镜像的详细信息
- docker logs CONTAINER # 输出指定容器日志信息
- -f, --follow=false Follow log output # 类似 tail -f
- -t, --timestamps=false Show timestamps
- --tail="all" Output the specified number of lines at the end of logs (defaults to all logs)
参考文档:Docker Run Reference
4.9 和 正在运行的容器 交互
docker exec --helpUsage: docker exec [OPTIONS] CONTAINER COMMAND [ARG...]Run a command in a running containerOptions:-d, --detach Detached mode: run command in the background--detach-keys string Override the key sequence for detaching a container-e, --env list Set environment variables--env-file list Read in a file of environment variables-i, --interactive Keep STDIN open even if not attached--privileged Give extended privileges to the command-t, --tty Allocate a pseudo-TTY-u, --user string Username or UID (format: <name|uid>[:<group|gid>])-w, --workdir string Working directory inside the container
使用 docker exec 命令通过 Docker API 和 CLI 在运行的容器上运行程序。
$ docker exec -it ubuntu_bash bash
上例将在容器 ubuntu_bash 中创建一个新的 Bash 会话。
查看 docker 容器里面有哪些目录及文件
首先,查看有哪些容器:docker ps
然后,根据容器id查看该容器根目录下有哪些目录:docker exec 容器id ls -al /
拷贝某个文件目录或者文件:docker cp 容器id:/要拷贝的文件目录 /目的地
docker run、docker create
通过 docker run <image name> 命令创建一个容器并运行其中的程序,
但是有时候只是创建容器并不启动容器,所以 docker create 应运而生了。
示例:创建一个可写的容器层 (并且打印出容器 ID),但是并不运行它,
$ docker create -t -i fedora bash
6d8af538ec541dd581ebc2a24153a28329acb5268abe5ef868c1f1a261221752
可以使用以下命令运行该容器:
$ docker start -a -i 6d8af538ec5
bash-4.2#
通过 --security-opt 选项,运行容器时用户可自定义 SELinux 和 AppArmor 卷标和配置。
$ docker run --security-opt label:type:svirt_apache -i -t centos \ bash
上例只允许容器监听在 Apache 端口,这个选项的好处是用户不需要运行 docker 的时候指定--privileged选项,降低安全风险。
五、Docker 端口映射
# Find IP address of container with ID <container_id> 通过容器 id 获取 ip
$ sudo docker inspect <container_id> | grep IPAddress | cut -d ’"’ -f 4
无论如何,这些 ip 是基于本地系统的并且容器的端口非本地主机是访问不到的。此外,除了端口只能本地访问外,对于容器的另外一个问题是这些 ip 在容器每次启动的时候都会改变。
Docker 解决了容器的这两个问题,并且给容器内部服务的访问提供了一个简单而可靠的方法。Docker 通过端口绑定主机系统的接口,允许非本地客户端访问容器内部运行的服务。为了简便的使得容器间通信,Docker 提供了这种连接机制。
5.1 自动映射端口
-P 使用时需要指定 --expose 选项,指定需要对外提供服务的端口
$ sudo docker run -t -P --expose 22 --name server ubuntu:14.04
使用 docker run -P 自动绑定所有对外提供服务的容器端口,映射的端口将会从没有使用的端口池中 (49000..49900) 自动选择,你可以通过 docker ps、docker inspect <container_id>或者 docker port <container_id> <port> 确定具体的绑定信息。
5.2 绑定端口到指定接口
基本语法
$ sudo docker run -p [([<host_interface>:[host_port]])|(<host_port>):]<container_port>[/udp] <image> <cmd>
默认不指定绑定 ip 则监听所有网络接口。
绑定 TCP 端口
# Bind TCP port 8080 of the container to TCP port 80
# on 127.0.0.1 of the host machine.
$ sudo docker run -p 127.0.0.1:80:8080 <image> <cmd> # Bind TCP port 8080 of the container to a dynamically
# allocated TCP port on 127.0.0.1 of the host machine.
$ sudo docker run -p 127.0.0.1::8080 <image> <cmd> # Bind TCP port 8080 of the container to TCP port 80
# on all available interfaces of the host machine.
$ sudo docker run -p 80:8080 <image> <cmd> # Bind TCP port 8080 of the container to a dynamically
# allocated TCP port on all available interfaces
$ sudo docker run -p 8080 <image> <cmd>
绑定 UDP 端口
# Bind UDP port 5353 of the container to UDP port 53
# on 127.0.0.1 of the host machine.
$ sudo docker run -p 127.0.0.1:53:5353/udp <image> <cmd>
六、Docker 网络配置
图: Docker - container and lightweight virtualization
Dokcer 通过使用 Linux 桥接提供容器之间的通信,docker0 桥接接口的目的就是方便 Docker 管理。当 Docker daemon 启动时需要做以下操作:
- creates the docker0 bridge if not present # 如果 docker0 不存在则创建
- searches for an IP address range which doesn’t overlap with an existing route # 搜索一个与当前路由不冲突的 ip 段
- picks an IP in the selected range # 在确定的范围中选择 ip
- assigns this IP to the docker0 bridge # 绑定 ip 到 docker0
6.1 Docker 四种网络模式
四种网络模式摘自 Docker 网络详解及 pipework 源码解读与实践
docker run 创建 Docker 容器时,可以用 --net 选项指定容器的网络模式,Docker 有以下 4 种网络模式:
- host 模式, 使用 --net=host 指定。
如果启动容器的时候使用 host 模式,那么这个容器将不会获得一个独立的 Network Namespace,而是和宿主机共用一个 Network Namespace。容器将不会虚拟出自己的网卡,配置自己的 IP 等,而是使用宿主机的 IP 和端口。
例如,我们在 10.10.101.105/24 的机器上用 host 模式启动一个含有 web 应用的 Docker 容器,监听 tcp 80 端口。当我们在容器中执行任何类似 ifconfig 命令查看网络环境时,看到的都是宿主机上的信息。而外界访问容器中的应用,则直接使用 10.10.101.105:80 即可,不用任何 NAT 转换,就如直接跑在宿主机中一样。但是,容器的其他方面,如文件系统、进程列表等还是和宿主机隔离的。
- container 模式,使用 --net=container:NAMEorID 指定。
这个模式指定新创建的容器和已经存在的一个容器共享一个 Network Namespace,而不是和宿主机共享。新创建的容器不会创建自己的网卡,配置自己的 IP,而是和一个指定的容器共享 IP、端口范围等。同样,两个容器除了网络方面,其他的如文件系统、进程列表等还是隔离的。两个容器的进程可以通过 lo 网卡设备通信。 - none 模式, 使用 --net=none 指定。
这个模式和前两个不同。在这种模式下,Docker 容器拥有自己的 Network Namespace,但是,并不为 Docker容器进行任何网络配置。也就是说,这个 Docker 容器没有网卡、IP、路由等信息。需要我们自己为 Docker 容器添加网卡、配置 IP 等。 - bridge 模式, 使用 --net=bridge 指定,默认设置。
bridge模式
图:The Container World | Part 2 Networking
bridge 模式是 Docker 默认的网络设置,此模式会为每一个容器分配 Network Namespace、设置 IP 等,并将一个主机上的 Docker 容器连接到一个虚拟网桥上。当 Docker server 启动时,会在主机上创建一个名为 docker0 的虚拟网桥,此主机上启动的 Docker 容器会连接到这个虚拟网桥上。虚拟网桥的工作方式和物理交换机类似,这样主机上的所有容器就通过交换机连在了一个二层网络中。接下来就要为容器分配 IP 了,Docker 会从 RFC1918 所定义的私有 IP 网段中,选择一个和宿主机不同的IP地址和子网分配给 docker0,连接到 docker0 的容器就从这个子网中选择一个未占用的 IP 使用。如一般 Docker 会使用 172.17.0.0/16 这个网段,并将 172.17.42.1/16 分配给 docker0 网桥(在主机上使用 ifconfig 命令是可以看到 docker0 的,可以认为它是网桥的管理接口,在宿主机上作为一块虚拟网卡使用)
6.2 列出当前主机网桥
$ sudo brctl show # brctl 工具依赖 bridge-utils 软件包 bridge name bridge id STP enabled interfaces
docker0 8000.000000000000 no
6.3 查看当前 docker0 ip
$ sudo ifconfig docker0
docker0 Link encap:Ethernet HWaddr xx:xx:xx:xx:xx:xx
inet addr:172.17.42.1 Bcast:0.0.0.0 Mask:255.255.0.0
在容器运行时,每个容器都会分配一个特定的虚拟机口并桥接到 docker0。每个容器都会配置同 docker0 ip 相同网段的专用 ip 地址,docker0 的 IP 地址被用于所有容器的默认网关。
6.4 运行一个容器
$ sudo docker run -t -i -d ubuntu /bin/bash
52f811c5d3d69edddefc75aff5a4525fc8ba8bcfa1818132f9dc7d4f7c7e78b4 $ sudo brctl show
bridge name bridge id STP enabled interfaces
docker0 8000.fef213db5a66 no vethQCDY1N
以上, docker0 扮演着 52f811c5d3d6 container 这个容器的虚拟接口 vethQCDY1N interface 桥接的角色。
使用特定范围的 IP
Docker 会尝试寻找没有被主机使用的 ip 段,尽管它适用于大多数情况下,但是它不是万能的,有时候我们还是需要对 ip 进一步规划。Docker 允许你管理 docker0 桥接或者通过-b选项自定义桥接网卡,需要安装bridge-utils软件包。
基本步骤如下:
- ensure Docker is stopped # 确保 docker 的进程是停止的
- create your own bridge (bridge0 for example) # 创建自定义网桥
- assign a specific IP to this bridge # 给网桥分配特定的 ip
- start Docker with the -b=bridge0 parameter # 以 -b 的方式指定网桥
# Stopping Docker and removing docker0
$ sudo service docker stop
$ sudo ip link set dev docker0 down
$ sudo brctl delbr docker0 # Create our own bridge
$ sudo brctl addbr bridge0
$ sudo ip addr add 192.168.5.1/24 dev bridge0
$ sudo ip link set dev bridge0 up # Confirming that our bridge is up and running
$ ip addr show bridge04: bridge0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state UP group default
link/ether 66:38:d0:0d:76:18 brd ff:ff:ff:ff:ff:ff
inet 192.168.5.1/24 scope global bridge0
valid_lft forever preferred_lft forever # Tell Docker about it and restart (on Ubuntu) $ echo 'DOCKER_OPTS="-b=bridge0"' >> /etc/default/docker
$ sudo service docker start
参考文档: Network Configuration
6.5 不同主机间容器通信
不同容器之间的通信可以借助于 pipework 这个工具:
$ git clone https://github.com/jpetazzo/pipework.git$ sudo cp -rp pipework/pipework /usr/local/bin/
安装相应依赖软件
$ sudo apt-get install iputils-arping bridge-utils -y
桥接网络
桥接网络可以参考 日常问题处理 Tips 关于桥接的配置说明,这里不再赘述。
# brctl showbridge name bridge id STP enabled interfacesbr0 8000.000c291412cd no eth0docker0 8000.56847afe9799 no vetheb48029
可以删除 docker0,直接把 docker 的桥接指定为 br0。也可以保留使用默认的配置,这样单主机容器之间的通信可以通过 docker0,而跨主机不同容器之间通过 pipework 新建 docker 容器的网卡桥接到 br0,这样跨主机容器之间就可以通信了。
- ubuntu
$ sudo service docker stop$ sudo ip link set dev docker0 down$ sudo brctl delbr docker0$ echo 'DOCKER_OPTS="-b=br0"' >> /etc/default/docker$ sudo service docker start
- CentOS 7/RHEL 7
$ sudo systemctl stop docker$ sudo ip link set dev docker0 down$ sudo brctl delbr docker0$ cat /etc/sysconfig/docker | grep 'OPTIONS='OPTIONS=--selinux-enabled -b=br0 -H fd://$ sudo systemctl start docker
pipework
不同容器之间的通信可以借助于 pipework 这个工具给 docker 容器新建虚拟网卡并绑定 IP 桥接到 br0
$ git clone https://github.com/jpetazzo/pipework.git$ sudo cp -rp pipework/pipework /usr/local/bin/$ pipeworkSyntax:pipework <hostinterface> [-i containerinterface] <guest> <ipaddr>/<subnet>[@default_gateway] [macaddr][@vlan]pipework <hostinterface> [-i containerinterface] <guest> dhcp [macaddr][@vlan]pipework --wait [-i containerinterface]
如果删除了默认的 docker0 桥接,把 docker 默认桥接指定到了 br0,则最好在创建容器的时候加上--net=none,防止自动分配的 IP 在局域网中有冲突。
$ sudo docker run --rm -ti --net=none ubuntu:14.04 /bin/bash
root@a46657528059:/#
$ # Ctrl-P + Ctrl-Q 回到宿主机 shell,容器 detach 状态
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
a46657528059 ubuntu:14.04 "/bin/bash" 4 minutes ago Up 4 minutes hungry_lalande
$ sudo pipework br0 -i eth0 a46657528059 192.168.115.10/24@192.168.115.2
# 默认不指定网卡设备名,则默认添加为 eth1
# 另外 pipework 不能添加静态路由,如果有需求则可以在 run 的时候加上 --privileged=true 权限在容器中手动添加,
# 但这种安全性有缺陷,可以通过 ip netns 操作
$ sudo docker attach a46657528059
root@a46657528059:/# ifconfig eth0
eth0 Link encap:Ethernet HWaddr 86:b6:6b:e8:2e:4d inet addr:192.168.115.10 Bcast:0.0.0.0 Mask:255.255.255.0inet6 addr: fe80::84b6:6bff:fee8:2e4d/64 Scope:LinkUP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1RX packets:8 errors:0 dropped:0 overruns:0 frame:0TX packets:9 errors:0 dropped:0 overruns:0 carrier:0collisions:0 txqueuelen:1000 RX bytes:648 (648.0 B) TX bytes:690 (690.0 B)root@a46657528059:/# route -n
Kernel IP routing table
Destination Gateway Genmask Flags Metric Ref Use Iface
0.0.0.0 192.168.115.2 0.0.0.0 UG 0 0 0 eth0
192.168.115.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0
使用 ip netns 添加静态路由,避免创建容器使用 --privileged=true 选项造成一些不必要的安全问题:
$ docker inspect --format="{{ .State.Pid }}" a46657528059 # 获取指定容器 pid
6350
$ sudo ln -s /proc/6350/ns/net /var/run/netns/6350
$ sudo ip netns exec 6350 ip route add 192.168.0.0/16 dev eth0 via 192.168.115.2
$ sudo ip netns exec 6350 ip route # 添加成功
192.168.0.0/16 via 192.168.115.2 dev eth0
... ...
在其它宿主机进行相应的配置,新建容器并使用 pipework 添加虚拟网卡桥接到 br0,测试通信情况即可。
另外,pipework 可以创建容器的 vlan 网络,这里不作过多的介绍了,官方文档已经写的很清楚了,可以查看以下两篇文章:
- Pipework 官方文档
- Docker 网络详解及 pipework 源码解读与实践
七、Dockerfile
Docker 可以通过 Dockerfile 的内容来自动构建镜像。Dockerfile 是一个包含创建镜像所有命令的文本文件,通过docker build命令可以根据 Dockerfile 的内容构建镜像,在介绍如何构建之前先介绍下 Dockerfile 的基本语法结构。
Dockerfile 有以下指令选项:
- FROM
- MAINTAINER
- RUN
- CMD
- EXPOSE
- ENV
- ADD
- COPY
- ENTRYPOINT
- VOLUME
- USER
- WORKDIR
- ONBUILD
7.1 FROM
用法:
FROM <image>
或者
FROM <image>
- FROM 指定构建镜像的基础源镜像,如果本地没有指定的镜像,则会自动从 Docker 的公共库 pull 镜像下来。
- FROM 必须是 Dockerfile 中非注释行的第一个指令,即一个 Dockerfile 从 FROM 语句开始。
- FROM 可以在一个 Dockerfile 中出现多次,如果有需求在一个 Dockerfile 中创建多个镜像。
- 如果 FROM 语句没有指定镜像标签,则默认使用 latest 标签。
7.2 MAINTAINER
用法:
MAINTAINER <name>
指定创建镜像的用户
RUN 有两种使用方式
- RUN
- RUN "executable", "param1", "param2"
每条 RUN 指令将在当前镜像基础上执行指定命令,并提交为新的镜像,后续的RUN都在之前RUN提交后的镜像为基础,镜像是分层的,可以通过一个镜像的任何一个历史提交点来创建,类似源码的版本控制。
exec 方式会被解析为一个 JSON 数组,所以必须使用双引号而不是单引号。exec 方式不会调用一个命令 shell,所以也就不会继承相应的变量,如:
RUN [ "echo", "$HOME" ]
这种方式是不会达到输出 HOME 变量的,正确的方式应该是这样的
RUN [ "sh", "-c", "echo", "$HOME" ]
RUN 产生的缓存在下一次构建的时候是不会失效的,会被重用,可以使用 --no-cache 选项,即 docker build --no-cache,如此便不会缓存。
7.3 CMD
CMD 有三种使用方式:
- CMD "executable","param1","param2"
- CMD "param1","param2"
- CMD command param1 param2 (shell form)
CMD 指定在 Dockerfile 中只能使用一次,如果有多个,则只有最后一个会生效。
CMD 的目的是为了在启动容器时提供一个默认的命令执行选项。如果用户启动容器时指定了运行的命令,则会覆盖掉 CMD 指定的命令。
CMD 会在启动容器的时候执行,build 时不执行,而 RUN 只是在构建镜像的时候执行,后续镜像构建完成之后,启动容器就与 RUN 无关了,
这个初学者容易弄混这个概念,这里简单注解一下。
7.4 EXPOSE
EXPOSE <port> [<port>...]
告诉 Docker 服务端容器对外映射的本地端口,需要在 docker run 的时候使用-p或者-P选项生效。
7.5 ENV
ENV <key> <value> # 只能设置一个变量ENV <key>=<value> ... # 允许一次设置多个变量
指定一个环节变量,会被后续RUN指令使用,并在容器运行时保留。
例子:
ENV myName="John Doe" myDog=Rex\ The\ Dog \myCat=fluffy
等同于
ENV myName John DoeENV myDog Rex The DogENV myCat fluffy
7.6 ADD
ADD <src>... <dest>
ADD 复制本地主机文件、目录或者远程文件 URLS 从 并且添加到容器指定路径中 。
支持通过 GO 的正则模糊匹配,具体规则可参见 Go filepath.Match
ADD hom* /mydir/ # adds all files starting with "hom"ADD hom?.txt /mydir/ # ? is replaced with any single character
- 路径必须是绝对路径,如果 不存在,会自动创建对应目录
- 路径必须是 Dockerfile 所在路径的相对路径
- 如果是一个目录,只会复制目录下的内容,而目录本身则不会被复制
7.7 COPY
COPY <src>... <dest>
COPY 复制新文件或者目录从 并且添加到容器指定路径中 。用法同 ADD,唯一的不同是不能指定远程文件 URLS。
7.8 ENTRYPOINT
- ENTRYPOINT "executable", "param1", "param2"
- ENTRYPOINT command param1 param2 (shell form)
配置容器启动后执行的命令,并且不可被 docker run 提供的参数覆盖,而 CMD 是可以被覆盖的。如果需要覆盖,则可以使用 docker run --entrypoint 选项。
每个 Dockerfile 中只能有一个ENTRYPOINT,当指定多个时,只有最后一个生效。
Exec form ENTRYPOINT 例子
通过 ENTRYPOINT 使用 exec form 方式设置稳定的默认命令和选项,而使用 CMD 添加默认之外经常被改动的选项。
FROM ubuntuENTRYPOINT ["top", "-b"]CMD ["-c"]
通过 Dockerfile 使用 ENTRYPOINT 展示前台运行 Apache 服务
FROM debian:stableRUN apt-get update && apt-get install -y --force-yes apache2EXPOSE 80 443VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]ENTRYPOINT ["/usr/sbin/apache2ctl", "-D", "FOREGROUND"]
Shell form ENTRYPOINT 例子
这种方式会在 /bin/sh -c 中执行,会忽略任何 CMD 或者 docker run 命令行选项,为了确保 docker stop 能够停止长时间运行 ENTRYPOINT 的容器,确保执行的时候使用 exec 选项。
FROM ubuntuENTRYPOINT exec top -b
如果在 ENTRYPOINT 忘记使用 exec 选项,则可以使用 CMD 补上:
FROM ubuntuENTRYPOINT top -bCMD --ignored-param1 # --ignored-param2 ... --ignored-param3 ... 依此类推
7.9 VOLUME
VOLUME ["/data"]
创建一个可以从本地主机或其他容器挂载的挂载点,后续具体介绍。
7.10 USER
USER daemon
指定运行容器时的用户名或 UID,后续的RUN、CMD、ENTRYPOINT也会使用指定用户。
7.11 WORKDIR
WORKDIR /path/to/workdir
为后续的RUN、CMD、ENTRYPOINT指令配置工作目录。可以使用多个WORKDIR指令,后续命令如果参数是相对路径,则会基于之前命令指定的路径。
WORKDIR /aWORKDIR bWORKDIR cRUN pwd
最终路径是/a/b/c。
WORKDIR指令可以在ENV设置变量之后调用环境变量:
ENV DIRPATH /pathWORKDIR $DIRPATH/$DIRNAME
最终路径则为 /path/$DIRNAME。
7.12 ONBUILD
ONBUILD [INSTRUCTION]
配置当所创建的镜像作为其它新创建镜像的基础镜像时,所执行的操作指令。
例如,Dockerfile 使用如下的内容创建了镜像 image-A:
[...]ONBUILD ADD . /app/srcONBUILD RUN /usr/local/bin/python-build --dir /app/src[...]
如果基于 image-A 创建新的镜像时,新的 Dockerfile 中使用 FROM image-A 指定基础镜像时,会自动执行 ONBUILD 指令内容,等价于在后面添加了两条指令。
# Automatically run the followingADD . /app/srcRUN /usr/local/bin/python-build --dir /app/src
使用ONBUILD指令的镜像,推荐在标签中注明,例如 ruby:1.9-onbuild。
7.13 Dockerfile Examples
# Nginx
#
# VERSION 0.0.1FROM ubuntu
MAINTAINER Victor Vieux <victor@docker.com>RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server# Firefox over VNC
## VERSION 0.3FROM ubuntu# Install vnc, xvfb in order to create a 'fake' display and firefox
RUN apt-get update && apt-get install -y x11vnc xvfb firefox
RUN mkdir ~/.vnc# Setup a password
RUN x11vnc -storepasswd 1234 ~/.vnc/passwd# Autostart firefox (might not be the best way, but it does the trick)
RUN bash -c 'echo "firefox" >> /.bashrc'EXPOSE 5900
CMD ["x11vnc", "-forever", "-usepw", "-create"]# Multiple images example
#
# VERSION 0.1FROM ubuntu
RUN echo foo > bar
# Will output something like ===> 907ad6c2736fFROM ubuntu
RUN echo moo > oink
# Will output something like ===> 695d7793cbe4# You᾿ll now have two images, 907ad6c2736f with /bar, and 695d7793cbe4 with
# /oink.
7.14 docker build
$ docker build --helpUsage: docker build [OPTIONS] PATH | URL | -Build a new image from the source code at PATH# 移除过渡容器,即使构建失败
--force-rm=false Always remove intermediate containers, even after unsuccessful builds --no-cache=false Do not use cache when building the image # 不实用 cache-q, --quiet=false Suppress the verbose output generated by the containers# 构建成功后移除过渡层容器
--rm=true Remove intermediate containers after a successful build-t, --tag="" Repository name (and optionally a tag) to be applied to the resulting image in case of success
参考文档:Dockerfile Reference
7.15 dockerfile 最佳实践
- 使用.dockerignore文件
为了在docker build过程中更快上传和更加高效,应该使用一个.dockerignore文件用来排除构建镜像时不需要的文件或目录。例如,除非.git在构建过程中需要用到,否则你应该将它添加到.dockerignore文件中,这样可以节省很多时间。
- 避免安装不必要的软件包
为了降低复杂性、依赖性、文件大小以及构建时间,应该避免安装额外的或不必要的包。例如,不需要在一个数据库镜像中安装一个文本编辑器。
- 每个容器都跑一个进程
在大多数情况下,一个容器应该只单独跑一个程序。解耦应用到多个容器使其更容易横向扩展和重用。如果一个服务依赖另外一个服务,可以参考 Linking Containers Together。
- 最小化层
我们知道每执行一个指令,都会有一次镜像的提交,镜像是分层的结构,对于Dockerfile,应该找到可读性和最小化层之间的平衡。
- 多行参数排序
如果可能,通过字母顺序来排序,这样可以避免安装包的重复并且更容易更新列表,另外可读性也会更强,添加一个空行使用\换行:
RUN apt-get update && apt-get install -y \bzr \cvs \git \mercurial \subversion
- 创建缓存
镜像构建过程中会按照Dockerfile的顺序依次执行,每执行一次指令 Docker 会寻找是否有存在的镜像缓存可复用,如果没有则创建新的镜像。如果不想使用缓存,则可以在docker build时添加--no-cache=true选项。
从基础镜像开始就已经在缓存中了,下一个指令会对比所有的子镜像寻找是否执行相同的指令,如果没有则缓存失效。在大多数情况下只对比Dockerfile指令和子镜像就足够了。ADD和COPY指令除外,执行ADD和COPY时存放到镜像的文件也是需要检查的,完成一个文件的校验之后再利用这个校验在缓存中查找,如果检测的文件改变则缓存失效。RUN apt-get -y update命令只检查命令是否匹配,如果匹配就不会再执行更新了。
为了有效地利用缓存,你需要保持你的 Dockerfile 一致,并且尽量在末尾修改。
Dockerfile 指令
- FROM: 只要可能就使用官方镜像库作为基础镜像
- RUN: 为保持可读性、方便理解、可维护性,把长或者复杂的RUN语句使用\分隔符分成多行
- 不建议RUN apt-get update独立成行,否则如果后续包有更新,那么也不会再执行更新
- 避免使用RUN apt-get upgrade或者dist-upgrade,很多必要的包在一个非privileged权限的容器里是无法升级的。如果知道某个包更新,使用apt-get install -y xxx
- 标准写法
- RUN apt-get update && apt-get install -y package-bar package-foo
例子:
RUN apt-get update && apt-get install -y \aufs-tools \automake \btrfs-tools \build-essential \curl \dpkg-sig \git \iptables \libapparmor-dev \libcap-dev \libsqlite3-dev \lxc=1.0* \mercurial \parallel \reprepro \ruby1.9.1 \ruby1.9.1-dev \s3cmd=1.1.0*
- CMD: 推荐使用 CMD [“executable”, “param1”, “param2”…]这种格式,CMD [“param”, “param”]则配合ENTRYPOINT使用
- EXPOSE: Dockerfile 指定要公开的端口,使用docker run时指定映射到宿主机的端口即可
- ENV: 为了使新的软件更容易运行,可以使用ENV更新PATH变量。如ENV PATH /usr/local/nginx/bin:$PATH确保CMD ["nginx"]即可运行
ENV也可以这样定义变量:
ENV PG_MAJOR 9.3
ENV PG_VERSION 9.3.4
RUN curl -SL http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC /usr/src/postgress && …
ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH
- ADDorCOPY:ADD比COPY多一些特性「tar 文件自动解包和支持远程 URL」,不推荐添加远程 URL
如 不推荐 这种方式:
ADD http://example.com/big.tar.xz /usr/src/things/RUN tar -xJf /usr/src/things/big.tar.xz -C /usr/src/thingsRUN make -C /usr/src/things all
推荐使用 curl 或者 wget 替换,使用如下方式:
RUN mkdir -p /usr/src/things \&& curl -SL http://example.com/big.tar.gz \| tar -xJC /usr/src/things \&& make -C /usr/src/things all
如果不需要添加 tar 文件,推荐使用COPY。
参考文档:
- Best practices for writing Dockerfiles
- Dockerfile最佳实践(一)
- Dockerfile最佳实践(二)
八、容器数据管理
docker管理数据的方式有两种:
- 数据卷
- 数据卷容器
8.1 数据卷
数据卷是一个或多个容器专门指定绕过Union File System的目录,为持续性或共享数据提供一些有用的功能:
- 数据卷可以在容器间共享和重用
- 数据卷数据改变是直接修改的
- 数据卷数据改变不会被包括在容器中
- 数据卷是持续性的,直到没有容器使用它们
添加一个数据卷
你可以使用-v选项添加一个数据卷,或者可以使用多次-v选项为一个 docker 容器运行挂载多个数据卷。
$ sudo docker run --name data -v /data -t -i ubuntu:14.04 /bin/bash
# 创建数据卷绑定到到新建容器,新建容器中会创建 /data 数据卷 bash-4.1# ls -ld /data/
drwxr-xr-x 2 root root 4096 Jul 23 06:59 /data/bash-4.1# df -Th
Filesystem Type Size Used Avail Use% Mounted on
... ...ext4 91G 4.6G 82G 6% /data
创建的数据卷可以通过docker inspect获取宿主机对应路径
$ sudo docker inspect data
... ... "Volumes": { "/data": "/var/lib/docker/vfs/dir/151de401d268226f96d824fdf444e77a4500aed74c495de5980c807a2ffb7ea9" }, # 可以看到创建的数据卷宿主机路径 ... ...
或者直接指定获取
$ sudo docker inspect --format="{{ .Volumes }}" data
map[/data: /var/lib/docker/vfs/dir/151de401d268226f96d824fdf444e77a4500aed74c495de5980c807a2ffb7ea9]
挂载宿主机目录为一个数据卷
-v 选项除了可以创建卷,也可以挂载当前主机的一个目录到容器中。
$ sudo docker run --name web -v /source/:/web -t -i ubuntu:14.04 /bin/bash
bash-4.1# ls -ld /web/
drwxr-xr-x 2 root root 4096 Jul 23 06:59 /web/
bash-4.1# df -Th
... ...ext4 91G 4.6G 82G 6% /web
bash-4.1# exit
默认挂载卷是可读写的,可以在挂载时指定只读
$ sudo docker run --rm --name test -v /source/:/test:ro -t -i ubuntu:14.04 /bin/bash
8.2 创建和挂载一个数据卷容器
如果你有一些持久性的数据并且想在容器间共享,或者想用在非持久性的容器上,最好的方法是创建一个数据卷容器,然后从此容器上挂载数据。
创建数据卷容器
$ sudo docker run -t -i -d -v /test --name test ubuntu:14.04 echo hello
使用--volumes-from选项在另一个容器中挂载 /test 卷。不管 test 容器是否运行,其它容器都可以挂载该容器数据卷,当然如果只是单独的数据卷是没必要运行容器的。
$ sudo docker run -t -i -d --volumes-from test --name test1 ubuntu:14.04 /bin/bash
添加另一个容器
$ sudo docker run -t -i -d --volumes-from test --name test2 ubuntu:14.04 /bin/bash
也可以继承其它挂载有 /test 卷的容器
$ sudo docker run -t -i -d --volumes-from test1 --name test3 ubuntu:14.04 /bin/bash
8.3 备份、恢复或迁移数据卷
备份
$ sudo docker run --rm --volumes-from test -v $(pwd):/backup ubuntu:14.04 tar cvf /backup/test.tar /test
tar: Removing leading `/' from member names
/test/
/test/b
/test/d
/test/c
/test/a
启动一个新的容器并且从test容器中挂载卷,然后挂载当前目录到容器中为 backup,并备份 test 卷中所有的数据为 test.tar,执行完成之后删除容器--rm,此时备份就在当前的目录下,名为test.tar。
$ ls # 宿主机当前目录下产生了 test 卷的备份文件 test.tar test.tar
恢复
你可以恢复给同一个容器或者另外的容器,新建容器并解压备份文件到新的容器数据卷
$ sudo docker run -t -i -d -v /test --name test4 ubuntu:14.04 /bin/bash $ sudo docker run --rm --volumes-from test4 -v $(pwd):/backup ubuntu:14.04 tar xvf /backup/test.tar -C / # 恢复之前的文件到新建卷中,执行完后自动删除容器 test/ test/b test/d test/c test/a
8.4 删除 Volumes
Volume 只有在下列情况下才能被删除:
- docker rm -v删除容器时添加了-v选项
- docker run --rm运行容器时添加了--rm选项
否则,会在/var/lib/docker/vfs/dir目录中遗留很多不明目录。
参考文档:
- Managing Data in Containers
- 深入理解Docker Volume(一)
- 深入理解Docker Volume(二)
九、链接容器
docker 允许把多个容器连接在一起,相互交互信息。docker 链接会创建一种容器父子级别的关系,其中父容器可以看到其子容器提供的信息。
9.1 容器命名
在创建容器时,如果不指定容器的名字,则默认会自动创建一个名字,这里推荐给容器命名:
- 1、给容器命名方便记忆,如命名运行 web 应用的容器为 web
- 2、为 docker 容器提供一个参考,允许方便其他容器调用,如把容器 web 链接到容器 db
可以通过--name选项给容器自定义命名:
$ sudo docker run -d -t -i --name test ubuntu:14.04 bash$ sudo docker inspect --format="{{ .Nmae }}" test/test
注:容器名称必须唯一,即你只能命名一个叫test的容器。如果你想复用容器名,则必须在创建新的容器前通过docker rm删除旧的容器或者创建容器时添加--rm选项。
9.2 链接容器
链接允许容器间安全通信,使用--link选项创建链接。
$ sudo docker run -d --name db training/postgres
基于 training/postgres 镜像创建一个名为 db 的容器,然后下面创建一个叫做 web 的容器,并且将它与 db 相互连接在一起
$ sudo docker run -d -P --name web --link db:db training/webapp python app.py
--link <name or id>:alias选项指定链接到的容器。
查看 web 容器的链接关系:
$ sudo docker inspect -f "{{ .HostConfig.Links }}" web[/db:/web/db]
可以看到 web 容器被链接到 db 容器为/web/db,这允许 web 容器访问 db 容器的信息。
容器之间的链接实际做了什么?一个链接允许一个源容器提供信息访问给一个接收容器。在本例中,web 容器作为一个接收者,允许访问源容器 db 的相关服务信息。Docker 创建了一个安全隧道而不需要对外公开任何端口给外部容器,因此不需要在创建容器的时候添加-p或-P指定对外公开的端口,这也是链接容器的最大好处,本例为 PostgreSQL 数据库。
Docker 主要通过以下两个方式提供连接信息给接收容器:
- 环境变量
- 更新/etc/hosts文件
环境变量
当两个容器链接,Docker 会在目标容器上设置一些环境变量,以获取源容器的相关信息。
首先,Docker 会在每个通过--link选项指定别名的目标容器上设置一个<alias>_NAME环境变量。如果一个名为 web 的容器通过--link db:webdb被链接到一个名为 db 的数据库容器,那么 web 容器上会设置一个环境变量为WEBDB_NAME=/web/webdb.
以之前的为例,Docker 还会设置端口变量:
$ sudo docker run --rm --name web2 --link db:db training/webapp env
. . .
DB_NAME=/web2/db
DB_PORT=tcp://172.17.0.5:5432
DB_PORT_5432_TCP=tcp://172.17.0.5:5432 # <name>_PORT_<port>_<protocol> 协议可以是 TCP 或 UDP
DB_PORT_5432_TCP_PROTO=tcp
DB_PORT_5432_TCP_PORT=5432
DB_PORT_5432_TCP_ADDR=172.17.0.5
. . .
注:这些环境变量只设置给容器中的第一个进程,类似一些守护进程 (如 sshd ) 当他们派生 shells 时会清除这些变量
更新/etc/hosts文件
除了环境变量,Docker 会在目标容器上添加相关主机条目到/etc/hosts中,上例中就是 web 容器。
$ sudo docker run -t -i --rm --link db:db training/webapp /bin/bash
root@aed84ee21bde:/opt/webapp# cat /etc/hosts
172.17.0.7 aed84ee21bde
. . .
172.17.0.5 db
/etc/host文件在源容器被重启之后会自动更新 IP 地址,而环境变量中的 IP 地址则不会自动更新的。
/etc/host文件在源容器被重启之后会自动更新 IP 地址,而环境变量中的 IP 地址则不会自动更新的。
十、构建 私有库
Docker 官方提供了 docker registry 的构建方法 docker-registry
10.1 快速构建
快速构建 docker registry 通过以下两步:
- 安装 docker
- 运行 registry:docker run -p 5000:5000 registry
这种方法通过 Docker hub 使用官方镜像 official image from the Docker hub
10.2 不使用容器构建 registry
安装必要的软件
$ sudo apt-get install build-essential python-dev libevent-dev python-pip liblzma-dev
配置 docker-registry
sudo pip install docker-registry
或者 使用 github clone 手动安装
$ git clone https://github.com/dotcloud/docker-registry.git$ cd docker-registry/$ cp config/config_sample.yml config/config.yml$ mkdir /data/registry -p$ pip install .
运行
docker-registry
高级启动方式 [不推荐]
使用gunicorn控制:
gunicorn -c contrib/gunicorn_config.py docker_registry.wsgi:application
或者对外监听开放
gunicorn --access-logfile - --error-logfile - -k gevent -b 0.0.0.0:5000 -w 4 --max-requests 100 docker_registry.wsgi:application
10.3 提交指定容器到私有库
$ docker tag ubuntu:12.04 私有库IP:5000/ubuntu:12.04$ docker push 私有库IP:5000/ubuntu
更多的配置选项推荐阅读官方文档:
- Docker-Registry README
- Docker-Registry advanced use
来自:http://opskumu.github.io/docker.html