浅谈docker compose书写规则

2023-07-24 17:47:15 60

本文对集群部署相关的一概不做介绍

版本约束

DockerEngine>=19.03
DockerCompose>=3.8

结构介绍

docker-compose.yaml文件结构主要由

version#dockercompose版本
networks#网络，用于docker容器内部通讯
x-{name}#模版命名规则以x-开头用于复用
volumes#挂载卷
services#服务模块，内部定义容器信息其内部参数相当于dockerrun时的参数

模块介绍

DockerCompose官方文档

version

设定docker-compose.yaml的版本
需要升级的话，参看文档版本升级参考文档

Composefile版本	DockerEngine版本
3.8	19.03.0+
3.7	18.06.0+
3.6	18.02.0+
3.5	17.12.0+
3.4	17.09.0+
3.3	17.06.0+
3.2	17.04.0+
3.1	1.13.1+
3.0	1.13.0+
2.4	17.12.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1.+

network_mode

使用与--network参数相同的值，以及特殊形式service:[servicename]

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

networks

为当前docker-compose.yaml文件创建的容器设定网络

不一定存在于和version同级，也可以在各个其他模块中，例如services中

内部网络

services:
some-service:
networks:
-some-network
-other-network

公用网络

version:"3"
networks:
default-network:

aliases（待补充）

网络的别名

version:"3.8"

services:
web:
image:"nginx:alpine"
networks:
-new

worker:
image:"my-worker-image:latest"
networks:
-legacy

db:
image:mysql
networks:
new:
aliases:
-database
legacy:
aliases:
-mysql

networks:
new:
legacy:

ipv4_address,ipv6_address(待补充)

version:"3.8"

services:
app:
image:nginx:alpine
networks:
app_net:
ipv4_address:172.16.238.10
ipv6_address:2001:3984:3989::10

networks:
app_net:
ipam:
driver:default
config:
-subnet:"172.16.238.0/24"
-subnet:"2001:3984:3989::/64"

services

最主要的部分，用来配置各个服务

build

用于构建镜像，当build和image字段都存在时，使用image指定的镜像名和tag作为build镜像的name和tag

version:"3.8"#dockercompose版本
services:
webapp:#docker-compose定义的服务（容器）名，主要是针对docker-compose命令的参数，与dockerps看到的容器名不一定一致
build:#使用Dockerfile构建镜像
context:./dir上下文路径，相对路径则是相对于compose文件路径
dockerfile:Dockerfile-alternate#指定Dockerfile文件名
args:#指定Dockerfile的参数环境变量
buildno:1#directory写法和list写法均可

context

可以使用相对路径或者git仓库的url

build:
context:./dir

Dockerfile

指定Dockerfile文件名，必须指定context

build:
context:.
dockerfile:Dockerfile-alternate

args

Dockerfile中的ARG字段，用于指定dockerbuild时的环境变量

ARGbuildno
ARGgitcommithash

RUNecho"Buildnumber:$buildno"#bash-like风格的写法
RUNecho"Basedoncommit:$gitcommithash"

可以使用list或者map来设定args

build:
context:.
args:#map
buildno:1
gitcommithash:cdc3b19

build:
context:.
args:#list
-buildno=1
-gitcommithash=cdc3b19

tips
如果需要使用boolean值，需要使用双引号("true","false","yes","no","on","off")，以便解析器将他们解析为字符串。

cache_from

为build过程指定cache

build:
context:.
cache_from:
-alpine:latest
-corp/web_app:3.14

labels

同Dockerfile中的LABEL指令，为镜像设定metadata

build:
context:.
labels:#map
com.example.description:"Accountingwebapp"
com.example.department:"Finance"
com.example.label-with-empty-value:""

build:
context:.
labels:#list
-"com.example.description=Accountingwebapp"
-"com.example.department=Finance"
-"com.example.label-with-empty-value"

network

同docker--network指令，为容器指定网络，个人理解为设定局域网
桥接可以将两个物理局域网连接起来
三种模式

build:
context:.
network:host#host模式，网络延迟最低，性能与宿主机一致

build:
context:.
network:custom_network_1#自创network

build:
context:.
network:none#无网络

shm_size

设置容器内/dev/shm目录的大小

/dev/shm目录非常重要，此目录并不在硬盘上，而是在内存中，默认大小为内存的一半大小,存入其中的文件不会被清空，容器内划分此目录可以一定程度上指定容器的性能。

build:
context:.
shm_size:'2gb'#使用字符串设置大小

build:
context:.
shm_size:10000000#设置字节大小

command

相当于Dockerfile中的CMD命令

command:bundleexecthin-p3000#shell-like

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

container_name

相当于dockerrun--name

container_name:my-web-container

depends_on

用于表述服务之间的依赖关系

在docker-composeup时，会根据depends_on来决定启动顺序

version:"3.8"
services:
web:
build:.
depends_on:#先启动db和redis
-db
-redis
redis:
image:redis
db:
image:postgres

