编写CLI环境变量

预计阅读时间:4分钟

可以使用几个环境变量来配置Docker Compose命令行行为。

以开头的变量与DOCKER_用于配置Docker命令行客户端的变量相同。如果使用docker-machine,则eval "$(docker-machine env my-docker-vm)"命令应将它们设置为正确的值。(在此示例中,my-docker-vm是您创建的计算机的名称。)

注意:还可以使用环境文件来提供其中的一些变量 。

COMPOSE_PROJECT_NAME

设置项目名称。启动时,此值与服务名称一起添加到容器中。例如,如果您的项目名称为,myapp并且其中包括两个服务dbweb,则Compose分别启动名为myapp_db_1和的容器 myapp_web_1

设置此为可选。如果未设置,则COMPOSE_PROJECT_NAME 默认为basename项目目录的。另请参阅-p 命令行选项

COMPOSE_FILE

指定撰写文件的路径。如果未提供,则Compose会docker-compose.yml在当前目录中依次查找一个名为的文件,然后依次查找 每个父目录,直到找到具有该名称的文件为止。

此变量支持多个用路径分隔符分隔的Compose文件(在Linux和macOS上,路径分隔符为:,在Windows上为;)。例如: COMPOSE_FILE=docker-compose.yml:docker-compose.prod.yml。路径分隔符也可以使用进行自定义COMPOSE_PATH_SEPARATOR

另请参阅-f 命令行选项

COMPOSE_PROFILES

指定一个或多个要启用的活动配置文件。调用docker-compose upCOMPOSE_PROFILES=frontend将开始与配置文件中的服务 frontend和服务,而不指定配置文件。

您可以指定以逗号分隔的配置文件列表: COMPOSE_PROFILES=frontend,debug将启用配置文件frontenddebug

另请参阅将配置文件与Compose--profile 命令行选项结合使用

COMPOSE_API_VERSION

Docker API仅支持来自报告特定版本的客户端的请求。如果client and server don't have same version使用收到错误 docker-compose,则可以通过设置此环境变量来解决此错误。设置版本值以匹配服务器版本。

设置此变量的目的是为了解决需要在客户端版本与服务器版本之间不匹配的情况下临时运行的情况。例如,如果您可以升级客户端,但是需要等待服务器升级。

在使用此变量集并已知不匹配的情况下运行,确实会阻止某些Docker功能正常运行。失败的确切功能将取决于Docker客户端和服务器版本。因此,使用此变量集运行仅是一种变通办法,并且不受官方支持。

如果在使用此设置运行时遇到问题,请通过升级解决不匹配问题,并删除此设置以在通知支持之前查看问题是否解决。

DOCKER_HOST

设置docker守护程序的URL 。与Docker客户端一样,默认为unix:///var/run/docker.sock

DOCKER_TLS_VERIFY

设置为空字符串以外的任何其他值时,将启用与docker守护程序的TLS通信。

DOCKER_CERT_PATH

配置路径ca.pemcert.pem以及key.pem用于TLS验证文件。默认为~/.docker

COMPOSE_HTTP_TIMEOUT

配置在Compose认为失败之前允许对Docker守护程序的请求挂起的时间(以秒为单位)。默认为60秒。

COMPOSE_TLS_VERSION

配置使用哪个TLS版本与docker 守护程序进行TLS通信。默认为TLSv1。支持的值是:TLSv1TLSv1_1TLSv1_2

COMPOSE_CONVERT_WINDOWS_PATHS

在卷定义中启用从Windows样式到Unix样式的路径转换。Windows上Docker Machine的用户应始终对此进行设置。默认为0。支持的值:true1启用false0禁用。

COMPOSE_PATH_SEPARATOR

如果设置,COMPOSE_FILE则使用此字符作为路径分隔符分隔环境变量的值。

COMPOSE_FORCE_WINDOWS_HOST

如果设置了该属性, 则即使Compose在基于UNIX的系统上运行,也将假定主机路径为Windows路径,使用短语法来解析卷声明。支持的值:true1启用false0禁用。

COMPOSE_IGNORE_ORPHANS

如果设置,则Compose不会尝试检测项目的孤立容器。支持的值:true1启用false0禁用。

COMPOSE_PARALLEL_LIMIT

设置Compose可以并行执行的操作数的限制。默认值为64,并且不得设置为低于2

COMPOSE_INTERACTIVE_NO_CLI

如果设置,Compose不会尝试使用Docker CLI进行交互runexec操作。在上述操作需要CLI的Windows上,此选项不可用。支持:true1启用,false0禁用。

COMPOSE_DOCKER_CLI_BUILD

配置是使用Compose python客户端构建映像还是使用本机docker cli。默认情况下,Compose使用dockerCLI来执行构建,这使您可以使用BuildKit 来执行构建。

设置COMPOSE_DOCKER_CLI_BUILD=0为禁用本机版本,并使用内置的python客户端。

无花果组成撰写码头工人编排cli参考