CLI環(huán)境變量
有幾個環(huán)境變量可供您配置Docker Compose命令行行為。
DOCKER_ 開頭的變量與Docker命令行客戶端配置的變量相同。
注意:還可以使用環(huán)境文件提供其中一些變量 。
COMPOSE_PROJECT_NAME
設(shè)置項目名稱。啟動時,此值將與服務(wù)名稱一起添加到容器中。
例如,如果你的項目名稱為myapp,它包括兩個服務(wù)db和web,然后容器名分別為 myapp_db_1和myapp_web_1。
設(shè)置此選項是可選的。如果未設(shè)置此項,則COMPOSE_PROJECT_NAME 默認(rèn)為basename項目目錄。另請參閱-p 命令行選項。
COMPOSE_FILE
指定Compose文件的路徑。如果未提供,Compose將查找當(dāng)前目錄中名為 docker-compose.yml的指定文件,然后查找 每個父目錄,直到找到該名稱的文件。
此變量支持由路徑分隔符分隔的多個Compose文件(在Linux和macOS上,路徑分隔符是:在Windows上;)。例如: COMPOSE_FILE=docker-compose.yml:docker-compose.prod.yml。路徑分隔符也可以使用COMPOSE_PATH_SEPARATOR 進(jìn)行自定義。
另請參閱-f 命令行選項。
COMPOSE_API_VERSION
Docker API僅支持來自報告特定版本的客戶端的請求。如果使用 docker-compose 報錯:client and server don't have same version,則可以通過設(shè)置此環(huán)境變量來解決此錯誤。設(shè)置版本值以匹配服務(wù)器版本。
設(shè)置此變量旨在解決在需要在客戶端和服務(wù)器版本不匹配的情況下臨時運行的情況。例如,如果您可以升級客戶端但需要等待升級服務(wù)器。
使用此變量集和已知的不匹配運行會阻止某些Docker功能正常工作。失敗的確切功能取決于Docker客戶端和服務(wù)器版本。因此,使用此變量集運行僅用作解決方法,并且不受官方支持。
如果您遇到運行此設(shè)置的問題,請通過升級解決不匹配問題,并在通知支持之前刪除此設(shè)置以查看問題是否已解決。
DOCKER_HOST
設(shè)置docker守護程序的URL 。與Docker客戶端一樣,默認(rèn)為unix:///var/run/docker.sock。
DOCKER_TLS_VERIFY
設(shè)置為空字符串以外的任何內(nèi)容時,啟用與docker守護程序的TLS通信。
DOCKER_CERT_PATH
配置路徑ca.pem,cert.pem以及key.pem用于TLS驗證文件。默認(rèn)為~/.docker。
COMPOSE_HTTP_TIMEOUT
配置在Compose認(rèn)為失敗之前允許掛起對Docker守護程序的請求的時間(以秒為單位)。默認(rèn)為60秒。
COMPOSE_TLS_VERSION
配置哪個TLS版本用于與docker 守護程序進(jìn)行TLS通信。默認(rèn)為TLSv1。支持的值是:TLSv1,TLSv1_1,TLSv1_2。
COMPOSE_CONVERT_WINDOWS_PATHS
在卷定義中啟用從Windows樣式到Unix樣式的路徑轉(zhuǎn)換。Windows上的Docker Machine和Docker Toolbox的用戶應(yīng)始終設(shè)置此項。默認(rèn)為0。支持的值:true或1啟用false或0禁用。
COMPOSE_PATH_SEPARATOR
如果設(shè)置,COMPOSE_FILE則使用此字符作為路徑分隔符分隔環(huán)境變量的值。
COMPOSE_FORCE_WINDOWS_HOST
如果設(shè)置,使用量聲明短語法 解析假設(shè)主機路徑是Windows路徑,即使是撰寫基于UNIX的系統(tǒng)上運行。支持的值:true或1啟用false或0禁用。
COMPOSE_IGNORE_ORPHANS
如果設(shè)置,Compose不會嘗試檢測項目的孤立容器。支持的值:true或1啟用false或0禁用。
COMPOSE_PARALLEL_LIMIT
設(shè)置Compose可以并行執(zhí)行的操作數(shù)限制。默認(rèn)值為64,并且可能不會設(shè)置為低于2。
COMPOSE_INTERACTIVE_NO_CLI
如果設(shè)置,Compose不會嘗試使用Docker CLI進(jìn)行交互run 和exec操作。在上述操作需要CLI的Windows上,此選項不可用。支持:true或1啟用false或0禁用。