附004.Docker Compose环境变量说明

一 环境变量概述

Compose支持在docker-compose执行命令的文件夹中，名为.env的环境变量配置文件声明默认环境变量。

二 定义变量

2.1 语法规则

• Compose建议env文件中的每一行都是VAR=VAL格式。
• 以#开头的行将作为注释处理并被忽略。
• 空行被忽略。
• 没有特殊的引号处理。

2.2 变量定义

COMPOSE_PROJECT_NAME

意义：设置项目名称，启动时，此值将与服务名称一起添加到容器中，如项目名称为myapp，它包括两个服务db和web，然后开始撰写名为容器 myapp_db_1和myapp_web_1分别。

参数：可选，可自定义名称。

默认值：默认为当前执行命令所在目录名。

举例：COMPOSE_PROJECT_NAME=myapp

COMPOSE_FILE

意义：指定Compose文件的路径。

参数：可选，可指定引用外部yml配置，支持由:分隔符分隔的多个Compose文件。

默认值：默认Compose将查找当前目录中的docker-compose.yml文件，然后查找每个父目录，直到找到该名称的文件。

举例：COMPOSE_FILE=docker-compose.yml:docker-compose.prod.yml

COMPOSE_API_VERSION

意义：Docker API仅支持来自报告特定版本的客户端的请求，若提示client and server don't have same version，则表示使用版本不一致，可以通过设置此环境变量来设置版本值以匹配服务器版本。

参数：

默认值：

举例：

DOCKER_HOST

意义：设置docker守护程序的URL 。

参数：

默认值：unix:///var/run/docker.sock

举例：

DOCKER_TLS_VERIFY

意义：启用与docker守护程序的TLS通信。

参数：

默认值：

举例：

DOCKER_CERT_PATH

意义：配置路径ca.pem，cert.pem以及key.pem用于TLS验证文件。

参数：

默认值：~/.docker

举例：

COMPOSE_HTTP_TIMEOUT

意义：配置在Compose认为失败之前允许挂起对Docker守护程序的请求的时间（以秒为单位）。

参数：

默认值：60秒

举例：

COMPOSE_TLS_VERSION

意义：配置使用哪个TLS版本用于与docker守护程序进行TLS通信。

参数：支持的值是：TLSv1，TLSv1_1，TLSv1_2。

默认值：TLSv1

举例：

COMPOSE_CONVERT_WINDOWS_PATHS

意义：在卷定义中启用从Windows样式到Unix样式的路径转换。Windows上的Docker Machine和Docker Toolbox的用户应始终设置此项。

参数：支持的值：true或1启用false或0禁用。

默认值：0

举例：

COMPOSE_PATH_SEPARATOR

意义：定义多Compose配置文件的分隔符。

参数：可选，可自定义名称。

默认值：：

举例：

COMPOSE_FORCE_WINDOWS_HOST

意义：

参数：

默认值：

举例：

COMPOSE_IGNORE_ORPHANS

意义：定义Compose是否尝试检测项目的孤立容器。

参数：支持的值：true或1启用false或0禁用。

默认值：

举例：

COMPOSE_PARALLEL_LIMIT

意义：设置Compose可以并行执行的操作数限制。

参数：不能低于2的数值

默认值：64

举例：

COMPOSE_INTERACTIVE_NO_CLI

意义：定义Compose是否使用Docker CLI进行交互run和exec操作。

参数：支持：true或1启用false或0禁用，Windows不支持此项。

默认值：

举例：