Docker使用速查手册

前言：复习一下，顺便记录一下，方便以后再查使用方法。

Docker安装、配置以及更换镜像源

docker安装：https://www.runoob.com/docker/centos-docker-install.html

镜像加速：

Ubuntu14.04、Debian7Wheezy 编辑文件：/etc/default/docker

编辑完成后重启命令：sudo service docker restart

DOCKER_OPTS="--registry-mirror=https://registry.docker-cn.com"

Ubuntu16.04+、Debian8+、CentOS7 编辑文件：/etc/docker/daemon.json

编辑完成后重启命令：sudo systemctl daemon-reload sudo systemctl restart docker

{"registry-mirrors":["https://reg-mirror.qiniu.com/"]}

检查加速器是否生效：

$ docker info
Registry Mirrors:
https://reg-mirror.qiniu.com

配置容器的DNS (/etc/docker/daemon.json)：

{
  "dns" : [
    "114.114.114.114",
    "8.8.8.8"
  ]
}

手动指定容器的DNS配置：docker run -it --rm -h host_ubuntu --dns=114.114.114.114 --dns-search=test.com ubuntu

--rm：容器退出时自动清理容器内部的文件系统。
-h HOSTNAME 或者 --hostname=HOSTNAME：设定容器的主机名，它会被写到容器内的 /etc/hostname 和 /etc/hosts。
--dns=IP_ADDRESS：添加 DNS 服务器到容器的 /etc/resolv.conf 中，让容器用这个服务器来解析所有不在 /etc/hosts 中的主机名。
--dns-search=DOMAIN：设定容器的搜索域，当设定搜索域为 .example.com 时，在搜索一个名为 host 的主机时，DNS 不仅搜索 host，还会搜索 host.example.com。

查看容器的DNS是否生效：docker run -it --rm ubuntu cat etc/resolv.conf

基本命令

拉取镜像：docker pull ubuntu

启动容器：docker run -it ubuntu /bin/bash

-d:让容器在后台运行。
-P:将容器内部使用的网络端口随机映射到我们使用的主机上。
-p:5000:5000 指定容器内要映射的端口，前面的5000为主机端口，后面的为绑定的容器端口，也可以指定绑定的网络地址如-p 127.0.0.1:5000:5000，也可以绑定udp端口，在端口后面加上/udp，如-p 127.0.0.1:5000:5000/udp

退出容器：exit

查看正在运行的容器：docker ps

查看最后一个创建的容器：docker ps -l

查看所有容器：docker ps -a

停止一个容器：docker stop b750bbbcfd88

启动一个已停止的容器：docker start b750bbbcfd88

重启一个容器：docker restart b750bbbcfd88

后台运行一个容器：docker run -itd --name ubuntu-test ubuntu /bin/bash

进入容器1：docker attach 1e560fca3906 这样进去退出来会导致容器停止

进入容器2：docker exec -it 243c32535da7 /bin/bash 这样进去退出来不会导致容器停止

导出容器：docker export 1e560fca3906 > ubuntu.tar

导入容器：cat docker/ubuntu.tar | docker import - test/ubuntu:v1

通过URL导入容器：docker import http://example.com/exampleimage.tgz example/imagerepo

删除容器：docker rm -f 1e560fca3906

清理所有处于中止状态的容器：docker container prune

查看容器端口的映射情况：docker port bf08b7f2cd89

查看容器内的日志：docker logs -f bf08b7f2cd89

查看容器的进程：docker top bf08b7f2cd89

查看容器的底层信息：docker inspect bf08b7f2cd89

镜像相关

列出本地主机上的镜像：docker images

使用镜像来运行容器：docker run -t -i ubuntu:15.10 /bin/bash

-i: 交互式操作。
-t: 终端。
ubuntu:15.10: 这是指用 ubuntu 15.10 版本镜像为基础来启动容器。
/bin/bash：放在镜像名后的是命令，这里我们希望有个交互式 Shell，因此用的是 /bin/bash。

查找镜像：docker search httpd

