环境插值

在使用 Rancher Compose 时，docker-compose.yml 和 rancher-compose.yml 文件中可以使用运行 Rancher Compose 的机器中的环境变量。这个特性只在 Rancher Compose 命令中有效，在 Rancher UI 中是没有这个特性的。

怎么使用

在 docker-compose.yml 和 rancher-compose.yml 文件中，您可以引用您机器中的环境变量。如果没有该环境变量，它的值会被替换为空字符串，请注意的是 Rancher Compose 不会自动去除 : 两侧的空字符来适配相近的镜像。例如 <imagename>: 是一个非法的镜像名称，不能部署出容器。它需要用户自己来保证环境变量在该机器上是存在并有效的。

例子

在我们运行 Rancher Compose 的机器上有一个这样的环境变量，IMAGE_TAG=14.04 。

  1. # Image tag is set as environment variable
  2. $ env | grep IMAGE
  3. IMAGE_TAG=14.04
  4. # Run Rancher Compose
  5. $ rancher-compose up

样例文件 docker-compose.yml

  1. version: '2'
  2. services:
  3.   ubuntu:
  4.     tty: true
  5.     image: ubuntu:$IMAGE_TAG
  6.     stdin_open: true

在 Rancher 里，一个 ubuntu 服务会使用镜像 ubuntu:14.04 部署。

环境插值格式

Rancher Compose 支持和 Docker Compose 一样的格式。

  1. version: '2'
  2. services:
  3.   web:
  4.     # unbracketed name
  5.     image: "$IMAGE"
  6.  
  7.     # bracketed name
  8.     command: "${COMMAND}"
  9.  
  10.     # array element
  11.     ports:
  12.     - "${HOST_PORT}:8000"
  13.  
  14.     # dictionary item value
  15.     labels:
  16.       mylabel: "${LABEL_VALUE}"
  17.  
  18.     # unset value - this will expand to "host-"
  19.     hostname: "host-${UNSET_VALUE}"
  20.  
  21.     # escaped interpolation - this will expand to "${ESCAPED}"
  22.     command: "$${ESCAPED}"