Docker-Compose通过文件声明默认的环境变量

写文目的

在写本文之前,我在做一个docker-compose项目,这里需要在docker-compose.yml配置中引用到宿主机的ip,然而docker-compose并没有命令行一个输入的选项,看了些博客和官方文档,发现自己定义的如common.env中定义的键值对,只能完全当做环境变量被引用,而不是部分变量。纠结良久,又仔细看了官方文档,发现了默认的配置,docker也可用,记录作此文,备忘待查,分享与诸君。

Compose支持使用声明默认的环境变量的.env文件启动,这个文件的位置需要与docker-compose.yml同级目录,我们只需要在同级目录下创建.env文件来指定默认的环境变量,这些变量可以部分或完整作为配置的内容,大大简化我们的配置,以及一处修改多处生效的目的

语法规则

  • Compose支持.env文件中的每一行都是KEY=VAL格式
  • #开头的内容将被注释
  • 忽略空白行
  • .env中的KEY可以在docker-compose.yml中作为某个VAL的一部分

测试

这里拿个nginx做测试吧,我们最后使用docker-compose config进行查看当前环境生效的配置

新建并进入目录test,创建docker-compose.yml文件

mkdir test;cd test;vim docker-compose.yml
version: "3"
services: 
    mynginx: 
    	image: nginx:${TAG}
    	ports: 
    		- 80:80

如果我们此时直接启动docker-compose config 我们会得到如下输出

hellxz@hz:~/test$ docker-compose config
WARNING: The TAG variable is not set. Defaulting to a blank string.
services:
  mynginx:
    image: 'nginx:'
    ports:
    - 80:80/tcp
version: '3.0'

如你所见,引用的变量不存在被当成空字符串进行赋值

创建.env文件并保存

# .env the default environment config file
TAG=1.7.9

再次启动docker-compose config

hellxz@hz:~/test$ docker-compose config
services:
  mynginx:
    image: nginx:1.7.9
    ports:
    - 80:80/tcp
version: '3.0'

赋值完成。

另,这个默认的环境变量配置的优先级略低,如果是docker-compose run直接从命令行传入相同的KEY,配置文件中的值会被覆盖

posted @ 2019-06-17 14:37  东北小狐狸  阅读(10858)  评论(1编辑  收藏  举报