拉去对应版本镜像：docker pull ubuntu:13.10

删除镜像：docker rmi hello-world 注：要删除镜像需要先停止相应容器，再删除该镜像

创建镜像

更新旧镜像

1、从已经创建的容器中更新镜像，并且提交这个镜像
2、使用 Dockerfile 指令来创建一个新的镜像

一、在运行的容器内使用：apt-get update命令进行更新

二、exit退出容器

三、docker commit -m="test" -a="aaaahui" e218edb10161 aaaahui/ubuntu:v2

-m: 提交的描述信息
-a: 指定镜像作者
e218edb10161：容器 ID
aaaahui/ubuntu:v2: 指定要创建的目标镜像名

四、此时使用docker images可以查看创建的镜像

构建全新镜像

编写Dockerfile

FROM    centos:6.7
MAINTAINER      Fisher "[email protected]"

RUN     /bin/echo 'root:123456' |chpasswd
RUN     useradd runoob
RUN     /bin/echo 'runoob:123456' |chpasswd
RUN     /bin/echo -e "LANG=\"en_US.UTF-8\"" >/etc/default/local
EXPOSE  22
EXPOSE  80
CMD     /usr/sbin/sshd -D

构建镜像命令：docker build -t runoob/centos:6.7 .

-t ：指定要创建的目标镜像名
. ：Dockerfile 文件所在目录，可以指定Dockerfile 的绝对路径

然后使用docker images命令可以查看本地容器

设置镜像标签：docker tag 860c279d2fec runoob/centos:dev

Docker容器连接

新建网络

docker network create -d bridge test-net

-d：参数指定 Docker 网络类型，有 bridge、overlay。

连接容器

运行一个新容器并连接到test-net网络：

docker run -itd --name test1 --network test-net ubuntu /bin/bash

再运行一个容器加入到test-net网络：

docker run -itd --name test2 --network test-net ubuntu /bin/bash

Docker仓库管理

仓库（Repository）是集中存放镜像的地方，docker官方的有dockerhub

dockerhub登录：docker login

dockerhub退出：docker logout

登录后向仓库推送镜像

给自己的镜像设置标签：docker tag ununtu:18.04 aaaahui/ununtu:18.04

查看本地镜像：docker image ls = docker images

Docker Dockerfile

Dockerfile是定制镜像的文本文件，里面包含构建镜像所需的指令和说明。

例子：定制一个nginx镜像

新建nginx_image文件夹，在里面新建Dockerfile文件并添加以下内容

FROM nginx
RUN echo '这是一个本地构建的nginx镜像' > /usr/share/nginx/html/index.html

FROM：定制的镜像都是基于 FROM 的镜像，这里的 nginx 就是定制需要的基础镜像。后续的操作都是基于 nginx。

RUN：用于执行后面跟着的命令行命令。有以下俩种格式：

shell 格式：

RUN <命令行命令>

#<命令行命令> 等同于，在终端操作的 shell 命令。

exec 格式：

RUN ["可执行文件", "参数1", "参数2"]

例如：

RUN ["./test.php", "dev", "offline"] 等价于 RUN ./test.php dev offline

注意：Dockerfile 的指令每执行一次都会在 docker 上新建一层。所以过多无意义的层，会造成镜像膨胀过大

创建三层：

FROM centos  
RUN yum -y install wget  
RUN wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz"  
RUN tar -xvf redis.tar.gz

简化成一层：

FROM centos
RUN yum -y install wget \
    && wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz" \
    && tar -xvf redis.tar.gz

构建镜像：docker build -t nginx:v3 .

-t:指定镜像名称:标签
.:上下文路径，这里会打包该指定路径下所有的文件到新建的镜像中，所以在此路径下不要放多余文件，文件过多会造成过程缓慢，镜像庞大。

Dockerfile的其他指令

COPY

复制指令，从上下文目录中复制文件或者目录到容器里指定路径。

格式：

COPY [--chown=:] <源路径1>... <目标路径>
COPY [--chown=:] ["<源路径1>",... "<目标路径>"]

