详解Docker Compose 中可用的环境变量问题

Compose 的多个部分在某种情况下处理环境变量。本教程可以帮助你找到所需的信息。

1. 替换Compose文件中的环境变量

可以使用 shell 中的环境变量填充 Compose 文件中的值:

web:
 image: "webapp:${TAG}"

更多信息请参考 Compose 文件手册中的 Variable substitution章节。

2. 设置容器中的环境变量

可以通过 environment 关键字设置服务容器中的环境变量,就跟使用 docker run -e VARIABLE=VALUE ... 一样:

web:
 environment:
 - DEBUG=1

3. 将环境变量传递到容器

在使用 environment 关键字时不赋值,就可以将 shell 中的环境变量传递给服务容器,就跟使用 docker run -e VARIABLE ... 一样:

web:
 environment:
 - DEBUG

容器中的 DEBUG 变量的值从运行 Compose 的 shell 中的同名变量中获取。

4. “env_file”配置选项

可以通过 env_file 命令使用外部文件将多个环境变量传递到服务容器,就跟使用 docker run --env-file=FILE ... 一样:

web:
 env_file:
 - web-variables.env

5. 使用 ‘docker-compose run'设置环境变量

就像 docker run -e 命令一样,可以使用 docker-compose run -e 设置一次性容器上的环境变量:

docker-compose run -e DEBUG=1 web python console.py

也可以通过从 shell 中传递一个变量,而不是直接赋值:

docker-compose run -e DEBUG web python console.py

容器中的 DEBUG 变量的值从运行 Compose 的 shell 中的同名变量中获取。

6. “.env”文件

可以在名为.env 的环境文件 中为 Compose 文件中引用的任何环境变量设置默认值,或者用于配置 Compose:

$ cat .env
TAG=v1.5

$ cat docker-compose.yml
version: '3'
services:
 web:
 image: "webapp:${TAG}"

运行 docker-compose up 时,上面定义的 web 服务使用 webapp:v1.5 镜像。可以通过config 命令 将应用程序的配置信息打印到终端来验证:

$ docker-compose config

version: '3'
services:
 web:
 image: 'webapp:v1.5'

shell 中的值优先于 .env 文件中指定的值。如果在 shell 中将 TAG 设置为不同的值,则镜像中将使用该值:

$ export TAG=v2.0
$ docker-compose config

version: '3'
services:
 web:
 image: 'webapp:v2.0'

当在多个文件中设置相同的环境变量时,以下是 Compose 用于选择要使用的值的优先级:

  • Compose 文件
  • Environment 文件
  • Dockerfile
  • 变量未定义

在下面的例子中,我们在 Environment 文件和 Compose 文件上设置了相同的环境变量:

$ cat ./Docker/api/api.env
NODE_ENV=test

$ cat docker-compose.yml
version: '3'
services:
 api:
 image: 'node:6-alpine'
 env_file:
  - ./Docker/api/api.env
 environment:
  - NODE_ENV=production

运行容器时,在 Compose 文件中定义的环境变量优先。

$ docker-compose exec api node

process.env.NODE_ENV
'production'

只有在 environment env_file 没有 Docker Compose 条目时,Dockerfile 中的任何 ARG ENV 设置才会评估(evaluate)。

NodeJS 容器的细节

如果你有脚本的 package.json 条目像 NODE_ENV=test node server.js 一样启动,那么这将覆盖 docker-compose.yml 文件中的任何设置。

7. 使用环境变量配置 Compose

有几个环境变量可用来配置 Docker Compose 命令行行为。它们以 COMPOSE_ 或 DOCKER_ 开头,并记录在CLI 环境变量中

8. 通过 link 创建环境变量

在第一版 Compose 文件中使用 links选项时,会为每个链接创建环境变量。它们记录在 Link环境变量参考 中。

但是,这些变量已被弃用。link 改为为主机创建别名。

原文地址

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持我们。

(0)

