环境变量
100%

Docker Compose · 第 5 课

环境变量

区分 Compose 读取文件时替换进去的值,与传入容器的值。

环境变量是程序可以读取的带名称的值。Compose 可以在两个环节用到变量:读取文件时用变量的值替换表达式,也可以给容器里的程序传入值。

在文件中替换变量

把下面的内容存为练习目录中的 compose.env.yaml。其中的 ${PAGE_MODE:-demo} 表示:如果 PAGE_MODE 已设置且不为空,就使用它的值,否则使用 demo。

services:
  toolbox:
    image: busybox:1.36
    environment:
      PAGE_MODE: "${PAGE_MODE:-demo}"

Compose 会在创建容器之前解析这个表达式,这个过程叫变量插值。其他配置文件也可能用相同的方法选择主机端口或镜像标签。

如果没有设置 PAGE_MODE,展开后的配置会出现什么值?

查看解析出来的值

在命令前面为变量赋值,可以只为这次运行设置变量。用这个方法看看换一个值会有什么效果。config 命令会显示解析后的配置,不会创建容器。

$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml config

在服务的环境变量设置中查找 PAGE_MODE: review。review 只是演示值。不要把机密信息写进示例配置,也不要在输出里打印机密信息。

展开后的配置显示 review。现在已经发生了什么?

把值传入容器

environment 部分会把解析出的设置传入新容器。用 printenv 让这个一次性容器里的程序输出变量值。

$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml run --rm toolbox printenv PAGE_MODE

预期输出是 review。变量插值选出了这个值,环境变量配置又把这个值传入容器。如果变量只用来选择主机端口,它不会自动出现在程序的环境变量中。

用什么操作可以确认工具容器里的程序收到了哪个值?

课程已完成

你已完成 环境变量

现在,你可以区分环境变量的两种用途。

  • 读懂 Compose 文件中的默认值表达式。

  • 启动容器前查看解析后的配置。

  • 检查已启动程序的环境变量值。

保存学习进度

创建免费账户即可保存本课进度,并在任意设备上继续学习。

创建免费账户
下一节
返回 Docker Compose