[--chown=:]：可选参数，用户改变复制到容器内文件的拥有者和属组。

<源路径>：源文件或者源目录，这里可以是通配符表达式，其通配符规则要满足 Go 的 filepath.Match 规则。例如：

COPY hom* /mydir/
COPY hom?.txt /mydir/

<目标路径>：容器内的指定路径，该路径不用事先建好，路径不存在的话，会自动创建。

ADD

ADD 指令和 COPY 的使用格类似（同样需求下，官方推荐使用 COPY）。功能也类似，不同之处如下：

ADD 的优点：在执行 <源文件> 为 tar 压缩文件的话，压缩格式为 gzip, bzip2 以及 xz 的情况下，会自动复制并解压到 <目标路径>。

ADD 的缺点：在不解压的前提下，无法复制 tar 压缩文件。会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。具体是否使用，可以根据是否需要自动解压来决定。

CMD

类似于 RUN 指令，用于运行程序，但二者运行的时间点不同:

CMD 在docker run 时运行。

RUN 是在 docker build。

作用：为启动的容器指定默认要运行的程序，程序运行结束，容器也就结束。CMD 指令指定的程序可被 docker run 命令行参数中指定要运行的程序所覆盖。

注意：如果 Dockerfile 中如果存在多个 CMD 指令，仅最后一个生效。

格式：

CMD <shell 命令> CMD ["<可执行文件或命令>","","",...] CMD ["","",...] # 该写法是为 ENTRYPOINT 指令指定的程序提供默认参数

推荐使用第二种格式，执行过程比较明确。第一种格式实际上在运行的过程中也会自动转换成第二种格式运行，并且默认可执行文件是 sh。

ENTRYPOINT

类似于 CMD 指令，但其不会被 docker run 的命令行参数指定的指令所覆盖，而且这些命令行参数会被当作参数送给 ENTRYPOINT 指令指定的程序。

但是, 如果运行 docker run 时使用了 --entrypoint 选项，将覆盖 ENTRYPOINT 指令指定的程序。

优点：在执行 docker run 的时候可以指定 ENTRYPOINT 运行所需的参数。

注意：如果 Dockerfile 中如果存在多个 ENTRYPOINT 指令，仅最后一个生效。

格式：

ENTRYPOINT ["","","",...]

可以搭配 CMD 命令使用：一般是变参才会使用 CMD ，这里的 CMD 等于是在给 ENTRYPOINT 传参，以下示例会提到。

示例：

假设已通过 Dockerfile 构建了 nginx:test 镜像：

FROM nginx
ENTRYPOINT ["nginx", "-c"] # 定参
CMD ["/etc/nginx/nginx.conf"] # 变参

1、不传参运行

$ docker run nginx:test

容器内会默认运行以下命令，启动主进程。

nginx -c /etc/nginx/nginx.conf

2、传参运行

$ docker run nginx:test -c /etc/nginx/new.conf

容器内会默认运行以下命令，启动主进程(/etc/nginx/new.conf:假设容器内已有此文件)

nginx -c /etc/nginx/new.conf

ENV

设置环境变量，定义了环境变量，那么在后续的指令中，就可以使用这个环境变量。

格式：

ENV
ENV = =...

以下示例设置 NODE_VERSION = 7.2.0 ，在后续的指令中可以通过 $NODE_VERSION 引用：

ENV NODE_VERSION 7.2.0

RUN curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION-linux-x64.tar.xz" \ && curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/SHASUMS256.txt.asc"

ARG

构建参数，与 ENV 作用一致。不过作用域不一样。ARG 设置的环境变量仅对 Dockerfile 内有效，也就是说只有 docker build 的过程中有效，构建好的镜像内不存在此环境变量。

构建命令 docker build 中可以用 --build-arg <参数名>=<值> 来覆盖。

格式：

ARG <参数名>[=<默认值>]

VOLUME

定义匿名数据卷。在启动容器时忘记挂载数据卷，会自动挂载到匿名卷。

作用：