相关推荐

  • Docker Compose引用环境变量的方法示例

    在项目中,往往需要在 docker-compose.yml 文件中使用环境变量来控制不同的条件和使用场景.本文集中介绍 docker compose 引用环境变量的方式. 说明:本文的演示环境为 ubuntu 16.04. Compose CLI 与环境变量 Compose CLI(compose command-line 即 docker-compose 程序)能够识别名称为 COMPOSE_PROJECT_NAME 和 COMPOSE_FILE 等环境变量(具体支持的环境变量请参考这里).比

  • docker中的环境变量使用与常见问题解决方案

    前言 docker可以为容器配置环境变量.配置的途径有两种: 在制作镜像时,通过ENV命令为镜像增加环境变量.在容器启动时使用该环境变量. 在容器启动时候,通过参数配置环境变量,如果与镜像中有重复的环境变量,会覆盖镜像的环境变量. 使用docker exec {containerID} env即可查看容器中生效的环境变量. [root@localhost ~]# docker exec 984 env PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/

  • 详解Docker Compose 中可用的环境变量问题

    Compose 的多个部分在某种情况下处理环境变量.本教程可以帮助你找到所需的信息. 1. 替换Compose文件中的环境变量 可以使用 shell 中的环境变量填充 Compose 文件中的值: web: image: "webapp:${TAG}" 更多信息请参考 Compose 文件手册中的 Variable substitution章节. 2. 设置容器中的环境变量 可以通过 environment 关键字设置服务容器中的环境变量,就跟使用 docker run -e VARI

  • 详解docker compose搭建lnmpr环境实现

    目录 使用docker-compose搭建lnmpr环境 介绍 软件架构 Compose 简介 具体文件内容docker-compose.yml 使用说明 使用docker-compose搭建lnmpr环境 本文环境 docker20.10,PHP8.1(含扩展)+ Nginx1.22 + MySQL8.0 + Mongo6.0 + Redis6.0 + Swoole2.0 介绍 docker-compose搭建PHP8.1(含扩展)+ Nginx1.22 + MySQL8.0 + Mongo6

  • 详解Docker Compose配置文件参数

    目录 1. image 2. build 3. command 4.container_name 5.depends_on 6.dns 7. tmpfs 8. entrypoint 9.env_file 10. environment 11. expose 12. external_links 13. extra_hosts 14. labels 15. links 16. logging 17. pid 18. ports 19. security_opt 20. stop_signal 21

  • 详解Go语言中的作用域和变量隐藏

    目录 前言 包隐藏 全局变量 类型强制 闭包 := 的情况 总结 前言 变量隐藏在 Go 中可能会令人困惑,让我们尝试弄清楚. package main import ( "fmt" "io/ioutil" "log" ) func main() { f, err := ioutil.TempFile("", "") if err != nil { log.Fatal(err) } defer f.Clos

  • 详解docker compose 用法

    docker compose的使用场景 我们开发的时候,一个应用往往依赖多个服务.采用传统的docker run方式,要挨个启动多个服务,甚至需要配置对应的网络,过程比较繁琐,很不方便. docker compose旨在通过将多服务的构建和依赖关系都编写在docker-compose.yml中,通过docker-compose命令,即可完成对整个服务集群的启动,关闭等操作. 一个基本的demo演示 demo的功能是一个简单的python程序,暴露一个web服务.该服务用于统计当前服务被访问的次数

  • 详解Docker下搭建Jenkins构建环境

    首先需要搭建好docker环境的linux系统,这个教程多如牛毛,在此不再赘述. 然后编写一个dockerfile来生成一个镜像,dockerfile其实就是一系列命令的集合,有点像windows的批处理文件, 搭建Jenkins构建环境需要安装jdk.maven.tomcat.jenkins,另外还安装了GIT,用来构建GIT来源的代码,内容如下: FROM centos:7 # author info MAINTAINER xulijian 514045152@qq.com # instal

  • 详解Swift编程中的常量和变量

    常量 常量指的是程序无法在其执行期间改变的固定值. 常量可以是任何像整型常量,浮点常量,字符常量或字符串的基本数据类型.也可以是枚举常量. 这些常量和常规变量处理一样,只是它们的值不能在定义后进行修改. 声明常量 使用常量时,则必须使用关键字 let 声明它们如下: 复制代码 代码如下: let constantName = <initial value> 下面是一个简单的例子来说明如何在 Swift 中声明一个常量: 复制代码 代码如下: import Cocoa let constA =

  • 详解Golang编程中的常量与变量

    Go语言常量 常量是指该程序可能无法在其执行期间改变的固定值.这些固定值也被称为文字. 常量可以是任何像一个整型常量,一个浮点常量,字符常量或字符串文字的基本数据类型.还有枚举常量. 常量是一样,只是它们的值不能自己定义后进行修改常规变量处理. 整型常量 一个整数文字可以是十进制,八进制,或十六进制常数.前缀指定基或基数:0x或0X的十六进制,0表示八进制,并没有为十进制. 一个整数文字也可以有一个后缀为U和L的组合,分别为无符号和长整型.后缀可以是大写或小写,并且可以以任意顺序. 这里是整数常

  • 详解C语言中的符号常量、变量与算术表达式

    C语言中的符号常量 在结束讨论温度转换程序前,我们再来看一下符号常量.在程序中使用 300.20 等类似的"幻数"并不是一个好习惯,它们几乎无法向以后阅读该程序的人提供什么信息,而且使程序的修改变得更加困难.处理这种幻数的一种方法是赋予它们有意义的名字.#define 指令可以把符号名(或称为符号常量)定义为一个特定的字符串: #define 名字 替换文本 在该定义之后,程序中出现的所有在 #define 中定义的名字(既没有用引号引起来,也不是其它名字的一部分)都将用相应的替换文本

  • 详解Java枚举类在生产环境中的使用方式

    目录 前言 使用 1.确定业务场景状态 2.定义枚举类 3.自定义查询方法 4.测试效果 总结 前言   Java枚举在项目中使用非常普遍,许多人在做项目时,一定会遇到要维护某些业务场景状态的时候,往往会定义一个常量类,然后添加业务场景相关的状态常量.但实际上,生产环境的项目中业务状态的定义大部分是由枚举类来完成的,因为更加清晰明确,还能自定义不同的方法来获取对应的业务状态值,十分方便. 以下代码均为生产环境已上线项目的代码片段,仅供参考. 使用 大体分为确定业务场景状态.定义枚举类.自定义查询

随机推荐