tips：
docker-compose不会等待depends_on中的容器的状态时‘ready'时才启动，所以需要在启动完成后检查容器状态。官方给出了解决办法，使用shell脚本来曲线救国，不做赘述。

depends_ondoesnotwaitfordbandredistobe“ready”beforestartingweb-onlyuntiltheyhavebeenstarted.Ifyouneedtowaitforaservicetobeready,seeControllingstartuporderformoreonthisproblemandstrategiesforsolvingit.
----formhttps://docs.docker.com/compo...

devices

挂载的外接设备，与--devices功能相同

devices:
-"/dev/ttyUSB0:/dev/ttyUSB0"

dns

自定义dns地址

dns:8.8.8.8#单个string值

dns:#list
-8.8.8.8
-9.9.9.9

dns_search

自定义dns搜索域名

dns_search:example.com#单个string值

dns_search:
-dc1.example.com
-dc2.example.com

entrypoint

覆盖重写默认的entrypoint

entrypoint:/code/entrypoint.sh

同Dockerfile中的写法

entrypoint:["php","-d","memory_limit=-1","vendor/bin/phpunit"]

tips：
docker-compose.yaml中的entrypoint清空Dockerfile中的CMD命令，并覆盖所有的Dockerfile中的ENTRYPOINT指令。

env_file

为docker-compose.yaml添加环境变量文件。如果在docker-compose-fFILE中设置了compose文件，则env_file中的文件路径是相对于FILE的相对路径

env_file:.env#singlevalue

env_file:#list
-./common.env
-./apps/web.env
-/opt/runtime_opts.env

tips:
.env文件格式：

#SetRails/Rackenvironment#'#'为注释，
#空行会被忽略
RACK_ENV=development#格式为VAR=VAL

.env文件中的环境变量无法在build过程中被显示读取，只会被docker-compose.yaml文件读取，如果需要在build时使用该环境变量，请在build后加args子参数。

对于指定多个.env文件的情况，官网的这句话贼复杂

Keepinmindthattheorderoffilesinthelistissignificantindeterminingthevalueassignedtoavariablethatshowsupmorethanonce.
---fromhttps://docs.docker.com/compo...

直译过来是

请记住，列表中文件的顺序对于确定分配给多次显示的变量的值很重要。

因为对环境参数文件的处理是自上而下的，所以翻译成人话就是，多个参数文件中包含同一个环境变量，以最后一个为准。

environment

添加环境变量

environment:#map
RACK_ENV:development
SHOW:'true'
SESSION_SECRET:

environment:#list
-RACK_ENV=development
-SHOW=true
-SESSION_SECRET

tips:
.env文件中的环境变量无法在build过程中被显示读取，只会被docker-compose.yaml文件读取，如果需要在build时使用该环境变量，请在build后加args子参数。
次环境变量在构建镜像时，可以被我们自身的代码读取到，例如：

funcgetEnvInfo()string{
rackEnv:=os.Getenv("RACK_ENV")
fmt.Println(rackEnv)
}

output:
development

expose

暴露端口，但是仅限于服务之间的通信，暴露的是内部端口，类似Dockerfile的EXPOSE指令

expose:
-"3000"
-"8000"

~~external_links~~

~~连接服务~~

external_links:
-redis_1
-project_db_1:mysql
-project_db_1:postgresql

tips:
官方推荐使用network

extra_hosts

添加自定义域名，同--add-host

extra_hosts:
-"somehost:162.242.195.82"
-"otherhost:50.31.209.229"

也可以在容器内的/etc/hosts文件内写入

162.242.195.82somehost
50.31.209.229otherhost

healthcheck

同Dockerfile中的HEALTHCHECK指令

healthcheck:
test:["CMD","curl","-f","http://localhost"]
interval:1m30s
timeout:10s
retries:3
start_period:40s

使用disabel:true，相当于test:["NONE"]

healthcheck:
disable:true

image

指定需要拉取或使用的镜像，也可以使用仓库/标签或部分镜像ID

image:redis#默认标签latest
image:ubuntu:18.04
image:tutum/influxdb
image:example-registry.com:4000/postgresql
image:a4bc65fd

init

在容器内运行一个初始化程序，以转发信号开获取进程。

version:"3.8"
services:
web:
image:alpine:latest
init:true

tips:
使用的默认初始化二进制文件是Tini，并安装在/usr/libexec/docker-init守护程序主机上。您可以通过init-path配置选项将守护程序配置为使用自定义init二进制文件。

isolation

指定容器隔离技术，Linux只支持default,windows支持default`processhyperv`三个值，具体参考DockerEngineDocs

labels

同Dockerfile中的LABEL指令，为容器设定metadata

build:
context:.
labels:#map
com.example.description:"Accountingwebapp"
com.example.department:"Finance"
com.example.label-with-empty-value:""

build:
context:.
labels:#list
-"com.example.description=Accountingwebapp"
-"com.example.department=Finance"
-"com.example.label-with-empty-value"