避免重要的数据，因容器重启而丢失，这是非常致命的。

避免容器不断变大。

格式：

VOLUME ["<路径1>", "<路径2>"...]
VOLUME <路径>

在启动容器 docker run 的时候，我们可以通过 -v 参数修改挂载点。

EXPOSE

仅仅只是声明端口。

作用：

帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射。

在运行时使用随机端口映射时，也就是 docker run -P 时，会自动随机映射 EXPOSE 的端口。

格式：

EXPOSE <端口1> [<端口2>...]

WORKDIR

指定工作目录。用 WORKDIR 指定的工作目录，会在构建镜像的每一层中都存在。（WORKDIR 指定的工作目录，必须是提前创建好的）。

docker build 构建镜像过程中的，每一个 RUN 命令都是新建的一层。只有通过 WORKDIR 创建的目录才会一直存在。

格式：

WORKDIR <工作目录路径>

USER

用于指定执行后续命令的用户和用户组，这边只是切换后续命令执行的用户（用户和用户组必须提前已经存在）。

格式：

USER <用户名>[:<用户组>]

HEALTHCHECK

用于指定某个程序或者指令来监控 docker 容器服务的运行状态。

格式：

HEALTHCHECK [选项] CMD <命令>：设置检查容器健康状况的命令
HEALTHCHECK NONE：如果基础镜像有健康检查指令，使用这行可以屏蔽掉其健康检查指令

HEALTHCHECK [选项] CMD <命令> : 这边 CMD 后面跟随的命令使用，可以参考 CMD 的用法。

ONBUILD

用于延迟构建命令的执行。简单的说，就是 Dockerfile 里用 ONBUILD 指定的命令，在本次构建镜像的过程中不会执行（假设镜像为 test-build）。当有新的 Dockerfile 使用了之前构建的镜像 FROM test-build ，这时执行新镜像的 Dockerfile 构建时候，会执行 test-build 的 Dockerfile 里的 ONBUILD 指定的命令。

格式：

ONBUILD <其它指令>

LABEL

LABEL 指令用来给镜像添加一些元数据（metadata），以键值对的形式，语法格式如下：

LABEL = = = ...

比如我们可以添加镜像的作者：

LABEL org.opencontainers.image.authors="runoob"

Docker Compose

Compose 是用于定义和运行多容器 Docker 应用程序的工具。

Compose 安装

以下两个命令都可以

sudo curl -L "https://github.com/docker/compose/releases/download/v2.2.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

curl -L https://get.daocloud.io/docker/compose/releases/download/v2.4.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

将可执行权限应用于二进制文件：sudo chmod +x /usr/local/bin/docker-compose

创建软链：sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

测试是否安装成功：docker-compose --version
cker-compose version 1.24.1, build 4667896b

注意：对于 alpine，需要以下依赖包： py-pip，python-dev，libffi-dev，openssl-dev，gcc，libc-dev，和 make。

Compose使用

Compose 使用的三个步骤：

使用 Dockerfile 定义应用程序的环境。
使用 docker-compose.yml 定义构成应用程序的服务，这样它们可以在隔离环境中一起运行。
最后，执行 docker-compose up 命令来启动并运行整个应用程序。

docker-compose.yml文件示例：

# yaml 配置实例
version: '3'
services:
  web:
    build: .
    ports:
   - "5000:5000"
    volumes:
   - .:/code
    - logvolume01:/var/log
    links:
   - redis
  redis:
    image: redis
volumes:
  logvolume01: {}

使用示例

1、准备

创建一个测试目录：

$ mkdir composetest
$ cd composetest

在测试目录中创建一个名为 app.py 的文件，并复制粘贴以下内容：

composetest/app.py 文件代码

import time

import redis
from flask import Flask

app = Flask(name)
cache = redis.Redis(host='redis', port=6379)

def get_hit_count():
retries = 5
  while True:
  try:
  return cache.incr('hits')
  except redis.exceptions.ConnectionError as exc:
  if retries == 0:
  raise exc
retries -= 1
  time.sleep(0.5)

