Skip to main content
Version: 1.0

Compose file

Docker Compose 是官方提供的编排工具,功能强大,简单易用。

Compose 最重要的莫过于编写编排文件。Docker-compose 文件的编写依赖于丰富的指令,所以理解各个指令的含义是首要的学习目标。 Docker Compose 文件用于创建互相关联的容器服务,下面是一个典型的 Compose 文件范例。

services:
frontend:
image: awesome/webapp
ports:
- "443:8043"
networks:
- front-tier
- back-tier
configs:
- httpd-config
secrets:
- server-certificate

backend:
image: awesome/database
volumes:
- db-data:/etc/data
networks:
- back-tier
profiles:
- test

volumes:
db-data:
driver: flocker
driver_opts:
size: "10GiB"

configs:
httpd-config:
external: true

secrets:
server-certificate:
external: true

networks:
# The presence of these objects is sufficient to define them
front-tier: {}
back-tier: {}

下面我们将对 Compose 文件中所用到的指令进行说明。

version

version 参数表示使用哪个版本的 compose 语法,一般是向下兼容。

  • version: '2' 表示兼容 2 版本的语法
  • version: '3.8' 表示兼容 3.8 版本的语法

Services

command

command 指令会覆盖 Dockerfile 中定义的 CMD 变量对应的值。

例如: command: bundle exec thin -p 3000

除了支持上述单一指令之外,也支持多指令的编写。

多指令

version: '3.1'
services:
db:
image: postgres
web:
build: .
command:
- /bin/bash
- -c
- |
python manage.py migrate
python manage.py runserver 0.0.0.0:8000

volumes:
- .:/code
ports:
- "8000:8000"
links:
- db

以上编排中的 command 相当于 docker run 下的:command: bash -c "python manage.py migrate && python manage.py runserver 0.0.0.0:8000"

如果多指令涉及变量,也可以写成:

    command:
- /bin/bash
- -c
- |
var=$$(echo 'foo')
echo $$var # prints foo

entrypoint

entrypoint 用法与 command 类似,也支持多命令。

deploy

包含对容器的生命周期、资源约束等的配置项。包括:

  • endpoint_mode
  • labels
  • mode
  • placement
  • replicas
  • resources
  • restart_policy
  • rollback_config
  • update_config

更多详情参考官网文档 deploy

blkio_config

对块 IO 进行设置的参数项

cpu

一类对 CPU 资源进行约束设置的参数项,包括:

  • cpu_count
  • cpu_percent
  • cpu_shares
  • cpu_period
  • cpu_quota
  • cpu_rt_runtime
  • cpt_rt_period
  • cpus
  • cpuset

build

build 是基于 Dockerfile 构建镜像后再启动容器服务的一组配置参考。

build 与 image 可以同时使用,当无法在镜像仓库中找到所需镜像之时,系统便开始构建镜像,且镜像会保持到仓库

services:
frontend:
image: awesome/webapp
build: ./webapp

backend:
image: awesome/database
build:
context: backend
dockerfile: ../backend.Dockerfile

custom:
build: ~/custom

与 docker build 命令类似,还有 labels, args 等更多的参数。

cap

cap 包含 cap_add, cap_drop 两个参数。它是对 capabilities 的一种按需设置。在运行容器的时候可以通过指定 --privileded 参数来开启容器的所有CAP,可以通过--cap-add 和 --cap-drop 这两个参数来调整.

Capabilities 是 Linux 中对 root 用户的特殊权限的一种划分。

cap_add
- ALL

等同于

--privileded: true

cgroup_parent

Control groups 通常称为 cgroups,是一个 Linux 内核功能,允许将进程组织成可以使用各种类型资源的分层组然后受到限制和监控。内核的 cgroup 接口是通过名为 cgroupfs 的伪文件系统提供。分组在核心 cgroup 内核代码中实现,而资源跟踪和限制在一组每个资源类型中实现子系统(内存、CPU 等)。

cgroup是对进程分组的一种管理机制,一个cgroup包含一组进程。

cgroup_parent 即指定容器的父 cgroup 组,继承改组的资源限制。

command

这个是一个非常重要的参数。它用于覆盖 Dockerfile 中默认的值,所以使用它之前必须参考 Dockerfile

configs

container_name

指定容器名称。否则将会使用默认名称:项目名称_服务名称_序号。项目名称一般为文件夹名称。

一旦指定容器名称后,该服务将由于同名导致无法自动扩展(例如:一次创建3个容器)

credential_spec

device_cgroup_rules

devices

dns

包括:dns, dns_opt, dns_search, domainname 等几个参数

entrypoint

