附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不支持此项。

默认值:

举例:

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

扫码关注云+社区

领取腾讯云代金券