@app.route('/')
def hello():
count = get_hit_count()
  return 'Hello World! I have been seen {} times.\n'.format(count)

在此示例中，redis 是应用程序网络上的 redis 容器的主机名，该主机使用的端口为 6379。

在 composetest 目录中创建另一个名为 requirements.txt 的文件，内容如下：

flask
redis

2、创建 Dockerfile 文件

在 composetest 目录中，创建一个名为 Dockerfile 的文件，内容如下：

FROM python:3.7-alpine
WORKDIR /code
ENV FLASK_APP app.py
ENV FLASK_RUN_HOST 0.0.0.0
RUN apk add --no-cache gcc musl-dev linux-headers
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt
COPY . .
CMD ["flask", "run"]

Dockerfile 内容解释：

FROM python:3.7-alpine: 从 Python 3.7 映像开始构建镜像。

WORKDIR /code: 将工作目录设置为 /code。

ENV FLASK_APP app.py
ENV FLASK_RUN_HOST 0.0.0.0

设置 flask 命令使用的环境变量。

RUN apk add --no-cache gcc musl-dev linux-headers: 安装 gcc，以便诸如 MarkupSafe 和 SQLAlchemy 之类的 Python 包可以编译加速。

COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt

复制 requirements.txt 并安装 Python 依赖项。

COPY . .: 将 . 项目中的当前目录复制到 . 镜像中的工作目录。

CMD ["flask", "run"]: 容器提供默认的执行命令为：flask run。

3、创建 docker-compose.yml

在测试目录中创建一个名为 docker-compose.yml 的文件，然后粘贴以下内容：

docker-compose.yml 配置文件

yaml 配置

version: '3'
services: web: build: . ports:

- "5000:5000" redis: image: "redis:alpine"

该 Compose 文件定义了两个服务：web 和 redis。

web：该 web 服务使用从 Dockerfile 当前目录中构建的镜像。然后，它将容器和主机绑定到暴露的端口 5000。此示例服务使用 Flask Web 服务器的默认端口 5000 。

redis：该 redis 服务使用 Docker Hub 的公共 Redis 映像。

4、使用 Compose 命令构建和运行您的应用

在测试目录中，执行以下命令来启动应用程序：

docker-compose up

如果你想在后台执行该服务可以加上 -d 参数：

docker-compose up -d

yml 配置指令参考

version

指定本 yml 依从的 compose 哪个版本制定的。

build

指定为构建镜像上下文路径：

例如 webapp 服务，指定为从上下文路径 ./dir/Dockerfile 所构建的镜像：

version: "3.7"
services:
webapp:
build: ./dir

或者，作为具有在上下文指定的路径的对象，以及可选的 Dockerfile 和 args：

version: "3.7"
services:
webapp:
build:
context: ./dir
dockerfile: Dockerfile-alternate
args:
buildno: 1
labels:

"com.example.description=Accounting webapp"

"com.example.department=Finance"

"com.example.label-with-empty-value"
target: prod

context：上下文路径。

dockerfile：指定构建镜像的 Dockerfile 文件名。

args：添加构建参数，这是只能在构建过程中访问的环境变量。

labels：设置构建镜像的标签。

target：多层构建，可以指定构建哪一层。

cap_add，cap_drop

添加或删除容器拥有的宿主机的内核功能。

cap_add:

ALL # 开启全部权限

cap_drop:

SYS_PTRACE # 关闭 ptrace权限

cgroup_parent

为容器指定父 cgroup 组，意味着将继承该组的资源限制。

cgroup_parent: m-executor-abcd

command

覆盖容器启动的默认命令。

command: ["bundle", "exec", "thin", "-p", "3000"]

container_name

指定自定义容器名称，而不是生成的默认名称。

container_name: my-web-container

depends_on

设置依赖关系。

docker-compose up ：以依赖性顺序启动服务。在以下示例中，先启动 db 和 redis ，才会启动 web。

docker-compose up SERVICE ：自动包含 SERVICE 的依赖项。在以下示例中，docker-compose up web 还将创建并启动 db 和 redis。