这个是一个非常重要的参数。它用于覆盖 Dockerfile 中默认的值,所以使用它之前必须参考 Dockerfile

environment

环境变量,来源有三种:

  • 操作系统环境变量
  • Dockerfile 中定义的环境变量
  • entrypoint 脚本中所定义或使用的环境变量(不易发现)

支持两种写法:

environment:
RACK_ENV: development
SHOW: "true"
USER_INPUT:


environment:
- RACK_ENV=development
- SHOW=true
- USER_INPUT

environment 中所设定的环境变量的值优先级高于 env_file

env_file

容器默认启动时,会使用同名目录下的 .env 文件,也支持通过 env_file 参数设置

env_file:
- ./a.env
- ./b.env

值得注意的是,env 文件的格式有严格的要求:

  1. 必须采用 var=val 这种写法
  2. 字符串标引号和不标引号是不同的字符串
# Set Rails/Rack environment
RACK_ENV=development
VAR="quoted"

上述 VAR 变量会把引号也传递到容器中,可能会导致容器运行异常。

expose

定义容器向外公开的端口,这些端口可以被局域网中其他容器访问。但 expose 不应该绑定到宿主机上。

expose:
- "3000"
- "3000"

extends

基于一个相对比较简单的模板进行扩展。例如,我们有下面的一个 common.yml 模板:

# common.yml
webapp:
build: ./webapp
environment:
- DEBUG=false
- SEND_EMAIL=false

再编写一个 develop.yml 模板,其中第一个容器集成了上面的模板

# develop.yml
develop:
extends:
file: common.yml
service: webapp
ports:
- "8000:8000"
environment:
- DEBUG=true

db:
image: postgres

连接到 docker-compose.yml 文件外部的容器

extra_hosts

给容器的 /etc/hosts 增加更多的 mappings。格式为 HOSTNAME:IP

extra_hosts:
- "somehost: 162.242.195.82"
- "otherhost: 142.242.195.82"

group_add

healthcheck

覆盖 Dockerfile 中定义的值。

hostname

定义容器主机名

image

定义镜像,格式为: 仓库URL/镜像:tag

init

ipc

isolation

labels

logging

networks

network_mode

mac_address

mem

oom

pid

platform

platform 使用 os[/arch[/variant]] 语法定义了此服务将运行的目标平台容器。 Compose 实现在声明时必须使用此属性来确定将拉取哪个版本的图像和/或将在哪个平台上执行服务的构建。

platform: osx
platform: windows/amd64
platform: linux/arm64/v8

port

容器与宿主机的端口映射配置,非常重要的参数。

ports:
- "3000"
- "3000-3005"
- "8000:8000"
- "9090-9091:8080-8081"
- "49100:22"
- "127.0.0.1:8001:8001"
- "127.0.0.1:5000-5010:5000-5010"
- "6060:6060/udp"

长语法模式:

ports:
- target: 80
host_ip: 127.0.0.1
published: 8080
protocol: tcp
mode: host

privileged

提供容器用户的特权。如果采用了 user 参数,privileged 便提升 user 对应用户的特权。

profiles

类似容器标签,定义的标签的容器默认不会别启动,必须采用 --profile 参数方可运行。

# frontend 默认运行,backend 不会运行
docker-compose up

# frontend 默认运行,backend 也会运行
docker-compose --profile test

pull_policy

拉取镜像的策略,包括:always, never, missing, build 等值

read_only

restart

定义容器的重启策略,支持:no, always, on-failure, unless-stopped 等参数

runtime

secrets

security_opt

shm_size

stdin_open

stop_grace_period

stop_signal

storage_opt

sysctls

定义容器的内核参数

tmpfs

绑定临时文件

tty

ulimits

ulimit是一个内建命令,用于控制由shell启动的进程的可用资源。

userns_mode

volumes

volumes_from

working_dir

Networks

Volumes

volume 指令是很场景的应用变量,最常见的是基于下面的格式创建一个卷。volumes 设置中的前面部分是宿主机的目录,后面是容器的目录,宿主机的目录无需提前创建

volumes: 
graylog

此时,创建的卷存储在 /var/lib/volumes 下。

如果希望自定义一个卷的路径怎么做?docker-compose 文件中定义如下的 volume,基于它再创建容器:

volumes: 
graylog:
driver_opts:
type: none
device: /data/graylog
o: bind

发现非常有趣:

  1. 显示 Creating volume "docker-graylog_graylog" with default driver,即在 /var/lib/volumes 下创建了卷
  2. 自定义的 /data/graylog 也产生了数据

Configs

Secret

其他

YAML anchors