links

旧版的功能，不推荐使用

logging

为当前服务设置日至参数

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

driver参数同--log-driver指令

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

tips:
只有使用json-file和journald时，docker-composeup和docker-composelogs才能看到日志，其他任何的驱动都无法看到日志打印。

指定日志设置，同dockerrun--log-opt.格式为k-v结构

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

默认的日志驱动是json-file,可以设置存储限制

options:
max-size:"200k"#单文件最大存储
max-file:"10"#文件最大数量

tips:
上述的option参数仅为json-file日志驱动支持的参数，不同驱动支持的参数各不相同，具体参照下表。

支持的驱动列表

Driver	Description
none	不输出日志。
local	日志以自定义格式存储，旨在最大程度地减少开销。
json-file	日志以自定义格式存储，旨在最大程度地减少开销。
syslog	将日志消息写入syslog设施。该syslog守护程序必须在主机上运行。
journald	将日志消息写入journald。该journald守护程序必须在主机上运行。
gelf	将日志消息写入Graylog扩展日志格式（GELF）端点，例如Graylog或Logstash。
fluentd	将日志消息写入fluentd（向前输入）。该fluentd守护程序必须在主机上运行。
awslogs	将日志消息写入AmazonCloudWatchLogs。
splunk	将日志消息写入到splunk使用HTTPEventCollector。
etwlogs	将日志消息写为Windows事件跟踪（ETW）事件。仅在Windows平台上可用。
gcplogs	将日志消息写入GoogleCloudPlatform（GCP）日志记录。
logentries	将日志消息写入Rapid7Logentries。

tips:
具体请参考Configureloggingdrivers

ports

对外暴露端口

shortsyntax:
要么指定两个端口HOST:CONTAINER，要么仅指定容器端口（选择了临时主机端口）。

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"
-"12400-12500:1240"

tips:
当以HOST:CONTAINER格式映射端口时，使用低于60的容器端口可能会报错，因为YAML会将格式xx:yy中的数字解析为以60进制的数（可以理解为时间）。因此建议始终将端口映射显式指定为字符串。

longsyntax

长语法允许出现短语法不允许出现的字段

arget：容器内的端口
published：公开暴露端口
protocol：端口协议（tcp或udp）
mode：host用于在每个节点上发布主机端口，或ingress使群集模式端口达到负载平衡。

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

restart

容器重启策略

restart:"no"#失败不重启
restart:always#失败后总是重启
restart:on-failure#错误码为on-failure时才重启
restart:unless-stopped#手动停止后不重启

secrets（待补充）

volumes

用来挂载数据卷

shortsyntax
短语法使用最简单的格式[SOURCE:]TARGET[:MODE]

SOURCE可以是宿主机地址，也可以是数据卷名。
TARGET是容器内路径。
MODE包括roforread-only和rwforread-write(默认)

如果使用宿主机的相对路径，则以docker-compose.yaml为基础进行拓展。

volumes:
#指定容器内路径，docker自动创建路径
-/var/lib/mysql

#挂载绝对路径
-/opt/data:/var/lib/mysql

#挂载相对路径
-./cache:/tmp/cache

#用户目录相对路径
-~/configs:/etc/configs/:ro

#命名挂载
-datavolume:/var/lib/mysql

longsyntax

长语法允许使用短语法无法表达的字段

type:安装类型，bind,tmpfs或者npipesource:挂载源，可以是宿主机路径，也可以是顶级挂载设置中设置好的卷名。tmpfs不适用于挂载target:容器内挂载路径read_only:设置挂载路径只读
bind:配置额外的绑定设置
- propagation:用于设置绑定的传播模式
volume:配置额外的挂载配置
- nocopy:创建卷时禁用从容器复制数据标识位
tmpfs:配置额外的tmpfs配置
- size:设置挂载tmpfs的大小（字节）
consistency:装载的一致性要求，consistent（主机和容器具有相同的视图），cached（读缓存，主机视图具有权威性）或delegated（读写缓存，容器的视图具有权威性）之一

version:"3.8"
services:
web:
image:nginx:alpine
ports:
-"80:80"
volumes:
-type:volume
source:mydata
target:/data
volume:
nocopy:true
-type:bind
source:./static
target:/opt/app/static

networks:
webnet:

volumes:
mydata:

到此这篇关于浅谈dockercompose书写规则的文章就介绍到这了,更多相关dockercompose书写规则内容请搜索毛票票以前的文章或继续浏览下面的相关文章希望大家以后多多支持毛票票！

声明：本文内容来源于网络，版权归原作者所有，内容由互联网用户自发贡献自行上传，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任。如果您发现有涉嫌版权的内容，欢迎发送邮件至：czq8825#qq.com（发邮件时，请将#更换为@）进行举报，并提供相关证据，一经查实，本站将立刻删除涉嫌侵权内容。

浅谈docker compose书写规则

热门推荐

随机推荐