docker-compose stop ：按依赖关系顺序停止服务。在以下示例中，web 在 db 和 redis 之前停止。

version: "3.7"
services:
web:
build: .
depends_on:

db - redis
redis:
image: redis
db:
image: postgres

注意：web 服务不会等待 redis db 完全启动之后才启动。

deploy

指定与服务的部署和运行有关的配置。只在 swarm 模式下才会有用。

version: "3.7"
services:
redis:
image: redis:alpine
deploy:
mode：replicated
replicas: 6
endpoint_mode: dnsrr
labels: description: "This redis service label"
resources:
limits:
cpus: '0.50'
memory: 50M
reservations:
cpus: '0.25'
memory: 20M
restart_policy:
condition: on-failure
delay: 5s
max_attempts: 3
window: 120s

可以选参数：

endpoint_mode：访问集群服务的方式。

endpoint_mode: vip

Docker 集群服务一个对外的虚拟 ip。所有的请求都会通过这个虚拟 ip 到达集群服务内部的机器。

endpoint_mode: dnsrr

DNS 轮询（DNSRR）。所有的请求会自动轮询获取到集群 ip 列表中的一个 ip 地址。

labels：在服务上设置标签。可以用容器上的 labels（跟 deploy 同级的配置）覆盖 deploy 下的 labels。

mode：指定服务提供的模式。

replicated：复制服务，复制指定服务到集群的机器上。

global：全局服务，服务将部署至集群的每个节点。

图解：下图中黄色的方块是 replicated 模式的运行情况，灰色方块是 global 模式的运行情况。

replicas：mode 为 replicated 时，需要使用此参数配置具体运行的节点数量。

resources：配置服务器资源使用的限制，例如上例子，配置 redis 集群运行需要的 cpu 的百分比和内存的占用。避免占用资源过高出现异常。

restart_policy：配置如何在退出容器时重新启动容器。

condition：可选 none，on-failure 或者 any（默认值：any）。

delay：设置多久之后重启（默认值：0）。

max_attempts：尝试重新启动容器的次数，超出次数，则不再尝试（默认值：一直重试）。

window：设置容器重启超时时间（默认值：0）。

rollback_config：配置在更新失败的情况下应如何回滚服务。

parallelism：一次要回滚的容器数。如果设置为0，则所有容器将同时回滚。

delay：每个容器组回滚之间等待的时间（默认为0s）。

failure_action：如果回滚失败，该怎么办。其中一个 continue 或者 pause（默认pause）。

monitor：每个容器更新后，持续观察是否失败了的时间 (ns|us|ms|s|m|h)（默认为0s）。

max_failure_ratio：在回滚期间可以容忍的故障率（默认为0）。

order：回滚期间的操作顺序。其中一个 stop-first（串行回滚），或者 start-first（并行回滚）（默认 stop-first ）。

update_config：配置应如何更新服务，对于配置滚动更新很有用。

parallelism：一次更新的容器数。

delay：在更新一组容器之间等待的时间。

failure_action：如果更新失败，该怎么办。其中一个 continue，rollback 或者pause （默认：pause）。

monitor：每个容器更新后，持续观察是否失败了的时间 (ns|us|ms|s|m|h)（默认为0s）。

max_failure_ratio：在更新过程中可以容忍的故障率。

order：回滚期间的操作顺序。其中一个 stop-first（串行回滚），或者 start-first（并行回滚）（默认stop-first）。

注：仅支持 V3.4 及更高版本。

devices

指定设备映射列表。

devices:

"/dev/ttyUSB0:/dev/ttyUSB0"

dns

自定义 DNS 服务器，可以是单个值或列表的多个值。

dns: 8.8.8.8

dns:

8.8.8.8

9.9.9.9

dns_search

自定义 DNS 搜索域。可以是单个值或列表。

dns_search: example.com
dns_search:

dc1.example.com - dc2.example.com

entrypoint

覆盖容器默认的 entrypoint。

