组合多个docker-compose文件

一个服务,一般有开发、集成、测试、生产等多个环境。 在不同环境下,往往又需要不同的配置。 这时,一个docker-compose.yml文件就难以应付了。 不过,它通过扩展(Extending),对此提供了支持。

Using multiple Compose files enables you to customize a Compose application for different environments or different workflows.

参考:Share Compose configurations between files and projects | Docker Documentation

docker-compose.override.yml

以下以一个docker-compose.ymldocker-compose.override.yml为例,展示override的用法。

version: '3'

services:
  nginx:
    image: nginx:stable-alpine
    ports:
      - 127.0.0.1:8080:80
    environment:
      - TEST_0=0
      - DEBUG=true

新建一个test目录,把以上内容写入其中。 当只有一个docker-compose.yml时,启动后会使用8080端口。

$ docker-compose up -d
Creating network "test_default" with the default driver
Creating test_nginx_1 ... done
$ docker-compose ps
    Name             Command          State                    Ports
-------------------------------------------------------------------------------------
test_nginx_1   nginx -g daemon off;   Up      0.0.0.0:8080->80/tcp,0.0.0.0:80->80/tcp
docker-compose exec nginx sh
/ # echo $TEST_0
0
/ # echo $DEBUG
true

如果再增加一个docker-compose.override.yml,那么情况会发生变化。

version: '3'

services:
  nginx:
    ports:
      - 80:80
    environment:
      - TEST_1=1
      - DEBUG=false

运行结果如下:

$ docker-compose down
Stopping test_nginx_1 ... done
Removing test_nginx_1 ... done
Removing network test_default
$ docker-compose up -d
Creating network "test_default" with the default driver
Creating test_nginx_1 ... done
$ docker-compose ps
    Name             Command          State                     Ports
---------------------------------------------------------------------------------------
test_nginx_1   nginx -g daemon off;   Up      0.0.0.0:80->80/tcp,127.0.0.1:8080->80/tcp
$ docker-compose exec nginx sh
/ # echo $TEST_0
0
/ # echo $TEST_1
1
/ # echo $DEBUG
false

执行结果是二者的并集。 相同的部分,并非简单的override的关系,而是先后执行。 $DEBUG变成false,不是因为二取一,而是因为docker-compose.override.yml后执行,环境变量被第二次赋值所覆盖。 如果对外部的同一个port进行操作,比如docker-compose.override.yml也使用8080端口,程序就会报错。

$ docker-compose up -d
Creating network "test_default" with the default driver
Creating test_nginx_1 ... error

ERROR: for test_nginx_1  Cannot start service nginx: driver failed programming external connectivity on endpoint test_nginx_1 (c07b1fba8aa720b19fce92053f5b21bf5d8f87816364402032e2401914497601): Error starting userland proxy: listen tcp 0.0.0.0:8080: bind: address already in use

ERROR: for nginx  Cannot start service nginx: driver failed programming external connectivity on endpoint test_nginx_1 (c07b1fba8aa720b19fce92053f5b21bf5d8f87816364402032e2401914497601): Error starting userland proxy: listen tcp 0.0.0.0:8080: bind: address already in use
ERROR: Encountered errors while bringing up the project.

多个-f参数

其实,以上现象,相当于:

docker-compose \
    -f docker-compose.yml \
    -f docker-compose.override.yml \
    up

如果希望docker-compose.yml反过来覆盖docker-compose.override.yml,可以这样执行:

$ docker-compose -f docker-compose.override.yml -f docker-compose.yml up -d
Creating network "test_default" with the default driver
Creating test_nginx_1 ... done
$ docker-compose exec nginx sh
/ # echo $DEBUG
true

多个-f参数,可以指定compose文件的组合顺序,也就可以控制override关系。

总结

需要注意的是,override只对默认的docker-compose.yml(或docker-compose.yaml)生效。 docker-compose.yml作为提交到代码库的东西,有些不方便直接配置的东西, 比如生产环境的密码、生产环境相关的资源配置等,这些都可以通过override的扩展来代为配置。 在不同的环境,可以写不同的docker-compose.override.yml。 这样,就可以实现开发、集成、测试、生产等不同环境的不同要求。

除了override以外,同样可以自定义若干YAML文件,甚至不以docker-compose为名,利用-f进行组合来达成相同目的。 虽然不太方便,但这样更灵活。 即使不使用扩展机制,也可以把所有服务分成多组,放在不同的YAML文件中,实现更灵活的按需启动。


相关笔记