Docker Compose
Compose 简介Compose 是用于定义和运行多容器 Docker 应用程序的工具。通过 Compose，您可以利用 YML 文件来设置应用程序需要的所有服务。然后，利用一个下令，就可以从 YML 文件设置中创建并启动所有服务。
假如你还不了解 YML 文件设置，可以先阅读 YAML 入门教程。
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: {}
Compose 安装
Linux 上我们可以从 Github 上下载它的二进制包来利用，最新发行的版本地点：Releases · docker/compose · GitHub。
运行以下下令以下载 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
要安装其他版本的 Compose，请更换 v2.2.2。
Docker Compose 存放在 GitHub，不太稳固。
你可以也通过执行下面的下令，高速安装 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。
macOS
Mac 的 Docker 桌面版和 Docker Toolbox 已经包罗 Compose 和其他 Docker 应用程序，因此 Mac 用户不需要单独安装 Compose。Docker 安装说明可以参阅 MacOS Docker 安装。
windows PC
Windows 的 Docker 桌面版和 Docker Toolbox 已经包罗 Compose 和其他 Docker 应用程序，因此 Windows 用户不需要单独安装 Compose。Docker 安装说明可以参阅 Windows Docker 安装。
利用
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 模式的运行环境。
https://i-blog.csdnimg.cn/img_convert/41db00ca44bb854ed6f44e67b47b0192.png
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.82somehost
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:"
network_mode: "container:" 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"
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]