entrypoint: /code/entrypoint.sh

也可以是以下格式：

entrypoint:

php - -d - zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20100525/xdebug.so - -d - memory_limit=-1

vendor/bin/phpunit

env_file

从文件添加环境变量。可以是单个值或列表的多个值。

env_file: .env

也可以是列表格式：

env_file:

./common.env - ./apps/web.env - /opt/secrets.env

environment

添加环境变量。您可以使用数组或字典、任何布尔值，布尔值需要用引号引起来，以确保 YML 解析器不会将其转换为 True 或 False。

environment:
RACK_ENV: development
SHOW: 'true'

expose

暴露端口，但不映射到宿主机，只被连接的服务访问。

仅可以指定内部端口为参数：

expose:

"3000"

"8000"

extra_hosts

添加主机名映射。类似 docker client --add-host。

extra_hosts:

"somehost:162.242.195.82"

"otherhost:50.31.209.229"

以上会在此服务的内部容器中 /etc/hosts 创建一个具有 ip 地址和主机名的映射关系：

162.242.195.82 somehost
50.31.209.229 otherhost

healthcheck

用于检测 docker 服务是否健康运行。

healthcheck:
test: ["CMD", "curl", "-f", "http://localhost"] # 设置检测程序
interval: 1m30s # 设置检测间隔
timeout: 10s # 设置检测超时时间
retries: 3 # 设置重试次数
start_period: 40s # 启动后，多少秒开始启动检测程序

image

指定容器运行的镜像。以下格式都可以：

image: redis
image: ubuntu:14.04
image: tutum/influxdb
image: example-registry.com:4000/postgresql
image: a4bc65fd # 镜像id

logging

服务的日志记录配置。

driver：指定服务容器的日志记录驱动程序，默认值为json-file。有以下三个选项

driver: "json-file"
driver: "syslog"
driver: "none"

仅在 json-file 驱动程序下，可以使用以下参数，限制日志得数量和大小。

logging:
driver: json-file
options:
max-size: "200k" # 单个文件大小为200k
max-file: "10" # 最多10个文件

当达到文件限制上限，会自动删除旧得文件。

syslog 驱动程序下，可以使用 syslog-address 指定日志接收地址。

logging:
driver: syslog
options:
syslog-address: "tcp://192.168.0.42:123"

network_mode

设置网络模式。

network_mode: "bridge"
network_mode: "host"
network_mode: "none"
network_mode: "service:[service name]"
network_mode: "container:[container name/id]"

networks

配置容器连接的网络，引用顶级 networks 下的条目。

services:
some-service:
networks:
some-network:
aliases:

alias1
other-network:
aliases:

alias2
networks:
some-network:

Use a custom driver

driver: custom-driver-1
other-network:

Use a custom driver which takes special options

driver: custom-driver-2

aliases ：同一网络上的其他容器可以使用服务名称或此别名来连接到对应容器的服务。

restart

no：是默认的重启策略，在任何情况下都不会重启容器。

always：容器总是重新启动。

on-failure：在容器非正常退出时（退出状态非0），才会重启容器。

unless-stopped：在容器退出时总是重启容器，但是不考虑在Docker守护进程启动时就已经停止了的容器

restart: "no"
restart: always
restart: on-failure
restart: unless-stopped

注：swarm 集群模式，请改用 restart_policy。

secrets

存储敏感数据，例如密码：

version: "3.1"
services:

mysql:
image: mysql
environment:
MYSQL_ROOT_PASSWORD_FILE: /run/secrets/my_secret
secrets:

my_secret
secrets:
my_secret:
file: ./my_secret.txt

security_opt

修改容器默认的 schema 标签。

security-opt：

label:user:USER # 设置容器的用户标签

label:role:ROLE # 设置容器的角色标签

label:type:TYPE # 设置容器的安全策略标签

label:level:LEVEL # 设置容器的安全等级标签

stop_grace_period

指定在容器无法处理 SIGTERM (或者任何 stop_signal 的信号)，等待多久后发送 SIGKILL 信号关闭容器。

