CLI环境变量
有几个环境变量可供您配置Docker Compose命令行行为。
DOCKER_
开头的变量与Docker命令行客户端配置的变量相同。
注意:还可以使用环境文件提供其中一些变量 。
COMPOSE_PROJECT_NAME
设置项目名称。启动时,此值将与服务名称一起添加到容器中。
例如,如果你的项目名称为myapp
,它包括两个服务db
和web
,然后容器名分别为 myapp_db_1
和myapp_web_1
。
设置此选项是可选的。如果未设置此项,则COMPOSE_PROJECT_NAME
默认为basename
项目目录。另请参阅-p
命令行选项。
COMPOSE_FILE
指定Compose文件的路径。如果未提供,Compose将查找当前目录中名为 docker-compose.yml
的指定文件,然后查找 每个父目录,直到找到该名称的文件。
此变量支持由路径分隔符分隔的多个Compose文件(在Linux和macOS上,路径分隔符是:
在Windows上;
)。例如: COMPOSE_FILE=docker-compose.yml:docker-compose.prod.yml
。路径分隔符也可以使用COMPOSE_PATH_SEPARATOR
进行自定义。
另请参阅-f
命令行选项。
COMPOSE_API_VERSION
Docker API仅支持来自报告特定版本的客户端的请求。如果使用 docker-compose
报错:client and server don't have same version
,则可以通过设置此环境变量来解决此错误。设置版本值以匹配服务器版本。
设置此变量旨在解决在需要在客户端和服务器版本不匹配的情况下临时运行的情况。例如,如果您可以升级客户端但需要等待升级服务器。
使用此变量集和已知的不匹配运行会阻止某些Docker功能正常工作。失败的确切功能取决于Docker客户端和服务器版本。因此,使用此变量集运行仅用作解决方法,并且不受官方支持。
如果您遇到运行此设置的问题,请通过升级解决不匹配问题,并在通知支持之前删除此设置以查看问题是否已解决。
DOCKER_HOST
设置docker
守护程序的URL 。与Docker客户端一样,默认为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
,TLSv1_1
,TLSv1_2
。
COMPOSE_CONVERT_WINDOWS_PATHS
在卷定义中启用从Windows样式到Unix样式的路径转换。Windows上的Docker Machine和Docker Toolbox的用户应始终设置此项。默认为0
。支持的值:true
或1
启用false
或0
禁用。
COMPOSE_PATH_SEPARATOR
如果设置,COMPOSE_FILE
则使用此字符作为路径分隔符分隔环境变量的值。
COMPOSE_FORCE_WINDOWS_HOST
如果设置,使用量声明短语法 解析假设主机路径是Windows路径,即使是撰写基于UNIX的系统上运行。支持的值:true
或1
启用false
或0
禁用。
COMPOSE_IGNORE_ORPHANS
如果设置,Compose不会尝试检测项目的孤立容器。支持的值:true
或1
启用false
或0
禁用。
COMPOSE_PARALLEL_LIMIT
设置Compose可以并行执行的操作数限制。默认值为64
,并且可能不会设置为低于2
。
COMPOSE_INTERACTIVE_NO_CLI
如果设置,Compose不会尝试使用Docker CLI进行交互run
和exec
操作。在上述操作需要CLI的Windows上,此选项不可用。支持:true
或1
启用false
或0
禁用。