Docker Compose如何引用環境變量

今天小編給大家分享一下Docker Compose如何引用環境變量的相關知識點，內容詳細，邏輯清晰，相信大部分人都還太了解這方面的知識，所以分享這篇文章給大家參考一下，希望大家閱讀完這篇文章后有所收獲，下面我們一起來了解一下吧。

說明：本文的演示環境為 ubuntu 16.04。

compose cli 與環境變量

compose cli(compose command-line 即 docker-compose 程序)能夠識別名稱為 compose_project_name 和 compose_file 等環境變量(具體支持的環境變量請參考)。比如我們可以通過這兩個環境變量為 docker-compose 指定 project 的名稱和配置文件：

$ export compose_project_name=testvar
$ export compose_file=~/projects/composecounter/docker-compose.yml

然后啟動應用，顯示的 project 名稱都是我們在環境變量中指定的：

如果設置了環境變量的同時又指定了命令行選項，那么會應用命令行選項的設置：

$ docker-compose -p nickproject up -d

在 compose file 中引用環境變量

我們還可以在 compose file 中直接引用環境變量，比如下面的 demo：

version: '3'
 services:
 web:
  image: ${imagetag}
  ports:
  - "5000:5000"
 redis:
  image: "redis:alpine"

我們通過環境變量 ${imagetag} 指定了 web 的鏡像，下面通過 export 的方式來為 compose 配置文件中的環境變量傳值：

注意，如果對應的環境變量沒有被設置，那么 compose 就會把它替換為一個空字符串：

碰到這種情況，我們可以在 compose 的配置文件中為該變量設置一個默認值：

version: '3'
services:
 web:
 image: ${imagetag:-defaultwebimage}
 ports:
  - "5000:5000"
 redis:
 image: "redis:alpine"

這樣，如果沒有設置 imagetag 變量，就會應用 defaultwebimage：

除了這種方式，我們還可以通過后面將介紹的 .env 文件來為環境變量設置默認值。

把環境變量傳遞給容器

先來看一下在 compose file 中如何為容器設置環境變量：

web:
 environment:
 debug: 1

compose file 中的 environment 節點用來為容器設置環境變量，上面的寫法等同于：

$ docker run -e debug=1

要把當前 shell 環境變量的值傳遞給容器的環境變量也很簡單，去掉上面代碼中的賦值部分就可以了：

web:
 environment:
 debug:

這種情況下，如果沒有在當前的 shell 中導出環境變量 debug，compose file 中會把它解釋為 null：

在試試導出環境變量 debug 的情況：

$ export debug=1

這才是我們設計的正確的使用場景！

使用文件為容器設置多個環境變量

如果覺得通過 environment 為容器設置環境變量不夠過癮，我們還可以像 docker -run 的 --env-file 參數一樣通過文件為容器設置環境變量：

web:
 env_file:
 - web-variables.env

注意，web-variables.env 文件的路徑是相對于 docker-compose.yml 文件的相對路徑。上面的代碼效果與下面的代碼相同：

$ docker run --env-file=web-variables.env

web-variables.env 文件中可以定義一個或多個環境變量：

# define web container env
appname=helloworld
author=nick li
version=1.0

檢查下結果：

原來 compose 把 env_file 的設置翻譯成了 environment！

.env 文件

當我們在 docker-compose.yml 文件中引用了大量的環境變量時，對每個環境變量都設置默認值將是繁瑣的，并且也會影響 docker-compose.yml 簡潔程度。此時我們可以通過 .env 文件來為 docker-compose.yml 文件引用的所有環境變量設置默認值！
修改 docker-compose.yml 文件的內容如下：

version: '3'
services:
 web:
 image: ${imagetag}     
 environment:
  appname:
  author:
  version:
 ports:
  - "5000:5000"
 redis:
 image: "redis:alpine"

然后在相同的目錄下創建 .env 文件，編輯其內容如下：

# define env var default value.
imagetag=defaultwebimage
appname=default app name
author=default author name
version=default version is 1.0

檢查下結果，此時所有的環境變量都顯示為 .env 文件中定義的默認值：

配置不同場景下的環境變量

從前面的部分中我們可以看到，docker compose 提供了足夠的靈活性來讓我們設置 docker-compose.yml 文件中引用的環境變量，它們的優先級如下：

1. compose file

2. shell environment variables

3. environment file

4. dockerfile

5. variable is not defined

首先，在 docker-compose.yml 文件中直接設置的值優先級是最高的。
然后是在當前 shell 中 export 的環境變量值。
接下來是在環境變量文件中定義的值。
再接下來是在 dockerfile 中定義的值。
最后還沒有找到相關的環境變量就認為該環境變量沒有被定義。

根據上面的優先級定義，我們可以把不同場景下的環境變量定義在不同的 shell 腳本中并導出，然后在執行 docker-compose 命令前先執行 source 命令把 shell 腳本中定義的環境變量導出到當前的 shell 中。通過這樣的方式可以減少維護環境變量的地方，下面的例子中我們分別在 docker-compose.yml 文件所在的目錄創建 test.sh 和 prod.sh，test.sh 的內容如下：

#!/bin/bash
# define env var default value.
export imagetag=web:v1
export appname=helloworld
export author=nick li
export version=1.0

prod.sh 的內容如下：

#!/bin/bash
# define env var default value.
export imagetag=webpord:v1
export appname=helloworldprod
export author=nick li
export version=1.0lts

在測試環境下，執行下面的命令：

$ source test.sh
$ docker-compose config

此時 docker-compose.yml 中的環境變量應用的都是測試環境相關的設置。

而在生產環境下，執行下面的命令：

$ source prod.sh
$ docker-compose config

此時 docker-compose.yml 中的環境變量應用的都是生產環境相關的設置。

以上就是“Docker Compose如何引用環境變量”這篇文章的所有內容，感謝各位的閱讀！相信大家閱讀完這篇文章都有很大的收獲，小編每天都會為大家更新不同的知識，如果還想學習更多的知識，請關注億速云行業資訊頻道。