stop_grace_period: 1s # 等待 1 秒
stop_grace_period: 1m30s # 等待 1 分 30 秒

默认的等待时间是 10 秒。

stop_signal

设置停止容器的替代信号。默认情况下使用 SIGTERM 。

以下示例，使用 SIGUSR1 替代信号 SIGTERM 来停止容器。

stop_signal: SIGUSR1

sysctls

设置容器中的内核参数，可以使用数组或字典格式。

sysctls:
net.core.somaxconn: 1024
net.ipv4.tcp_syncookies: 0

sysctls:

net.core.somaxconn=1024

net.ipv4.tcp_syncookies=0

tmpfs

在容器内安装一个临时文件系统。可以是单个值或列表的多个值。

tmpfs: /run
tmpfs:

/run - /tmp

ulimits

覆盖容器默认的 ulimit。

ulimits:
nproc: 65535
nofile:
soft: 20000
hard: 40000

volumes

将主机的数据卷或着文件挂载到容器里。

version: "3.7"
services:
db:
image: postgres:latest
volumes:

"/localhost/postgres.sock:/var/run/postgres/postgres.sock"

"/localhost/data:/var/lib/postgresql/data"

Docker Machine

Docker Machine 是一种可以让您在虚拟主机上安装 Docker 的工具，并可以使用 docker-machine 命令来管理主机。Docker Machine 也可以集中管理所有的 docker 主机，比如快速的给 100 台服务器安装上 docker。

安装

linux：

base=https://github.com/docker/machine/releases/download/v0.16.0 &&
  curl -L $base/docker-machine-$(uname -s)-$(uname -m) >/tmp/docker-machine &&
  sudo mv /tmp/docker-machine /usr/local/bin/docker-machine &&
  chmod +x /usr/local/bin/docker-machine

macOS：

base=https://github.com/docker/machine/releases/download/v0.16.0 &&
  curl -L $base/docker-machine-$(uname -s)-$(uname -m) >/usr/local/bin/docker-machine &&
  chmod +x /usr/local/bin/docker-machine

windows:

base=https://github.com/docker/machine/releases/download/v0.16.0 &&
  mkdir -p "$HOME/bin" &&
  curl -L $base/docker-machine-Windows-x86_64.exe > "$HOME/bin/docker-machine.exe" &&
  chmod +x "$HOME/bin/docker-machine.exe"

查看是否安装成功：docker-machine version

列出可用的机器：docker-machine ls

创建机器：docker-machine create --driver virtualbox test

--driver：指定用来创建机器的驱动类型，这里是 virtualbox。

查看机器IP：docker-machine ip test

停止机器：docker-machine stop test

启动机器：docker-machine start test

进入机器：docker-machine ssh test

查看当前激活状态的 Docker 主机：docker-machine active

config：查看当前激活状态 Docker 主机的连接信息。
create：创建 Docker 主机
env：显示连接到某个主机需要的环境变量
inspect：以 json 格式输出指定Docker的详细信息
ip：获取指定 Docker 主机的地址
kill：直接杀死指定的 Docker 主机
ls：列出所有的管理主机
provision：重新配置指定主机
regenerate-certs：为某个主机重新生成 TLS 信息
restart：重启指定的主机
rm：删除某台 Docker 主机，对应的虚拟机也会被删除
ssh：通过 SSH 连接到主机上，执行命令
scp：在 Docker 主机之间以及 Docker 主机和本地主机之间通过 scp 远程复制数据
mount：使用 SSHFS 从计算机装载或卸载目录
start：启动一个指定的 Docker 主机，如果对象是个虚拟机，该虚拟机将被启动
status：获取指定 Docker 主机的状态(包括：Running、Paused、Saved、Stopped、Stopping、Starting、Error)等
stop：停止一个指定的 Docker 主机
upgrade：将一个指定主机的 Docker 版本更新为最新
url：获取指定 Docker 主机的监听 URL
version：显示 Docker Machine 的版本或者主机 Docker 版本
help：显示帮助信息