在服務定義中新增 oom_score_adj 欄位。拉取請求 compose#10019
新增 tmpfs 掛載權限的 mode 欄位。拉取請求 compose#10031
Compose 現在僅停止中斷時由 up 啟動的服務。修正 compose#10028
Compose 現在為目標服務載入隱式設定檔。修正 compose#10025
如果設定了 service.platform，Compose 不需要設定 service.build.platforms。修正 compose#10017
如果設定了 --ansi=never，則在 buildx 映像構建期間使用純文字輸出。修正 compose#10020
COMPOSE_IGNORE_ORPHANS 環境變數現在表現得更一致。修正 compose#10035
Compose 現在在 convert 中使用正確的映像名稱分隔符。修正 compose#9904
修正使用 network_mode: service:NAME 的服務的 run。修正 compose#10036

2.13.0

2022-11-23

更新

依賴更新：將 containerd 升級至 1.6.10
依賴更新：將 docker-credential-helpers 升級至 v0.7.0
更新 CI 依賴項。拉取請求 compose#9982

錯誤修正與增強功能

在 convert 指令中新增 no-consistency 選項。修正 compose#9963
在 run 指令中新增 build 選項。修正 compose#10003
修正將 restart_policy.condition 對應到引擎支援的值。修正 compose#8756, docs#15936
修正缺少 deploy.reservation.memory 支援的問題。修正 compose#9902
修正一個錯誤，以防止在指定 --profile 參數時使用 COMPOSE_PROFILES。修正 compose#9895
修正一個錯誤，以防止在依賴將構建此映像的服務時拉取服務映像。修正 compose#9983
修正未找到容器編號標籤時的解析錯誤。修正 compose#10004
當未定義 service.platform 時，Compose 現在使用 DOCKER_DEFAULT_PLATFORM 定義的平台值。修正 compose#9889
移除對已棄用依賴項 gotest.tools v2 的使用。拉取請求 compose#9935
從 stale bot 處理程序中排除標記為 kind/feature 的問題。修正 compose#9988

2.12.2

2022-10-21

更新

更新 Docker Engine API 以恢復 Linux 封裝所需的與 Golang 1.18 的相容性。拉取請求 compose#9940

如需完整的變更日誌或更多資訊，請檢查 Compose 儲存庫 2.12.2 發行頁面。

2.12.1

2022-10-21

安全性

更新 Docker Engine API 以套用 CVE-2022-39253 的修正。拉取請求 compose#9934

如需完整的變更日誌或更多資訊，請檢查 Compose 儲存庫 2.12.1 發行頁面。

2.12.0

2022-10-18

更新

CI 更新至說明文件儲存庫路徑
升級至 compose-go 從 1.5.1 至 1.6.0
更新至 go 1.19.2 以解決 CVE-2022-2879、CVE-2022-2880、CVE-2022-41715

錯誤修正與增強功能

新增推送映像時的 quiet 選項。修正 compose#9089
修正 port 指令的誤導性錯誤訊息。拉取請求 compose#9909
修正一個錯誤，以防止 Compose 嘗試移除不存在的容器時失敗。修正 compose#9896
切換 GitHub 問題範本表單

如需完整的變更日誌或更多資訊，請檢查 Compose 儲存庫 2.12.0 發行頁面。

2.11.2

2022-09-27

注意
環境檔案語法和插值更新：請參閱 compose#9879
Compose v2 不支援透過 .env 檔案設定 DOCKER_HOST

更新

升級至 compose-go 從 1.5.1 至 1.6.0

錯誤修正與增強功能

修正一個錯誤，防止對有效環境變數值產生「invalid template」錯誤。修正 compose##9806, compose##9746, compose##9704, compose##9294
修正一個錯誤，以確保使用來自 docker compose build 的新映像。修正 compose#9856
修正未設定 DOCKER_DEFAULT_PLATFORM 時的跨架構構建。修正 compose#9864
修正使用 depends_on 時的間歇性衝突錯誤。修正 compose#9014
覆寫入口點時清除服務 CMD。修正 compose#9622
當未定義 build.platforms 時設定預設建置器匯出。修正 compose#9856
修正一個錯誤，以優先透過 DOCKER_DEFAULT_PLATFORM 或 service.platform 屬性保持定義的平台。修正 compose#9864
移除對 .env 檔案中 DOCKER_HOST 的支援。修正 compose#9210
修正一個錯誤，以確保如果在執行指令中覆寫入口點，則服務命令保持乾淨。修正 compose#9622
Deps：修正圖形遍歷期間的競爭條件。修正 compose#9014
CI 現在在 Windows 和 macOS 上執行，包括透過 Docker Desktop 進行的 E2E 測試
當 service.platform 不是 service.build.platforms 的一部分時新增更多資訊
GitHub Workflows 安全強化

如需完整的變更日誌或更多資訊，請檢查 Compose 儲存庫 2.11.2 發行頁面。

2.11.1

2022-09-20

錯誤修正與增強功能

修正一個錯誤，在服務具有 volumes_from 時保持 depends_on 條件。修正 compose#9843
修正一個錯誤，如果沒有構建平台，在構建期間保持服務級別定義的平台。修正 compose#9729
修正一個錯誤，如果在構建期間未提供構建平台，則保持透過 DOCKER_DEFAULT_PLATFORM 定義的平台。修正 compose#9853

如需完整的變更日誌或更多資訊，請檢查 Compose 儲存庫 2.11.1 發行頁面。

2.11.0

2022-09-14

更新

依賴更新：將 Golang 升級至 1.19.1
依賴更新：將 github.com/docker/go-units 從 0.4.0 升級至 0.5.0
依賴更新：將 github.com/cnabio/cnab-to-oci 從 0.3.6 升級至 0.3.7
依賴更新：將 go.opentelemetry.io/otel 從 1.9.0 升級至 1.10.0
依賴更新：將 github.com/AlecAivazis/survey/v2 從 2.3.5
依賴更新：將 go.opentelemetry.io/otel 從 1.4.1 升級至 1.9.0
依賴更新：將 compose-go 從 1.5.0 升級至 1.5.1

錯誤修正與增強功能

新增平台構建。修正 compose-spec#267
日誌現在過濾來自目前 Compose 檔案的服務。修正 compose#9801
新增改進的拉取映像時的輸出警告。修正 compose#9820
修正一個錯誤，以確保服務有依賴項時正確擷取退出代碼。修正 compose#9778
修正帶有 --rmi 的 down。修正 compose#9655
修正使用 --no-interpolate 選項時將 $ 轉為 $$ 的 docker-compose convert。修正 compose#9160
修正 build.go 直接存取自訂標籤導致崩潰。請參閱 compose#9810
將新載入的 envvars 套用到「DockerCli」和「APIClient」。修正 compose#9210
僅嘗試在 compose start [services] 上啟動指定的服務。修正 compose#9796 compose#9807
標記已構建的映像以在 down 上進行可靠的清理。修正 compose#9655

如需完整的變更日誌或更多資訊，請檢查 Compose 儲存庫 2.11.0 發行頁面。

2.10.2

2022-08-26

錯誤修正與增強功能

適當尊重 DOCKER_TLS_VERIFY 和 DOCKER_CERT_PATH 環境變數。修正 compose#9789。
改進 docker/docker-ce-packaging#742 中使用的 Makefile。

如需完整的變更日誌或更多資訊，請檢查 Compose 儲存庫 2.10.2 發行頁面。

2.10.1

2022-08-24

更新

依賴更新：將 github.com/moby/buildkit 從 0.10.3 升級至 0.10.4。

錯誤修正與增強功能

修正未設定 pull_policy 時跳過映像拉取的問題。修正 compose#9773。
恢復發行產物中的 .sha256 總和檢查碼檔案。修正 compose#9772。
在使用 --exit-code-from 時移除顯示退出代碼的錯誤訊息。修正 compose#9782。
修正 compose pull，即使 tag=latest 本機存在映像也會拉取。
CI：修正總和檢查碼檢查並恢復單獨的總和檢查碼檔案。

如需完整的變更日誌或更多資訊，請檢查 Compose 儲存庫 2.10.1 發行頁面。

2.10.0

2022-08-19

新增功能

將新載入的環境變數套用到 DockerCli 和 APIClient。修正 compose#9210。
新增對 windows/arm64 和 linux/riscv64 的支援。

更新

更新 Dockerfile 語法至最新穩定版，並重新命名說明文件 Dockerfile。
依賴更新：更新 BuildKit 和 docker/distribution。
依賴更新：將 CI 中使用的 Docker CLI 版本更新至 v20.10.17。
依賴更新：將 github.com/containerd/containerd 從 1.6.6 升級至 1.6.7。
依賴更新：將 github.com/containerd/containerd 從 1.6.7 升級至 1.6.8。
依賴更新：升級至 Go 1.18.5。
依賴更新：將 github.com/cnabio/cnab-to-oci 從 0.3.5 升級至 0.3.6。

錯誤修正與增強功能

將環境變數優先順序恢復為 OS 高於 .env 檔案。修正 compose#9737。
更新說明字串以保持一致性。
在 Windows 上不區分大小寫地解析環境變數。修正 compose#9431。
修正 compose up，以便在發出停止訊號時不會停止依賴容器。這在行為上與 v1 保持同等。
修正 compose#9696。
修正啟動/重啟/暫停/取消暫停的指令，以便如果從 Compose 檔案執行，也會套用 Compose 模型。修正 compose#9705 和 compose#9705。
移除一些子指令幫助文字中多餘的空格。
修正 compose create，在命令列的值設定為預設值時，不會覆蓋服務拉取原則。修正 compose#9717。
過濾出「commandConn.Close- warning」訊息。修正compose#8544。
修正 up/start/run 不等待已禁用的依賴項。修正 compose#9591。
在 compose kill 上套用 Compose 模型，新增 --remove-orphans 選項。修正 compose#9742。
修正 compose pull 以避免多次拉取相同的映像。修正 compose#8768。
將 golangci-lint 的版本修正為 v1.47.3，暫時解決 v1.48.0 的問題。

如需完整的變更日誌，請檢查 Compose 儲存庫 2.10.0 發行頁面。

2.9.0

2022-08-7

重要
Compose v2.9.0 包含環境變數優先順序的變更，此變更隨後已還原。我們建議使用 v2.10+ 以避免相容性問題。

注意
此版本還原了 Compose v2.8.0 中由 compose-go v1.3.0 引入的破壞性變更。

更新

更新 compose-go 至 v1.4.0，因為先前的版本引入了破壞性變更。修正 compose#9700。

錯誤修正與增強功能

覆寫 compose version 的父指令 PreRun 代碼。修正 compose#9698。
修復了 V2 中的 LinkLocalIPs。修復 compose#9692。
連結至 BUILDING.md 以取得測試說明。修復 compose#9439。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.9.0 發布頁面。

2.8.0

2022-07-29

重要
此版本透過 compose-go v1.3.0 和此 PR 引入了重大變更。在此版本中，Docker Compose 會以新名稱重建資源（網路、磁碟區、密鑰、配置等），將 _（底線）改為 -（連字號），並嘗試連接或使用這些新建立的資源，而非您現有的資源！
請改用 Compose v2.9.0 版本。

新增功能

引入了 --pull 旗標以允許強制拉取更新後的服務映像檔。修復 compose#9451。
透過將 gocritic 新增至 linter 改善了程式碼品質。

錯誤修正與增強功能

修復了插值錯誤訊息的輸出。修復 compose-spec/compose-go#292。
定義了環境變數評估的優先順序。修復 compose#9521、compose#9638、compose#9608、compose#9578、compose#9468 以及 compose#9683。
文件 CI：修復了建立 PR 時使用 push-to-fork 的問題。
使用環境變數設定 golang 版本，並將 GitHub Actions 從 v2 升級至 v3。
使用 google/addlicense 取代 kunalkushwaha/ltag。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.8.0 發布頁面。

2.7.0

2022-07-20

新增功能

新增了在建置步驟中支援環境密鑰的功能。修復 compose#9606。

更新

相依性升級：將 go 升級至 1.18.4。
相依性升級：將 compose-go 升級至 v1.2.9。

錯誤修正與增強功能

網路：防止因名稱重複導致的問題。修復 moby/moby#18864。
修復了執行 compose up 和 compose down 指令時關於網路名稱的問題。修復 compose#9630。
執行 compose up --wait 時，針對一次性容器使用適當的相依性條件。修復 compose#9606。
修復了環境變數擴展問題。
在一致性檢查中驗證被依賴的服務是否存在。修復 compose#8910。
修復了環境值中雜湊 (hash) 的使用。修復 compose#9509。
Docker Build：修正了經典建置器需遵守相依性順序的問題。修復 compose#8538。
修復了因空字串參數引起的程式崩潰 (panic)。修復 compose-switch#35。
修復了啟動/重新啟動功能，使其不會影響一次性容器。修復 compose#9509。
修復了當 volumes_from 指向容器而非服務時，能保留容器參照的問題。修復 compose#8874。
build.go：修正了在 nil 時初始化 CustomLabels 對應表的問題。
新增了在執行端對端 (e2e) 測試前建置 Compose 二進位檔案的新目標。
CI：釋出了自動化工作流程，用於在文件儲存庫開啟包含最新變更的 PR。
e2e：新增了 ps 的測試。
e2e：拆分了暫停 (pause) 測試並新增更多案例。
e2e：新增更多啟動/停止的測試案例。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.7.0 發布頁面。

2.6.1

2022-06-23

新增功能

新增了從環境變數設定密鑰的支援。修復 compose-spec/compose-spec#251。

更新

升級：compose-go v1.2.8。
升級：buildx v0.8.2。
相依性升級：將 runc 升級至 1.1.2。
相依性升級：將 golang 升級至 1.18.3。
相依性升級：將 compose-go 升級至 v1.2.8。
相依性升級：將 github.com/theupdateframework/notary 從 0.6.1 升級至 0.7.0。
相依性升級：將 github.com/cnabio/cnab-to-oci 從 0.3.1-beta1 升級至 0.3.3。
相依性升級：將 github.com/hashicorp/go-version 從 1.3.0 升級至 1.5.0。
相依性升級：將 github.com/stretchr/testify 從 1.7.0 升級至 1.7.2。
相依性升級：將 github.com/docker/buildx 從 0.8.1 升級至 0.8.2。
相依性升級：將 github.com/AlecAivazis/survey/v2 從 2.3.2 升級至 2.3.5。
相依性升級：將 github.com/containerd/containerd 從 1.6.2 升級至 1.6.6。

錯誤修正與增強功能

新增了容器建立請求的連結。修復 #9513。
修復了 compose run 僅啟動直接相依服務的問題。修復 #9459。
修復了使用 --no-deps 選項時 compose up 出現的 'service not found' 錯誤。修復 #9427。
修復了 compose down 需遵守 COMPOSE_REMOVE_ORPHANS 環境變數的問題。修復 #9562。
修復了專案層級的繫結掛載 (bind mount) 磁碟區問題。修復 docker/for-mac#6317。
修復了 deploy.limits.cpus 和 deploy.limits.pids 屬性的解析問題，使其能遵守浮點數值。修復 #9542 和 #9501。
修復了 compose ps 輸出以列出所有開放的埠。修復 #9257。
修復了 compose ps 程式碼中的拼字錯誤。
修復了 docker compose 在請求棄用選項時仍會遵守 --no-ansi 的問題。
修復了網路名稱與網路 ID 可能產生歧義的問題。
e2e：新增了 ps 的測試。
e2e：將 json 解組 (unmarshal) 為容器摘要。
e2e：修復了子測試並阻擋平行執行不安全的測試。
e2e：將測試指令的環境變數與系統環境變數隔離。
e2e：修復了虛假的 ps 失敗。
e2e：確保所有 compose 指令皆與獨立模式相容。
e2e：改進了失敗時的測試輸出。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.6.1 發布頁面。

2.6.0

2022-05-30

新增功能

在建置區段中新增了 tags 屬性。在此屬性中，除了 image 屬性中定義的標籤外，還可以定義要套用到最終映像檔的其他標籤。
新增了端對端測試，以確保環境變數的優先順序不會出現迴歸 (regression)。
新增了 ddev 的端對端測試。

更新

相依性更新：將 compose-go 更新至 1.2.6。
相依性更新：將 compose-go 更新至 1.2.7。
相依性更新：將 golang 更新至 1.18。

錯誤修正與增強功能

修復了 compose up 僅連接至專案中已啟用設定檔之服務的問題。修復 #9286。
修復了從多個服務拉取相同映像檔時閃爍的提示。修復 #9469。
修復了 compose go 匯入 .env 檔案至作業系統環境的問題，允許透過此檔案設定變數（例如 DOCKER_BUILDKIT）。修復 #9345。
修復了在本地失敗的 TestLocalComposeUp。
修復了 make e2e-compose-standalone 的本地執行問題。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.6.0 發布頁面。

2.5.1

2022-05-17

更新

相依性更新：將 compose-go 更新至 1.2.5。

錯誤修正與增強功能

修復了當使用 '--env-file' 宣告相對路徑時，專案工作目錄絕對路徑的解析問題。修復 docker/for-mac#6229。
修復 compose down：現在拒絕所有引數以釐清使用方式。修復 #9151。
修復 compose down：如果沒有要移除的資源，現在會以狀態碼 0 退出。修復 #9426。
修復了使用 --no-log-prefix 選項時，記錄輸出行中多出的空格問題。修復 #9464。
釐清了當傳入多個 compose 檔案時，預設工作目錄的定義。
cp 指令：預設行為改為複製到服務的所有容器。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.5.1 發布頁面。

2.5.0

2022-04-29

錯誤修正與增強功能

修復了指定 -p 旗標時 compose down 指令崩潰的問題。修復 #9353。
將新建立的專案作為啟動服務 (docker compose up) 的輸入。修復 #9356。
將 docker-compose 檔案中 links 下宣告的服務包含為隱含相依項。修復 #9301。
新增了 docker compose pull 指令的變更，以遵守定義的原則：1) 跳過設定為 pull_policy: never 的服務，以及 2) 忽略已存在映像檔且設為 pull_policy: missing 的服務。修復 #3660。
從資源建置專案時的錯誤不再被忽略，以防止 down 崩潰。修復 #9383。
強制專案名稱必須為小寫。修復 #9378。
新增了對建置時密鑰的支援。修復 #6358。
變更 compose-go 以允許（重新）建置磁碟區字串，當無法使用掛載時，供引擎 bind API 使用。修復 #9380。
提供 checksums.txt 檔案並新增 --binary 以允許在不同作業系統中驗證。修復 #9388。
新增變更，使本地拉取的映像檔 ID 經過檢查並保存至 com.docker.compose.image。修復 #9357。
修復了有關 IPAM 閘道設定的問題。修復 #9330。
新增對 docker compose 二進位檔案 ppc64le 架構的支援。
修復了 --no-TTY 文件中的搜尋/取代拼字錯誤。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.5.0 發布頁面。

2.4.1

2022-04-04

錯誤修正與增強功能

執行帶有此旗標的容器時，將 --rm 旗標值原樣傳遞給 Docker CLI。修復 #9314。
當透過 docker compose up 指令建置映像檔時，將 ssh 設定新增至建置選項。修復 #9338。
新增對容器的檢查，以判斷是否需要 TTY。執行指定了 tty:true 的服務現在會顯示控制台輸出。修復 #9288。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.4.1 發布頁面。

2.4.0

2022-04-1

更新

相依性更新：將 buildx 升級至 v0.8.1，以修復處理建置上下文掃描錯誤時可能發生的崩潰。

錯誤修正與增強功能

將互動式旗標 '-i' 從 Compose CLI 傳遞給 Docker 以執行 exec 指令。修復 #9315。
Compose 指令現在會考慮 COMPOSE_PROJECT_NAME 環境變數的值。修復 #9316。
修復了 compose down 指令的問題，該指令在沒有啟動任何服務或沒有資源可刪除的內容中執行時會傳回錯誤。錯誤原因在於指令試圖刪除一個不存在的預設網路。修復 #9333。
在建置區段中引入了對 cache_from、cache_to、no_cache 和 pull 屬性的支援。這些屬性允許強制從原始碼進行完整重建，並檢查所使用的映像檔是否存在於登錄檔中。這些變更為未來提供 compose build（或同等功能）指令的 --no-cache 和 --pull 選項奠定了基礎。
為 CLI 和 Compose 檔案的 build 指令引入了對 --ssh 旗標的支援。修復 #7025。
修復 --ssh 旗標說明中的拼字錯誤。與 #7025 有關。
將 Kubernetes 相依性釘選 (pin) 為與 buildx 中相同的版本。
將互動式旗標從 Compose CLI 傳遞給 Docker 以執行 exec 指令。
修復了平行執行時啟動-停止端對端測試的競爭條件 (race condition)。
刪除了關於過時警告的程式碼。
Vendor：github.com/containerd/containerd v1.6.2。包含針對 CVE-2022-24769 的修復（不影響我們的程式碼庫）。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.4.0 發布頁面。

2.3.4

2022-03-25

新增功能

引入變更以使用 docker/cli 中的 RunExec 和 RunStart 來處理所有互動式/tty/* 終端機邏輯。

已移除

刪除沒有候選者的容器現在會產生警告，而非錯誤。修復 #9255。
從 run 和 exec 指令的 -i 和 -t 選項中移除「已棄用」(Deprecated) 的說明。這些選項預設為啟用且正在使用中。修復 #9229。
從 --filter 旗標中移除「已棄用」說明，以與其他指令保持一致。
移除了執行 'docker compose kill' 時需要原始 compose.yaml 檔案的需求。

更新

相依性更新：將 github.com/spf13/cobra 從 1.3.0 升級至 1.4.0。Cobra 函式庫不再需要 Viper 及其所有間接相依性請參閱 cobra 的發布頁面。
相依性更新：將 buildx 從 v0.7.1 升級至 v0.8.0。

錯誤修正與增強功能

恢復 'compose up -d' 的行為，即使用刷新後的內容重建 compose 檔案映像檔的容器。修復 #9259。
Docker compose --status、--filter 和 --format 旗標文件更新。
docker compose down -v 現在不會刪除外部磁碟區和網路，符合該選項預期且已記錄的行為。每當指定專案時，現在也會使用該專案來強制 down 僅刪除 compose.yaml 檔案中列出的資源。修復 #9172、#9145。
變更 Compose API 參考文件自動化，以選取程式碼與文件之間的差異 (diff)。

欲查看完整變更日誌或取得更多資訊，請造訪 Compose 儲存庫 2.3.4 發布頁面。

其他發行版本

(2022-03-8 至 2022-04-14)

對於晚於 1.29.2 且早於 2.3.4 的發布版本，請查閱 Compose 儲存庫發布頁面。

1.29.2

(2021-05-10)

其他

移除了在 up 指令中使用 docker-compose 的提示。
將 requirements-indirect.txt 中的 py 升級至 1.10.0。

1.29.1

(2021-04-13)

錯誤 (Bugs)

修復 Windows 建置上的無效處理常式警告。
修復了設定雜湊，以在 IPC 模式更新時觸發容器重建。
修復了 placement.max_replicas_per_node 的轉換對應表。
刪除建置時額外的掃描建議。

1.29.0

(2021-04-06)

功能

將設定檔過濾器新增至 docker-compose config。
新增 depends_on 條件以等待服務成功完成。

其他

在建置時新增映像檔掃描訊息。
更新 --no-ansi 的警告訊息，提及 --ansi never 作為替代方案。
將 docker-py 升級至 5.0.0。
將 PyYAML 升級至 5.4.1。
將 python-dotenv 升級至 0.17.0。

1.28.6

(2021-03-23)

錯誤修復 (Bug fixes)

使 --env-file 相對於目前工作目錄。透過 --env-file 設定的環境檔案路徑現在相對於目前工作目錄，並會覆寫位於專案目錄中的預設 .env 檔案。
透過更新 Compose 架構修復遺失的服務屬性 storage_opt。
修復建置 extra_hosts 清單格式。
刪除 exec 上額外的錯誤訊息。

其他

將 compose.yml 和 compose.yaml 新增至預設檔案名稱清單。

1.28.5

(2021-02-26)

錯誤 (Bugs)

修復呼叫 SSH 用戶端時的 OpenSSL 版本不符錯誤（透過升級至包含修復程式的 docker-py 4.4.4）。
將遺失的建置旗標新增至原生建置器：platform、isolation 和 extra_hosts。
移除原生建置時的資訊訊息。
修復當服務記錄驅動程式設為 'none' 時的記錄擷取錯誤。

1.28.4

(2021-02-18)

錯誤修復 (Bug fixes)

透過將 docker-py 升級至 4.4.3 修復 SSH 埠解析問題。

其他

將 Python 升級至 3.7.10。

1.28.3

(2021-02-17)

錯誤修復 (Bug fixes)

修復包含開頭 's'/'h' 的 SSH 主機名稱解析，並移除隱藏錯誤的 quiet 選項（透過升級至 docker-py 4.4.2）。
修復 --no-log-prefix 選項的鍵值錯誤 (key error)。
修復服務設定檔不正確的 CLI 環境變數名稱：使用 COMPOSE_PROFILES 取代 COMPOSE_PROFILE。
修復 fish 完成功能 (completion)。

如需此版本中修復的 PR 和問題清單，請參閱 Compose 1.28.3。

1.28.2

(2021-01-26)

錯誤修復 (Bug fixes)

Linux 靜態建置恢復至 Python 3.7 版本
為 docker-compose logs|up --no-log-prefix 新增 bash 完成功能

其他

CI 設定更新

1.28.0

(2021-01-20)

功能

新增透過裝置請求支援 NVIDIA GPU。
新增支援服務設定檔。
變更 Docker CLI 的 SSH 連接方式，改為呼叫本地 SSH 用戶端。設定 COMPOSE_PARAMIKO_SSH=1 環境變數以啟用舊有行為。
新增旗標以停用記錄前綴。
新增 ANSI 輸出控制旗標。
Docker Compose 現在在建置映像檔時使用原生 Docker CLI 的 build 指令。設定 COMPOSE_DOCKER_CLI_BUILD=0 環境變數以停用此功能。

錯誤修復 (Bug fixes)

預設將 parallel_pull 設為 True。
恢復非 swarm 模式下設定的警告。
定義 project_dir 時考慮 --file。
修復 compose up 上的服務連接錯誤。

其他

新增使用量指標。
同步架構與 COMPOSE 規格。
改善遺失強制性環境變數的失敗報告。
將 attrs 升級至 20.3.0。
將 more_itertools 升級至 8.6.0。
將 cryptograhy 升級至 3.2.1。
將 cffi 升級至 1.14.4。
將 virtualenv 升級至 20.2.2。
將 bcrypt 升級至 3.2.0。
將 GitPython 升級至 3.1.11。
將 docker-py 升級至 4.4.1。
將 Python 升級至 3.9。
Linux：將 Debian 基礎映像檔從 stretch 升級至 buster（Python 3.9 所需）。
macOS：將 OpenSSL 1.1.1g 升級至 1.1.1h，Python 3.7.7 升級至 3.9.0。
將 PyInstaller 升級至 4.1。
放寬對基礎映像檔至最新次要版本的限制。
更新 README。

1.27.4

(2020-09-24)

錯誤修復 (Bug fixes)

移除繫結掛載的路徑檢查。
修復埠渲染以輸出非 v1 的長格式語法。
將協定新增至 Docker 通訊端位址。

1.27.3

(2020-09-16)

錯誤修復 (Bug fixes)

合併 docker-compose config 上的 max_replicas_per_node。
修復 docker-compose config 上的 depends_on 序列化。
修復 docker-compose up 上某些容器未執行時的擴展問題。
啟用 local 驅動程式的 driver_opts.device 相對路徑。
允許 cpus 欄位使用字串。

1.27.2

(2020-09-10)

錯誤修復 (Bug fixes)

修復 docker-compose run 容器連接錯誤。

1.27.1

(2020-09-10)

錯誤修復 (Bug fixes)

修復指定 service.scale 時的 docker-compose run 問題。
允許外部網路的 driver 屬性作為 Swarm 網路傳播問題的暫時解決方案。
將新的內部架構版本釘選為預設的 3.9。
保留 Compose 檔案中配置的版本號碼。

1.27.0

(2020-09-07)

功能

合併 2.x 和 3.x Compose 格式並與 COMPOSE_SPEC 架構對齊。
為 ipc 實作服務模式。
在容器模式中傳遞 COMPOSE_PROJECT_NAME 環境變數。
使 run 的行為與 up 相同。
設定 COMPOSE_DOCKER_CLI_BUILD 環境變數時，在 docker-compose run 上使用 docker build。
將 docker-py 預設 API 版本用於引擎查詢 (auto)。
建置時解析 network_mode。

錯誤修復 (Bug fixes)

不需要建置時忽略建置上下文路徑驗證。
透過 docker-py 升級至 4.3.1 修復浮點數轉位元組轉換。
修復設定 deploy 區段時的擴展錯誤。
修復 setup.py 中的 docker-py 升級。
修復實驗性建置失敗偵測。
修復內容傳播至 Docker CLI。

其他

將 docker-py 升級至 4.3.1。
將 tox 升級至 3.19.0。
將 virtualenv 升級至 20.0.30。
新增文件同步指令碼。

1.26.2

(2020-07-02)

錯誤修復 (Bug fixes)

使用 pip 安裝時強制 docker-py 最低版本為 4.2.2。

1.26.1

(2020-06-30)

功能

將 docker-py 從 4.2.1 升級至 4.2.2。

錯誤修復 (Bug fixes)

使用 pip 安裝時強制 docker-py 最低版本為 4.2.1。
修復非 docker 端點的內容載入。

1.26.0

(2020-06-03)

功能

新增 docker context 支援。
將遺失的測試相依性 ddt 新增至 setup.py。
在 up 指令中新增 --attach-dependencies 以連接至相依項。
使用 COMPOSE_COMPATIBILITY 環境變數允許相容性選項。
將 Pytest 升級至 5.3.4 並重構與新版本的相容性。
將 OpenSSL 從 1.1.1f 升級至 1.1.1g。
將 certifi 從 2019.11.28 升級至 2020.4.5.1。
將 docker-py 從 4.2.0 升級至 4.2.1。

錯誤修復 (Bug fixes)

適當跳脫 (escape) 來自 env_files 的值。
與上游 (docker/cli) 同步 compose-schemas。
刪除 exec 指令上的 None 項目。
新增 distribution 套件以取得發行資訊。
新增 python-dotenv 以委派 .env 檔案處理。
停止在管線導向另一個指令時調整終端機寬度的輸出。
當 version 屬性格式錯誤時顯示錯誤訊息。
修復 DOCKER_HOST 為遠端時的 HTTPS 連線。

1.25.5

(2020-04-10)

功能

將 OpenSSL 從 1.1.1d 升級至 1.1.1f。
新增 Compose 版本 3.8。
- 將服務擴展限制為 deploy.placement.max_replicas_per_node 欄位指定的數量。

1.25.4

(2020-02-03)

錯誤修復 (Bug fixes)

修復 CI 指令碼以強制最低 MacOS 版本為 10.11。
修復環境檔案中無值鍵的 docker-compose exec。

1.25.3

(2020-01-23)

錯誤修復 (Bug fixes)

修復 CI 指令碼以強制使用 Python3 編譯。
在發布頁面上更新二進位檔案的 sha256。

1.25.2

(2020-01-20)

新功能

Docker Compose 現在允許使用 COMPOSE_COMPATIBILITY 環境變數設定相容性選項。

錯誤修復 (Bug fixes)

修復導致 Docker Compose 在 version 欄位設為無效值時崩潰的問題。現在 Docker Compose 在版本欄位中使用無效值時會顯示錯誤訊息。
修復導致 Docker Compose 在終端機外執行指令時呈現訊息錯誤的問題。

1.25.1

(2020-01-06)

Bugfixes

在使用 APIError 說明建立和啟動容器之前，將其解碼為 Unicode。
Docker Compose 捨棄值為 None 的 com.docker.compose.filepaths 標籤。這通常發生在標籤源自 stdin 時。
將 OS X 二進位檔案新增為目錄，以解決 macOS Catalina 二進位掃描引起的啟動緩慢問題。
使用 script/run/run.sh 執行時，在容器模式中傳遞 HOME 環境變數。
Docker Compose 現在會報告無法拉取但需要建置的映像檔。

1.25.0

(2019-11-18)

新功能

透過將 CLICOLOR 環境變數變更為 0，將 no-colors 設為 true。
將工作目錄、設定檔案和環境檔案新增至服務標籤。
新增 ARM 建置相依性。
新增 BuildKit 支援（使用 DOCKER_BUILDKIT=1 和 COMPOSE_DOCKER_CLI_BUILD=1）。
將 Paramiko 提升至 2.6.0 版本。
新增以下標籤：docker-compose:latest、docker-compose:<version>-alpine 和 docker-compose:<version>-debian。
將 docker-py 提升至 4.1.0 版本。
增強對 requests 的支援，最高至 2.22.0 版本。
移除 build:cache_from 上的空標籤。
Dockerfile 增強功能，提供為 Alpine Linux 產生 libmusl 二進位檔案的功能。
僅拉取無法建置的映像檔。
scale 屬性現在接受 0 作為值。
在 docker-compose build 指令中新增 --quiet 和 --no-rm 選項。
在 docker-compose config 指令中新增 --no-interpolate 選項。
將 MacOS 建置的 OpenSSL 從 1.1.0 提升至 1.1.1c。
新增對 docker-compose.yml 檔案 credential_spec 設定選項的支援。
無需拉取映像檔即可解析摘要 (digests)。
將 pyyaml 升級至 4.2b1 版本。
降低 down 嘗試移除不存在映像檔時的嚴重性為 warning。
盡可能強制使用改善後的專案事件 API 欄位。
更新 setup.py 以適應現代化的 pypi/setuptools，並移除 pandoc 相依性。
刪除不再需要的 Dockerfile.armhf。

錯誤修復 (Bug fixes)

使容器服務顏色具有確定性，包括移除紅色。
修復非 ASCII 字元錯誤（僅限 Python 2）。
變更映像檔大小格式為十進位，以與 Docker CLI 對齊。
透過 Python POSIX 支援取得 tty 大小。
修復相同檔案 extends 最佳化。
修復 stdin_open。
修復在使用 up --no-start 選項時 --remove-orphans 被忽略的問題。
修復 docker-compose ps --all 指令。
修復 depends_on 相依性重建行為。
修復 docker-compose build --memory 指令的 bash 完成功能。
修復執行 docker-compose exec 指令時發生的誤導性環境變數警告。
修復 parallel_execute_watch 函式中的失敗檢查。
修復拉取映像檔後發生的競爭條件。
修復重複掛載點上的錯誤（現在會顯示設定錯誤訊息）。
修復 networks 區段上的合併。
Compose 容器預設始終連接至 stdin。
修復容器不可用時 docker-compose start 指令上失敗服務的呈現。

1.24.1

(2019-06-24)

此版本包含細微的改進和錯誤修復。

1.24.0

(2019-03-28)

功能

新增支援使用 ssh 通訊協定連接至 Docker Engine。
在 docker-compose ps 中新增 --all 旗標，以在指令輸出中包含已停止的一次性容器。
為 ps --all|-a 新增 bash 完成功能。
新增對 credential_spec 的支援。
在 bash 和 zsh 完成功能中為 docker build 選項新增 --parallel。

錯誤修復 (Bug fixes)

修復 Compose 在嘗試從私人登錄檔拉取映像檔時未正確處理某些有效憑證輔助程式的錯誤。
修復容器建立前 docker-compose start 的輸出具有誤導性的問題。
Compose 不再接受環境檔案來源變數名稱中的空白。這符合 Docker CLI 的行為。
如果服務試圖在 volumes 區段中宣告重複的掛載點，Compose 現在會報告設定錯誤。
修復了容器化版本的 Compose 中的一個問題，該問題阻止使用者在 run 或 exec 啟動的互動式工作階段期間寫入 stdin。
run 啟動的一次性容器不再採用服務的重新啟動原則，而是設為永不重新啟動。
修復導致某些容器事件未出現在 docker-compose events 指令輸出中的問題。
遺失的映像檔不再停止 docker-compose down 指令的執行。現在會顯示警告。
強制 MacOS CI 使用 virtualenv 版本。
修復當網路具有 None 設定時 Compose 檔案的合併。
透過在 pyinstaller 中啟用 bootloader_ignore_signals 來修復 CTRL+C 問題。
將 docker-py 版本提升至 3.7.2 以修復 SSH 和 Proxy 設定問題。
修復發布指令碼和發布文件中的一些拼字錯誤。

1.23.2

(2018-11-28)

錯誤修復 (Bug fixes)

還原了 1.23.0 的變更，該變更在 docker-compose up 建立的容器名稱中附加了隨機字串，導致可定址性問題。
注意
docker-compose run 建立的容器將繼續使用隨機產生的名稱，以避免平行執行期間的衝突。
修復了在 Windows 上建置時某些 dockerfile 路徑意外失敗的問題。
修復建置上下文 URL 在 Windows 上建置失敗的錯誤。
修復 run 和 exec 指令對於 --host 參數某些可接受值失敗的錯誤。
修復服務定義中 storage_opt 和 isolation 鍵的覆寫未正確套用的問題。
修復某些無效 Compose 檔案在驗證期間引發未捕獲例外錯誤的錯誤。

1.23.1

(2018-11-01)

錯誤修復 (Bug fixes)

修復與早於 1.23.0 版本的 Compose 建立的容器工作時導致意外崩潰的錯誤。
修復 --project-directory 旗標的行為根據使用的子指令而異的問題。

1.23.0

(2018-10-30)

重要注意事項

在此版本中，Compose 建立的容器預設命名方案已從 <project>_<service>_<index> 變更為 <project>_<service>_<index>_<slug>，其中 <slug> 是隨機產生的十六進位字串。請務必在升級前相應地更新依賴舊命名方案的指令碼。

功能

崩潰後重新啟動的容器記錄現在將出現在 up 和 logs 指令的輸出中。
新增 --hash 選項至 docker-compose config 指令，允許使用者為每個服務的設定列印雜湊字串，以促進滾動更新。
新增 --parallel 旗標至 docker-compose build 指令，允許 Compose 同時建置最多 5 個映像檔。
pull 指令的輸出現在即使在平行拉取多個映像檔時也會報告狀態/進度。
對於具有多個名稱的映像檔，Compose 現在會嘗試在 images 指令的輸出中匹配服務設定中存在的名稱。

錯誤修復 (Bug fixes)

修復同一服務的平行 run 指令因名稱衝突而失敗的問題。
修復 Windows 客戶端上超過 260 個字元的路徑導致 docker-compose build 失敗的問題。
修復在使用 Docker Desktop for Windows 掛載 /var/run/docker.sock 時失敗的錯誤。
--project-directory 選項現在由 Compose 用於決定去哪裡尋找 .env 檔案。
在嘗試拉取由 gcloud credential helper 提供憑證的映像檔時，docker-compose build 不再失敗。
修復 docker-compose up 中的 --exit-code-from 選項，即使受監控容器不是退出原因，也能始終報告實際退出代碼。
修復了在某些情況下無法重建服務的問題，其中磁碟區會被對應到與該映像檔 Dockerfile 內宣告的磁碟區相同的掛載點。
修復導致多個網路的雜湊設定不一致的錯誤，導致某些服務被不必要地重新啟動。
修復導致名稱包含一個或多個點字元的服務變數替換失敗的錯誤。
修復使用容器化版本的 Compose 時的管線處理問題。
修復導致 Compose 檔案中的 external: false 項目在 docker-compose config 輸出中被列印為 external: true 的錯誤。
修復對沒有定義 image 鍵的服務發出 docker-compose pull 指令導致 Compose 崩潰的錯誤。
磁碟區和繫結現在按照它們在服務定義中宣告的順序掛載。

其他

zsh 完成指令碼已更新新選項，並且不再在預期服務名稱的地方建議容器名稱。

1.22.0

(2018-07-17)

新功能

1.21.2

(2018-05-03)

錯誤修復 (Bug fixes)

修復導致 IPAM 設定中 ip_range 屬性無法通過驗證的錯誤

1.21.1

(2018-04-27)

錯誤修復 (Bug fixes)

在 1.21.0 中，我們引入了關於專案名稱如何為資源名稱內部的內部使用進行清理的變更。這在操作現有、已部署且名稱因此變更的應用程式時導致了問題。此版本能正確偵測使用「舊版」命名慣例的資源。
修復使用絕對路徑指定內容內 Dockerfile 會失敗的問題，即使它是有效的。
修復 IPAM 選項變更被錯誤偵測到的錯誤，從而阻止重新部署。
v2 檔案的驗證現在會正確檢查 IPAM 設定的結構。
改進 Windows 上憑證儲存庫的支援，以包含使用 .exe 以外副檔名的二進位檔案。有效副檔名的清單由 PATHEXT 環境變數的內容決定。
修復 Compose 在某些 v3.2 檔案中產生包含重複元素的無效繫結的錯誤，導致部署期間在引擎層級引發錯誤。

1.21.0

(2018-04-11)

新功能

Compose 檔案版本 2.4

引入 docker-compose.yml 規格的 2.4 版本。此版本需要 Docker Engine 17.12.0 或以上版本。
新增對服務定義中 platform 參數的支援。如果提供，該參數在執行服務建置時也會被使用。

Compose 檔案版本 2.2 及以上

新增對服務定義中 cpu_rt_period 和 cpu_rt_runtime 參數的支援（僅限 2.x）。

Compose 檔案版本 2.1 及以上

新增對服務定義中 cpu_period 參數的支援（僅限 2.x）。
新增對服務建置設定中 isolation 參數的支援。此外，如果沒有定義 build.isolation 參數，服務定義中的 isolation 參數也可用於建置。（僅限 2.x）

所有格式

新增對 docker-compose exec 中 --workdir 旗標的支援。
新增對 docker-compose build 中 --compress 旗標的支援。
docker-compose pull 現在預設平行執行。您可以使用 --no-parallel 旗標退出此功能。--parallel 旗標現已棄用，並將在未來的版本中移除。
專案名稱中的連字號和底線不再被移除。
docker-compose build 現在支援使用建置上下文之外的 Dockerfile。

錯誤修復 (Bug fixes)

Compose 現在檢查磁碟區的設定是否與遠端磁碟區相符，若偵測到不符則報錯。
修復導致 Compose 在嘗試平行建立多個一次性容器時引發意外錯誤的錯誤。
修復使用 docker-machine config 為 exec 和 run 指令產生 TLS 旗標時的引數解析錯誤。
修復使用空白預設值（例如 ${VAR:-}）的變數替換會列印錯誤警告的錯誤。
改進當 Compose 檔案編碼與系統編碼不符時的彈性。鼓勵使用者儘可能使用 UTF-8。
修復 Swarm 中的外部疊加網路 (overlay network) 被 Compose 錯誤識別為不存在，從而中斷原本有效的操作的錯誤。

1.20.0

(2018-03-20)

新功能

Compose 檔案版本 3.6

引入 docker-compose.yml 規格的 3.6 版本。此版本必須與 Docker Engine 18.02.0 或以上版本搭配使用。
新增對磁碟區對應中 tmpfs.size 屬性的支援

Compose 檔案版本 3.2 及以上

--build-arg 選項現在可以在 docker-compose build 中使用，而無需指定服務

Compose 檔案版本 2.3

新增對服務定義中 device_cgroup_rules 的支援
新增對長格式磁碟區對應中 tmpfs.size 屬性的支援
--build-arg 選項現在可以在 docker-compose build 中使用，而無需指定服務

所有格式

為頂層 docker-compose 指令新增 --log-level 選項。可接受的值為 debug、info、warning、error、critical。預設記錄層級為 info
docker-compose run 現在允許使用者取消設定容器的進入點 (entrypoint)
在 ~/.docker/config.json 檔案中找到的 Proxy 設定現在會填入由 Compose 建立容器的環境變數和建置引數
新增 --use-aliases 旗標至 docker-compose run，指示應將服務設定中宣告的網路別名用於執行中的容器
新增 --include-deps 旗標至 docker-compose pull
docker-compose run 現在在接收到 SIGHUP 時會終止並移除執行中的容器
docker-compose ps 現在會顯示容器的健康狀態（若可用）
為 exec、run 和 up 指令新增長格式 --detach 選項

錯誤修復 (Bug fixes)

修復 .dockerignore 處理，特別是關於絕對路徑和最後一行優先規則
修復 Compose 在使用 Docker For Mac 連接到引擎時進行昂貴 DNS 查詢的問題
修復 1.19.0 中引入的一個錯誤，導致預設憑證路徑未被 Compose 遵守
修復 Compose 在建置上下文的一部分時錯誤地檢查符號連結目的地是否可存取的錯誤
修復 .dockerignore 檔案包含空白行導致 Compose 在 Windows 上出錯的錯誤
修復 --tls* 和 --host 選項未正確遵守互動式 run 和 exec 指令的錯誤
security_opt 設定中的 seccomp:<filepath> 項目現在正確地將檔案內容傳送至引擎
up 和 down 操作的 ANSI 輸出不應再影響錯誤的行
改進對非 Unicode 地區設定的支援
修復 Windows 上使用者家目錄名稱包含非 ASCII 字元時發生的崩潰
修復建置期間因建置上下文中具有負 mtime 值的檔案而導致的錯誤
修復串流建置進度時的編碼錯誤

1.19.0

(2018-02-07)

重大變更

在 UNIX 平台上，互動式 run 和 exec 指令現在預設要求在客戶端安裝 docker CLI。若要恢復之前的行為，使用者可以設定 COMPOSE_INTERACTIVE_NO_CLI 環境變數。

新功能

Compose 檔案版本 3.x

config 指令的輸出現在應以更精確的方式合併來自多個 Compose 檔案的 deploy 選項

Compose 檔案版本 2.3

新增對服務定義中 runtime 選項的支援

Compose 檔案版本 2.1 及以上

新增對 ${VAR:?err} 和 ${VAR?err} 變數插值語法的支援，以指示強制性變數

Compose 檔案版本 2.x

在服務網路對應中新增 priority 鍵，允許使用者定義指定服務連線至每個網路的順序

所有格式

在 up 指令中新增 --renew-anon-volumes（縮寫 -V），防止 Compose 從之前的容器恢復匿名磁碟區的磁碟區資料
新增同時平行操作數量的限制，這應防止伺服器的意外資源耗盡。預設值為 64，可使用 COMPOSE_PARALLEL_LIMIT 環境變數進行設定
在 up 指令中新增 --always-recreate-deps 旗標，以強制重建相依服務以及相依項所有者
新增 COMPOSE_IGNORE_ORPHANS 環境變數以放棄孤立容器偵測並抑制警告
新增 COMPOSE_FORCE_WINDOWS_HOST 環境變數以強制 Compose 將磁碟區定義解析為 Docker 主機是 Windows 系統，即使 Compose 本身目前在 UNIX 上執行
Bash 完成功能現在應該能更好地區分正在執行、已停止和已暫停的服務

錯誤修復 (Bug fixes)

修復導致 build 指令在建置上下文包含不可讀檔案或 FIFO 物件時報告連線錯誤的錯誤。這些檔案類型現在將被適當處理
修復圍繞互動式 run/exec 工作階段的各種問題。
修復同時設定 TLS 選項與環境和 CLI 旗標導致設定部分被忽略的錯誤
修復 DOCKER_TLS_VERIFY 環境變數被 Compose 忽略的錯誤
修復 up 中的 -d 和 --timeout 旗標被錯誤地標記為不相容的錯誤
修復如果與先前容器相關聯的映像檔已被移除，服務的重建會中斷的錯誤
修復更新掛載目標時，試圖重建關聯服務會導致 Compose 中斷的錯誤
修復使用 3.2 版本 Compose 檔案中擴充語法宣告的 tmpfs 磁碟區被錯誤地建立為匿名磁碟區的錯誤
修復類型轉換錯誤會列印堆疊追蹤而非優雅退出的錯誤
修復一些與 Unicode 處理相關的錯誤
如果相依服務的設定未變更，它們不再與相依項所有者一起重建
新增對 Compose 檔案中 labels 欄位的更好驗證。包含純量類型（數字、布林值）的標籤值現在會自動轉換為字串

1.18.0

(2017-12-18)

新功能

Compose 檔案版本 3.5

引入 docker-compose.yml 規格的 3.5 版本。此版本需要 Docker Engine 17.06.0 或以上版本
新增對建置設定中 shm_size 參數的支援
新增對服務定義中 isolation 參數的支援
新增對網路、密鑰和配置定義自訂名稱的支援

Compose 檔案版本 2.3

新增對建置設定中 extra_hosts 的支援
新增對磁碟區條目長語法的支援，正如之前在 3.2 格式中引入的那樣。使用此語法將建立掛載而非磁碟區。

Compose 檔案版本 2.1 及以上

新增對服務定義中 oom_kill_disable 參數的支援（僅限 2.x）
新增對網路定義自訂名稱的支援（僅限 2.x）

所有格式

從環境插值的值現在在用於非字串欄位時會轉換為適當類型。
新增對 docker-compose run 中 --label 的支援
新增對 docker-compose down 中 --timeout 的支援
新增對 docker-compose build 中 --memory 的支援
在服務定義中設定 stop_grace_period 現在也會設定容器的 stop_timeout

錯誤修復 (Bug fixes)

修復 Compose 仍根據舊版引擎行為處理服務主機名稱的問題，導致包含點的主機名稱被切割
修復 X-Y:Z 埠語法被 Compose 視為無效的問題
修復導致重複訊息和不優雅輸出的 CLI 記錄問題
修復使用多個 Compose 檔案時 stop_grace_period 被忽略的問題
修復導致 docker-compose images 在使用未標籤映像檔時崩潰的錯誤
修復有效 ${VAR:-} 語法導致 Compose 出錯的錯誤
修復使用 UTF-8 BOM 的 env_file 項目讀取不正確的錯誤
修復遺失密鑰檔案會在原地產生空白目錄的錯誤
修復 CLI 錯誤處理常式中的字元編碼問題
新增對健康檢查中 test 欄位的驗證
新增對 IPAM 設定中 subnet 欄位的驗證
新增在服務定義中使用長語法時對 volumes 屬性的驗證
CLI 現在明確防止在 docker-compose up 中同時使用 -d 和 --timeout

1.17.0

(2017-11-01)

新功能

Compose 檔案版本 3.4

引入 docker-compose.yml 規格的 3.4 版本。此版本需要與 Docker Engine 17.06.0 或以上版本搭配使用。
新增對建置設定中 cache_from、network 和 target 選項的支援
新增對 update_config 區段中 order 參數的支援
新增使用 name 參數在磁碟區定義中設定自訂名稱的支援

Compose 檔案版本 2.3

新增對建置設定中 shm_size 選項的支援

Compose 檔案版本 2.x

新增對擴充欄位 (x-*) 的支援。同樣適用於 v3.4 檔案

所有格式

在 up 指令中新增 --no-start，允許使用者建立所有資源（網路、磁碟區、容器）而不啟動服務。create 指令已棄用，以利於此新選項

錯誤修復 (Bug fixes)

修復 extra_hosts 值被擴充檔案覆寫而非合併的錯誤
修復 v3.2 檔案的驗證導致無法在服務磁碟區定義中使用 consistency 欄位的錯誤
修復當預期唯一項目的設定欄位包含重複項目時導致崩潰的錯誤
修復具有不同模式的掛載覆寫會建立重複項目而非覆寫原始項目的錯誤
修復宣告為清單的建置標籤無法正確解析的錯誤
修復 docker-compose config 的輸出對於某些版本來說無效，如果檔案包含自訂名稱的外部磁碟區
改進在 Windows 上使用不支援的檔案版本發出建置指令時的錯誤處理
修復同時執行 up 指令時有時會建立相同名稱網路的問題。

1.16.0

(2017-08-31)

新功能

Compose 檔案版本 2.3

引入 docker-compose.yml 規格的 2.3 版本。此版本需要與 Docker Engine 17.06.0 或以上版本搭配使用。
新增對建置設定中 target 參數的支援
新增對健康檢查設定中 start_period 參數的支援

Compose 檔案版本 2.x

新增對服務定義中 blkio_config 參數的支援
新增使用 name 參數在磁碟區定義中設定自訂名稱的支援（不適用於 2.0 版本）

所有格式

新增 CLI 旗標 --no-ansi 以抑制輸出中的 ANSI 控制字元

錯誤修復 (Bug fixes)

修復巢狀 extends 指令未正確解析導致「找不到檔案」錯誤的錯誤
修復 .dockerignore 解析的幾個問題
修復啟用 TTY 服務的記錄列印不正確並導致 MemoryError 例外錯誤的問題
修復列印應用程式記錄時有時會被 Python 3 上的 UnicodeEncodeError 例外錯誤中斷的錯誤
docker-compose config 輸出中的 $ 字元現在已正確跳脫
修復執行 docker-compose top 有時會因未捕獲例外錯誤而失敗的錯誤
修復 docker-compose pull 與 --parallel 旗標在失敗時傳回 0 退出代碼的錯誤
修復 deploy.resources 中的鍵未經過驗證的問題
修復 docker-compose config 輸出中的 logging 選項會被設為 null（一個無效值）的問題
修復映像檔來自使用顯式埠號的私人儲存庫時 docker-compose images 指令的輸出
修復當埠定義使用 0 作為發布埠值時 docker-compose config 的輸出

1.15.0

(2017-07-26)

新功能

Compose 檔案版本 2.2

新增對建置設定中 network 參數的支援。

Compose 檔案版本 2.1 及以上

服務定義中的 pid 選項現在支援 service:<name> 值。
新增對服務定義中 storage_opt 參數的支援。此選項不適用於 v3 格式

所有格式

在 docker-compose pull 中新增 --quiet 旗標，抑制進度輸出
對 CLI 輸出進行了一些改進

錯誤修復 (Bug fixes)

透過 docker-compose run 的 --volume 旗標指定的磁碟區現在會補充服務定義中宣告的磁碟區，而非取代它們
修復使用多個 Compose 檔案會取消設定 Compose 檔案內定義的 scale 值的錯誤。
修復 config.json 檔案中的 credHelpers 項目未被 Compose 遵守的問題
修復使用多個具有埠宣告的 Compose 檔案導致 Python 3 環境失敗的錯誤
修復使用者環境中存在某些與 Proxy 相關的選項導致 Compose 無法執行的問題
修復如果原始檔案使用 Y 或 N 值導致 docker-compose config 輸出無效的問題
修復在 Windows Engine 上對先前建立的堆疊執行 up 操作的問題。

1.14.0

(2017-06-19)

新功能

Compose 檔案版本 3.3

引入 docker-compose.yml 規格的 3.3 版本。此版本需要 Docker Engine 17.06.0 或以上版本。注意：credential_spec 和 configs 鍵僅適用於 Swarm 服務，將被 Compose 忽略

Compose 檔案版本 2.2

在服務定義中新增以下參數：cpu_count、cpu_percent、cpus

Compose 檔案版本 2.1

新增對建置標籤的支援。此功能也適用於 2.2 和 3.3 格式。

所有格式

為 docker-compose exec 中的 --user 旗標新增縮寫 -u
Compose 檔案與遠端網路之間的標籤差異現在將列印警告，而不是阻止重新部署。

錯誤修復 (Bug fixes)

修復執行 docker-compose run 指令時服務相依項被重新擴展為預設 scale 的錯誤
修復 docker-compose rm 與 --stop 旗標在提供要移除的服務清單時行為不正確的錯誤
修復使用多個 Compose 檔案時，建置區段中的 cache_from 被忽略的錯誤。
修復使用多個 Compose 檔案時，將相同埠繫結到不同 IP 導致失敗的錯誤。
修復如果覆寫檔案具有 .yaml 副檔名則 Compose 不會載入它們的錯誤
修復 Windows Engine 上網路被錯誤標記為需重建的錯誤
修復宣告埠的服務導致某些 Python 3 版本崩潰的錯誤
修復 docker-compose config 輸出有時包含無效埠定義的錯誤

1.13.0

(2017-05-02)

重大變更

docker-compose up 現在將服務的擴展重設為預設值。您可以使用新引入的 --scale 選項來指定自訂擴展值

新功能

Compose 檔案版本 2.2

引入 docker-compose.yml 規格的 2.2 版本。此版本需要 Docker Engine 1.13.0 或以上版本
新增對服務定義中 init 的支援。
新增對服務定義中 scale 的支援。設定的值可以使用 docker-compose up 中的 --scale 旗標覆寫。對於此檔案格式，scale 指令已停用

Compose 檔案版本 2.x

新增對網路定義 ipam 區段中 options 的支援

錯誤修復 (Bug fixes)

修復透過 -f 選項提供給 compose 的路徑未正確解析的錯誤
修復埠區段中的 ext_ip::target_port 標記法被錯誤標記為無效的問題
修復使用 -d 旗標時 exec 指令有時無法將控制權返回終端機的問題
修復 v3.2 檔案的 config 指令輸出中遺失密鑰的錯誤
修復若無網路連線 docker-compose 會凍結的問題
修復透過 -f 旗標傳遞包含 Unicode 字元的路徑導致 Compose 崩潰的問題
修復若 Compose 檔案包含外部密鑰，docker-compose config 輸出無效的問題
修復若 Compose 安裝在 Python 3 環境中，使用 up 搭配 --exit-code-from 會失敗的錯誤
修復使用 tmpfs 和 volumes 的組合重建容器導致無效設定狀態的錯誤

1.12.0

(2017-04-04)

新功能

Compose 檔案版本 3.2

引入 docker-compose.yml 規格的 3.2 版本
新增對服務 build 區段中 cache_from 的支援
新增對服務定義中全新展開式 ports 語法的支援
新增對服務定義中全新展開式 volumes 語法的支援

Compose 檔案版本 2.1

新增對服務定義中 pids_limit 的支援

Compose 檔案版本 2.0 以上

為 docker-compose config 新增 --volumes 選項，可列出該專案宣告的命名卷冊（named volumes）
新增對服務定義中 mem_reservation 的支援（僅限 2.x 版本）
新增對服務定義中 dns_opt 的支援（僅限 2.x 版本）

所有格式

新增 docker-compose images 指令，可列出當前專案容器所使用的映像檔
為 docker-compose rm 新增 --stop（簡寫為 -s）選項，可在移除前先停止執行中的容器
為 docker-compose config 新增 --resolve-image-digests 選項，可將每個服務的映像檔版本鎖定為永久的摘要（digest）
為 docker-compose up 新增 --exit-code-from SERVICE 選項。使用此選項時，當任何容器退出，docker-compose 將會以指定服務的退出代碼進行退出
為 docker-compose pull 新增 --parallel 選項，可同時拉取多個服務的映像檔
為 docker-compose build 新增 --build-arg 選項
為 docker-compose run 新增 --volume <volume_mapping>（簡寫為 -v）選項，以宣告執行時期需掛載的卷冊
為 docker-compose 新增 --project-directory PATH 選項，會影響專案的路徑解析
當在 docker-compose up 中使用 --abort-on-container-exit 時，導致中止的容器之退出代碼，將成為 docker-compose up 指令的退出代碼
使用者現在可以使用 COMPOSE_PATH_SEPARATOR 環境變數，來設定 COMPOSE_FILE 環境變數值中所使用的路徑分隔字元
新增在連接埠映射（port mappings）中支援從連接埠範圍到單一連接埠的寫法，例如 8000-8010:80。

錯誤修復 (Bug fixes)

docker-compose run --rm 現在會在執行後移除匿名卷冊，這與 docker run --rm 的行為一致。
修正了覆寫檔案（override files）包含連接埠列表時會引發 TypeError 的錯誤
修正了 docker-compose config 的輸出中會遺失 deploy 金鑰的錯誤
修正了擴充或縮減服務時，有時會重複使用過時容器的錯誤
修正了若專案宣告了匿名卷冊，docker-compose config 的輸出會無效的錯誤
變數插值（Variable interpolation）現在能正確應用在 Compose 檔案的 secrets 區段中
secrets 區段現在能正確出現在 docker-compose config 的輸出中
修正了部分網路屬性變更時，無法針對先前建立的網路偵測到差異的錯誤
修正了 docker-compose 在嘗試寫入已關閉的管道（closed pipe）時會當機的錯誤
修正了當 Compose 與指令列 TLS 旗標結合使用時，無法讀取 COMPOSE_TLS_VERSION 值的問題

1.11.2

(2017-02-17)

錯誤修復 (Bug fixes)

修正了導致 secrets 設定無法正確載入的錯誤
修正了當設定檔包含 secrets 定義時，docker-compose config 指令會失敗的錯誤
修正了在某些 Linux 發行版上，Compose 會載入過時 requests 函式庫版本的問題
修正了在建置資料夾內的 socket 型別檔案會導致 docker-compose 在嘗試建置該服務時當機的問題
修正了 .dockerignore 檔案中無法辨識遞迴萬用字元 ** 的問題。

1.11.1

(2017-02-09)

錯誤修復 (Bug fixes)

修正了 Compose 解析器無法辨識 3.1 檔案格式為有效的錯誤

1.11.0

(2017-02-08)

新功能

Compose 檔案版本 3.1

引入 docker-compose.yml 規格的 3.1 版本。此版本需要 Docker Engine 1.13.0 或以上版本。它引入了對 secrets 的支援。詳細資訊請參閱說明文件

Compose 檔案版本 2.0 以上

引入 docker-compose top 指令，可顯示 Compose 所管理的各個服務目前執行的處理程序。

錯誤修復 (Bug fixes)

修正了繼承一個定義了 healthcheck 字典的服務時，會導致 docker-compose 出錯的錯誤。
修正了使用多個 Compose 檔案時，服務定義中的 pid 項目會被忽略的問題。

1.10.1

(2017-02-01)

錯誤修復 (Bug fixes)

修正了存在舊版 docker-py 套件時，執行 Compose 會導致意外當機的問題
修正了使用多個 Compose 檔案時，healthcheck 相依性會遺失的問題
修正了數個導致 config 指令輸出無效的問題
修正了在 v3 Compose 檔案中加入卷冊標籤（volume labels）會導致錯誤的問題
修正了 Windows 上建置內容路徑（build context paths）包含 Unicode 字元時編碼不正確的問題
修正了容器停止或重啟時，Compose 在串流紀錄（streaming logs）時偶爾會當機的錯誤

1.10.0

(2017-01-18)

新功能

Compose 檔案版本 3.0

引入 docker-compose.yml 規格的 3.0 版本。此版本需搭配 Docker Engine 1.13 或以上版本使用，且專為 docker stack 指令設計。

Compose 檔案版本 2.1 及以上

現在可以在服務定義中使用 healthcheck 參數來進行健康檢查設定
使用 depends_on 宣告容器相依性時，現在可以設定為等待健康檢查通過後才啟動。請參閱說明文件以獲取更新後的語法。
注意
此功能不會移植到 v3 Compose 檔案。
新增對服務定義中 sysctls 參數的支援
新增對服務定義中 userns_mode 參數的支援
Compose 現在會在其建立的網路和卷冊中加入識別標籤

Compose 檔案版本 2.0 以上

新增對服務定義中 stop_grace_period 選項的支援。

錯誤修復 (Bug fixes)

彩色輸出現在可以在 Windows 上正常運作。
修正了 docker-compose run 在 Windows 互動模式下無法設定連結別名的錯誤。
由 Compose 建立的網路現在皆為可附加（attachable）狀態（Compose 檔案 v2.1 以上）。
修正了 COMPOSE_CONVERT_WINDOWS_PATHS 的偽值（0, false, 空值）會被錯誤解讀為 true 的錯誤。
修正了 Windows 上某些 .dockerignore 模式中的正斜線無法被正確解析的錯誤

1.9.0

(2016-11-16)

重大變更

在 Windows 上使用 Docker Toolbox/Machine 時，卷冊路徑預設不再轉換為 /c/Users 風格。若要重新啟用此轉換以維持卷冊運作，請設定環境變數 COMPOSE_CONVERT_WINDOWS_PATHS=1。Docker for Windows 使用者不受影響，無需設定此變數。

新功能

Windows 平台上現在支援 docker-compose run 和 docker-compose exec 的互動模式。此功能運作需系統中已安裝 docker 二進位檔。
引入 docker-compose.yml 規格的 2.1 版本。此版本需搭配 Docker Engine 1.12 或以上版本使用。
- 新增對在 docker-compose.yml 中設定卷冊標籤與網路標籤的支援。
- 新增對服務定義中 isolation 參數的支援。
- 新增對服務網路定義中連結本地（link-local）IP 的支援。
- 新增對變數插值中 Shell 風格內聯預設值的支援。支援格式為 ${FOO-default}（若 FOO 未設定則使用預設值）及 ${FOO:-default}（若 FOO 未設定或為空則使用預設值）。
新增對服務定義中 group_add 和 oom_score_adj 參數的支援。
新增對網路定義中 internal 和 enable_ipv6 參數的支援。
Compose 在 Windows 上現在預設使用 npipe 協定。
覆寫 logging 設定時，若 driver 值不衝突，現在能正確合併 options 對應表。

錯誤修復 (Bug fixes)

修正了數個 Windows 上關於 npipe 協定支援的錯誤。
修正了在 Windows Server 上使用 Docker 時，Windows 路徑被錯誤轉換的問題。
修正了空的 restart 值有時會導致引發異常的錯誤。
修正了包含 Unicode 字元的服務紀錄有時會導致錯誤的問題。
修正了環境變數中的 Unicode 值在擷取時有時會引發 Unicode 異常的錯誤。
修正了 Compose 會錯誤偵測疊加網路（overlay networks）設定不相符的問題。

1.8.1

(2016-09-22)

錯誤修復 (Bug fixes)

修正了使用憑證儲存庫（credentials store）的使用者無法存取私人映像檔的錯誤。
修正了使用識別權杖（identity tokens）進行驗證的使用者無法存取私人映像檔的錯誤。
修正了 Docker 設定檔中若有 HttpHeaders 項目，會導致 Compose 在嘗試建置映像檔時當機的錯誤。
修正了數個關於卷冊繫結宣告中 Windows 路徑處理的錯誤。
修正了 Compose 在嘗試讀取來自引擎的串流回應時偶爾會當機的錯誤。
修正了 Compose 在串流容器紀錄時遇到 API 錯誤會當機的問題。
修正了 Compose 會錯誤嘗試輸出引擎 API 未處理的驅動程式紀錄的問題。
修正了 docker-machine config 指令的選項無法被 Compose 正確解讀的錯誤。
修正了同時執行大量服務時，與 Docker Engine 的連線有時會失敗的錯誤。
修正了執行 bundle 指令時，Compose 有時會顯示誤導性建議訊息的問題。
修正了專案初始化階段中，連線錯誤無法被 Compose 正確處理的錯誤。
修正了遭遇連線逾時（connection timeout）時會出現誤導性錯誤訊息的錯誤。

1.8.0

(2016-06-14)

破壞性變更

如 1.7.0 所宣布，docker-compose rm 現在預設會移除由 docker-compose run 建立的容器。
在服務上設定 entrypoint 現在會清空映像檔上設定的任何預設指令（例如 Dockerfile 中用於建置該映像檔的 CMD 指令）。這使其與 docker run 的 --entrypoint 旗標保持一致。

新功能

新增 docker-compose bundle，此指令可建置一個用於 Docker 1.12 新版 Docker Stack 指令的綁定檔案。
新增 docker-compose push，此指令可將服務映像檔推送到註冊中心。
Compose 現在支援使用 COMPOSE_TLS_VERSION 環境變數，為與 Docker Engine 的互動指定自訂 TLS 版本。

錯誤修復 (Bug fixes)

修正了 Compose 當專案根目錄中的 .env 實際上是一個目錄時，會錯誤嘗試讀取它的錯誤。
docker-compose run -e VAR 現在會如同 docker run -e VAR 一樣，將 VAR 從 Shell 傳遞給容器。
改進了涉及多個 compose 檔案時，多個服務子鍵的設定合併方式。
修正了包含 Windows 磁碟機的卷冊對映有時會被錯誤解析的錯誤。
修正了 Windows 環境下，主機根目錄的卷冊對映會被錯誤解析的錯誤。
修正了若指定了外部網路，docker-compose config 會輸出無效 Compose 檔案的錯誤。
修正了未設定的建置參數（buildargs）會被賦值為包含 'None' 字串，而非預期的空值之問題。
修正了 Windows 上「是/否」提示在接收輸入前不會顯示的錯誤。
修正了在 Windows 上嘗試執行不帶 -d 選項的 docker-compose exec 時會以堆疊追蹤（stacktrace）退出的錯誤。目前這仍會失敗，但會以更優雅的方式處理。
修正了 docker-compose up 期間發生錯誤時，流程結束時會顯示無關堆疊追蹤的錯誤。
docker-compose create 和 docker-compose start 在出錯時會顯示更具描述性的錯誤訊息。

1.7.1

(2016-05-04)

錯誤修復 (Bug fixes)

修正了 v1 檔案的 docker-compose config 輸出會是無效設定檔的錯誤。
修正了 docker-compose config 未檢查連結有效性的錯誤。
修正了 docker-compose help 未按預期輸出可用指令與通用選項列表的問題。
修正了使用 docker-compose logs 按服務篩選時，不適用於新建立服務的問題。
修正了在 Python 3 上使用 Compose 時，未變更的服務有時會在 up 階段被重新建立的錯誤。
修正了 up 階段遇到的 API 錯誤未被 Compose 識別為失敗狀態的問題。
修正了在非 Windows 平台上因未定義異常名稱而引發 NameError 的錯誤。
修正了安裝 Compose 時偶爾會安裝到錯誤版本 docker-py 的錯誤。
修正了 docker-machine config default 輸出的主機值，無法被 docker-compose 指令列識別為有效選項的錯誤。
修正了 Compose 在讀取由 Swarm 叢集廣播的事件時偶爾會意外退出的問題。
更正文件中關於 .env 檔案位置的敘述，該檔案確實是從當前目錄讀取，而非與 Compose 檔案相同的位置。

1.7.0

(2016-04-13)

破壞性變更

docker-compose logs 預設不再追蹤紀錄輸出。現在它與 docker logs 的行為一致，在列印當前紀錄後即退出。請使用 -f 以獲得舊的預設行為。
Compose 檔案中的對映值不再允許使用布林值（針對 environment、labels 和 extra_hosts 鍵）。先前這僅是一個警告。布林值應加上引號，使其成為字串值。

新功能

Compose 現在會在執行目錄中尋找 .env 檔案，並讀取其中定義的環境變數（若 Shell 環境中尚未設定）。這可讓您輕鬆地為 Compose 檔案中使用的變數，或任何 COMPOSE_* 或 DOCKER_* 變數設定預設值。
為 docker-compose up 和 docker-compose down 新增 --remove-orphans 旗標，以移除已從 Compose 檔案中刪除的服務之容器。
為 docker-compose rm 新增 --all 旗標，以包含由 docker-compose run 建立的容器。這將在下一版 Compose 中成為預設行為。
新增對 docker 用戶端所使用的所有相同 TLS 設定旗標的支援：--tls、--tlscert、--tlskey 等。
Compose 檔案現在支援 tmpfs 和 shm_size 選項。
為 docker-compose run 新增 --workdir 旗標
docker-compose logs 現在會顯示啟動後建立的新容器之紀錄。
COMPOSE_FILE 環境變數現在可以包含多個檔案，並以主機系統的標準路徑分隔字元分隔（Mac/Linux 為 :，Windows 為 ;）。
現在可以使用 ipv4_address 和 ipv6_address 選項，在將服務連線至網路時指定靜態 IP 位址。
為 docker-compose logs 指令新增 --follow、--timestamp 和 --tail 旗標。
docker-compose up 和 docker-compose start 現在會在可能的情況下並行啟動容器。
docker-compose stop 現在會依照相依性的相反順序停止容器，而非同時停止。
為 docker-compose up 新增 --build 旗標以強制建置新映像檔。若未使用此旗標但自動建置了映像檔，現在會顯示警告。
新增 docker-compose exec 指令，用於在執行中的容器內執行處理程序。

錯誤修復 (Bug fixes)

docker-compose down 現在會移除由 docker-compose run 建立的容器。
在使用 tty 執行 up 時發生逾時，會顯示更適當的錯誤訊息。
修正了 docker-compose down 中若部分資源已被移除會中止的錯誤。
修正了網路別名變更無法觸發服務重建的錯誤。
修正了卷冊已存在時，仍會列印建立新卷冊之紀錄訊息的錯誤。
修正了中斷 up 時不一定會關閉容器的錯誤。
修正了 v1 Compose 檔案格式中繼承服務時，log_opt 和 log_driver 未正確攜帶的錯誤。
修正了空的建置參數（build args）值會導致檔案驗證失敗的錯誤。

1.6.2

(2016-02-23)

修正了連線至啟用 TLS 的 Docker Engine 時，會因憑證驗證錯誤而失敗的錯誤。

1.6.1

(2016-02-23)

錯誤修復 (Bug fixes)

修正了多次重建容器會導致新容器啟動時遺失先前卷冊的錯誤。
修正了 Compose 會將未設定的環境變數值設為空字串，而非設為無值的鍵之錯誤。
在 Compose 需要較新版本的 Docker API 時，提供更好的錯誤訊息。
新增遺失的 config 欄位 network.aliases，允許為服務設定網路範圍的別名。
修正了 run 不會啟動 depends_on 中列出服務的錯誤。
修正了使用繼承或多個 Compose 檔案時，networks 和 network_mode 未合併的錯誤。
修正了服務別名的錯誤，原本容器短 ID 別名僅包含 10 個字元，而非先前版本使用的 12 個字元。
新增建立新命名卷冊時遺失的紀錄訊息。
修正了使用 extends 或多個 Compose 檔案時，build.args 未合併的錯誤。
修正了在應使用對應表時若使用了空值或不正確型別，導致 config 驗證發生問題的錯誤。
修正了若 build 區段未包含 context，會顯示堆疊追蹤而非有用驗證訊息的錯誤。
改進與 Swarm 的相容性，僅在服務使用匿名容器卷冊時，才設定容器對該服務容器前一個執行個體的親和性（affinity）。先前親和性總是在所有容器上設定。
修正了若使用數字而非字串，部分 driver_opts 的驗證會導致錯誤的問題。
對 Compose 容器安裝選項所使用的 run.sh 指令碼進行了一些改進。
修正了 up --abort-on-container-exit 的一個錯誤，Compose 會退出但不會停止其他容器。
更正了在對應中將布林值作為值使用時，所列印的警告訊息。

1.6.0

(2016-01-15)

主要功能

Compose 1.6 引入了 docker-compose.yml 的新格式，讓您可以在 Compose 檔案中定義網路和卷冊，以及服務。它還對某些設定選項的結構做了一些更改。
您不需要使用它 - 您現有的 Compose 檔案在 Compose 1.6 上將會完全依照今天的方式運作。
請查看升級指南以獲取完整詳情。
對網路的支援已脫離實驗性質，並成為啟用容器間通訊的建議方式。
如果您使用新檔案格式，您的應用程式將使用網路功能。如果您還沒準備好，只需維持您的 Compose 檔案不變，它仍將同樣運作。
預設情況下，您無需設定任何網路。事實上，在 Compose 中使用網路功能比使用連結（links）設定更少。請參閱網路指南了解如何使用它。
Compose 1.5 中引入的實驗性旗標 --x-networking 和 --x-network-driver 已被移除。
如果您使用新檔案格式，現在可以將引數傳遞給建置
```
build:
  context: .
  args:
    buildno: 1
```
如果您使用新檔案格式，現在可以同時指定 build 和 image 金鑰。docker-compose build 將會建置映像檔並標記您指定的名稱，而 docker-compose pull 將嘗試拉取它。
新增了一個 events 指令，用於從應用程式監控容器事件，就像 docker events 一樣。這是一個很好的基礎，可用於在 Compose 之上建置工具，以便在發生特定事件（如容器啟動和停止）時執行動作。
新增了一個 depends_on 選項，用於指定服務之間的相依性。這會強制執行啟動順序，並確保當您對具有相依性的服務執行 docker-compose up SERVICE 時，這些相依服務也會一併啟動。

新功能

新增了一個 config 指令，該指令會在進行變數插值、解析相對路徑並合併多個檔案和 extends 後，驗證並列印 Compose 設定。
新增了一個 create 指令，用於建立容器而不啟動它們。
新增了一個 down 指令，以單一指令停止並移除由 up 建立的所有資源。
新增對 cpu_quota 設定選項的支援。
新增對 stop_signal 設定選項的支援。
指令 start、restart、pause 和 unpause 若沒有任何容器被修改，現在會以錯誤狀態代碼退出。
為 up 新增了一個 --abort-on-container-exit 旗標，這會使 up 在第一個容器退出時停止所有容器並退出。
移除對 FIG_FILE、FIG_PROJECT_NAME 的支援，且不再讀取 fig.yml 作為預設 Compose 檔案位置。
移除 migrate-to-labels 指令。
移除 --allow-insecure-ssl 旗標。

錯誤修復 (Bug fixes)

修正了一個驗證錯誤，該錯誤阻止在 expose 欄位中使用連接埠範圍。
修正了一個驗證錯誤，該錯誤阻止在 entrypoint 欄位中使用包含重複項目的陣列。
修正了一個導致 ulimits 在與 extends 一起使用時被忽略的錯誤。
修正了一個阻止 extra_hosts 中使用 ipv6 位址的錯誤。
修正了一個導致 extends 在從多個 Compose 檔案包含時被忽略的錯誤。
修正了一個在 Compose 檔案中定義容器卷冊時的不正確警告。
修正了一個阻止 up 和 logs 強制關閉行為的錯誤。
修正了一個當使用預設網路驅動程式時，None 會被列印為網路驅動程式名稱的錯誤。
修正了一個使用字串形式的 dns 或 dns_search 會導致錯誤的錯誤。
修正了一個在容器處於重啟狀態時，仍會回報為「Up」的錯誤。
修正了一個當 DOCKER_CERT_PATH 未正確設定時，令人困惑的錯誤訊息。
修正了一個若容器使用非標準紀錄驅動程式（或完全沒有），則連接至容器會失敗的錯誤。

1.5.2

(2015-12-03)

修正了一個破壞 environment 和 env_file 與 extends 一起使用的錯誤，且導致環境鍵在沒有值時具有 None 值，而非主機環境的值。
修正了 1.5.1 中的回歸問題，該問題導致在重建容器時錯誤地引發關於卷冊的警告。
修正了一個阻止建置使用 ADD <url> 的 Dockerfile 的錯誤。
修正了 docker-compose restart 的一個錯誤，該錯誤阻止它啟動已停止的容器。
修正 SIGTERM 和 SIGINT 的處理，以正確停止容器
新增對使用 url 作為 build 值的支援
改進對 expose 選項的驗證

1.5.1

(2015-11-12)

為 build 新增 --force-rm 選項。
在 Compose 檔案中為服務新增 ulimit 選項。
修正了一個錯誤，若服務從使用 image 變更為使用 build，up 會出現「service needs to be built」錯誤。
修正了一個導致某些終端機上並行作業輸出不正確的錯誤。
修正了一個當 volumes_from 的模式變更時，阻止重建容器的錯誤。
修正了 1.5.0 中的回歸問題，非 utf-8 Unicode 字元會導致 up 或 logs 當機。
修正了 1.5.0 中的回歸問題，當指令因與 Docker daemon 通訊的 HTTP 逾時而失敗時，Compose 會使用成功退出狀態代碼。
修正了 1.5.0 中的回歸問題，name 被視為有效的服務選項，這會覆寫服務的實際名稱。
使用 --x-networking 時，Compose 不再將主機名稱設定為容器名稱。
使用 --x-networking 時，Compose 僅在至少有一個容器使用該網路時，才會建立預設網路。
在 up 或 logs 期間列印紀錄時，在每一行後刷新輸出緩衝區，以防止緩衝問題導致紀錄隱藏。
若服務的相依性正在被建立，則重新建立該容器。先前容器僅在相依性已存在但也在被重建時，才會被重建。
新增警告，當 Compose 檔案中的 volume 被忽略並被先前容器的容器卷冊遮蓋時。
在沒有 tty 的情況下執行時，改進 pull 的輸出。
使用多個 Compose 檔案時，在嘗試合併前先驗證每個檔案。先前無效的檔案會導致無用的錯誤。
允許在 environment 服務選項中的鍵包含破折號。
改進驗證錯誤訊息，將檔名包含在錯誤訊息中。

1.5.0

(2015-11-03)

重大變更

隨著在 Compose 檔案中引入變數替換支援，任何在 command: 或 entrypoint: 欄位中使用環境變數（$VAR 或 ${VAR}）的 Compose 檔案都將損毀。

先前這些值是在容器內進行插值，使用容器環境中的值。在 Compose 1.5.0 中，值將在主機上進行插值，使用主機環境中的值。

若要將 Compose 檔案遷移至 1.5.0，請使用額外的 $ 轉義變數（例如：$$VAR 或 $${VAR}）。請參閱 https://github.com/docker/compose/blob/8cc8e61/docs/compose-file.md#variable-substitution

主要功能

Compose 現在支援 Windows。
環境變數可以在 Compose 檔案中使用。請參閱 https://github.com/docker/compose/blob/8cc8e61/docs/compose-file.md#variable-substitution
可以指定多個 compose 檔案，讓您可以覆寫預設 Compose 檔案中的設定。詳細資訊請參閱 https://github.com/docker/compose/blob/8cc8e61/docs/reference/docker-compose.md。
Compose 現在能在檔案包含無效設定時產生更好的錯誤訊息。
up 現在會等待所有服務退出後才關閉，而不是在一個容器退出後就立即關閉。
可以透過 --x-networking 旗標啟用對新 docker 網路系統的實驗性支援。詳細請參閱此處：https://github.com/docker/docker/blob/8fee1c20/docs/userguide/dockernetworks.md

新功能

現在可以選擇將模式傳遞給 volumes_from。例如，volumes_from: ["servicename:ro"]。
由於 Docker 現在允許您建立具有名稱的卷冊，您可以在 docker-compose.yml 中按名稱參考這些卷冊。例如，volumes: ["mydatavolume:/data"] 會將名為 mydatavolume 的卷冊掛載到容器內的 /data 路徑。
若 volumes 中的項目第一個部分以 .、/ 或 ~ 開頭，它將被視為路徑，並根據需要進行相對路徑擴展。否則，它將被視為卷冊名稱並直接傳遞給 Docker。
在此處閱讀更多關於命名卷冊和卷冊驅動程式的資訊：https://github.com/docker/docker/blob/244d9c33/docs/userguide/dockervolumes.md
docker-compose build --pull 指示 Compose 在建置前為每個 Dockerfile 拉取基礎映像檔。
docker-compose pull --ignore-pull-failures 指示 Compose 若無法拉取單一服務的映像檔時繼續執行，而非中止。
現在可以使用 ipc 選項在 docker-compose.yml 中指定 IPC 命名空間。
由 docker-compose run 建立的容器現在可以使用 --name 旗標進行命名。
如果您使用 pip 安裝 Compose 或將其用作程式庫，它現在適用於 Python 3。
image 現在支援映像檔摘要（除了 id 和標籤外）。例如，image: "busybox@sha256:38a203e1986cf79639cfb9b2e1d6e773de84002feea2d4eb006b52004ee8502d"

ports 現在支援連接埠範圍。例如，

ports:
  - "3000-3005"
  - "9000-9001:8000-8001"

docker-compose run 現在支援 -p|--publish 參數，就像 docker run -p 一樣，用於將特定連接埠發佈到主機。
已實作 docker-compose pause 和 docker-compose unpause，類似於 docker pause 和 docker unpause。
在使用 extends 從同一個 Compose 檔案中的另一個服務複製設定時，可以省略 file 選項。
Compose 可以安裝並作為 Docker 映像檔執行。這是一項實驗性功能。

錯誤修復 (Bug fixes)

Docker daemon 支援的 log_driver 選項的所有值，現在皆由 Compose 支援。
docker-compose build 現在可以成功針對 Swarm 叢集執行。

1.4.2

(2015-09-22)

修正了 1.4.1 版本中的一個回歸問題，該問題會導致不帶 -d 選項的 docker-compose up 立即退出。

1.4.1

(2015-09-10)

錯誤修復 (Bug fixes)

某些設定變更（特別是 links、volumes_from 和 net 的變更）無法正確觸發作為 docker-compose up 一部分的容器重建。
docker-compose up <service> 會顯示所有服務的紀錄，而非僅顯示指定服務的紀錄。
具有自訂容器名稱的容器在紀錄中顯示為 service_number，而非其自訂容器名稱。
擴展服務時，有時即使設定沒有變更，容器仍會被重建。

1.4.0

(2015-08-04)

預設情況下，docker-compose up 現在僅會重新建立自建立以來設定已變更的服務之容器。這對於許多應用程式來說，應能大幅提升速度。
Compose 1.3.0 中引入此功能的實驗性 --x-smart-recreate 旗標已被移除，並新增了 --force-recreate 旗標，供您想要重建所有內容時使用。
Compose 的數個指令 - scale、stop、kill 和 rm - 現在會並行對多個容器執行動作，而非順序執行，這在較大型的應用程式上執行速度會快得多。
現在可以使用 container_name 為服務的容器指定自訂名稱。由於 Docker 容器名稱必須唯一，這意味著您無法將服務擴展超過一個容器。
使用 extends 時不再需要指定 file 選項 - 它將預設為當前檔案。
服務名稱現在可以包含點、破折號和底線。
Compose 現在可以透過指定 - 作為檔名，從標準輸入讀取 YAML 設定，而非從檔案。這使得動態產生設定更容易
```
$ echo 'redis: {"image": "redis"}' | docker-compose --file - up
```
新增了一個 docker-compose version 指令，可列印關於 Compose 捆綁相依性的擴展資訊。
docker-compose.yml 現在支援 log_opt 和 log_driver，允許您將額外的設定傳遞給服務的紀錄驅動程式。
docker-compose.yml 現在支援 memswap_limit，類似於 docker run --memory-swap。
使用 volumes 選項掛載卷冊時，現在可以傳遞 daemon 支援的任何模式，而不僅僅是 :ro 或 :rw。例如，SELinux 使用者可以傳遞 :z 或 :Z。
現在可以使用 docker-compose.yml 中的 volume_driver 選項指定自訂卷冊驅動程式，就像 docker run --volume-driver 一樣。
修正了 Compose 無法從提供純文字（非安全）HTTP 的私人註冊中心拉取映像檔的錯誤。先前用於解決此問題的 --allow-insecure-ssl 旗標已被棄用，現在無效。
修正了若建置相依於私人 Hub 映像檔或私人註冊中心的映像檔，docker-compose build 會失敗的錯誤。
修正了若有 Docker daemon 尚未完成移除的容器，Compose 會當機的錯誤。
修正了兩個錯誤，若 docker-compose.yml 中指定的卷冊路徑帶有尾隨斜線，Compose 有時會因「Duplicate bind mount」錯誤而失敗，或無法將卷冊附加到容器。

感謝 @mnowster, @dnephin, @ekristen, @funkyfuture, @jeffk 和 @lukemarsden！

1.3.3

(2015-07-15)

回歸修復

優雅停止容器時，Compose 將逾時設定為 0，實際上每次都強制執行 SIGKILL。
Compose 有時會根據 Docker API 回傳的容器資料格式而當機。

1.3.2

(2015-07-14)

錯誤修復 (Bug fixes)

當舊版 Compose 透過執行 docker-compose run 建立一次性容器時，docker-compose run 會因名稱衝突而失敗。現在若您遺留了此類容器，Compose 會顯示錯誤，並告知如何移除它們。
Compose 未讀取新位置 ~/docker/config.json 中建立的 Docker 驗證設定檔，因此針對私人註冊中心的驗證會失敗。
當容器附加了偽 TTY 時，其在 docker-compose up 中的輸出會被截斷。
docker-compose up --x-smart-recreate 有時會在映像檔標籤更新時失敗。
docker-compose up 有時會建立兩個具有相同數字後綴的容器。
docker-compose rm 和 docker-compose ps 有時會列出不屬於當前專案的服務（儘管沒有容器被錯誤移除）。
傳遞無效服務名稱時，某些 docker-compose 指令不會顯示錯誤。

感謝 @dano, @josephpage, @kevinsimper, @lieryan, @phemmer, @soulrebel 和 @sschepens！

1.3.1

(2015-06-21)

錯誤修復 (Bug fixes)

docker-compose build 總會在建置前嘗試拉取基礎映像檔。
docker-compose help migrate-to-labels 失敗並出現錯誤。
若未指定網路模式，Compose 會將其設定為 "bridge"，而不是允許 Docker daemon 使用其設定的預設網路模式。

1.3.0

(2015-06-18)

重要備註

此版本包含破壞性變更，您將需要在執行應用程式前移除或遷移現有的容器 - 請參閱安裝說明文件的升級區段以獲取詳情。
Compose 現在需要 Docker 1.6.0 或更高版本。

改進

Compose 現在使用容器標籤而非名稱來追蹤容器。這使得 Compose 既快速又更容易與您自己的工具整合。
Compose 在重建服務容器時不再使用「中間容器」。這使得 docker-compose up 不那麼複雜，且更能抵禦失敗。

新功能

docker-compose up 具備一種實驗性的新行為：它僅會重新建立 docker-compose.yml 中設定已變更的服務之容器。這最終將成為預設行為，但現在您可以試用一下
```
  $ docker-compose up --x-smart-recreate
```
當在專案的子目錄中呼叫時，docker-compose 現在會向上遍歷父目錄，直到找到 docker-compose.yml 為止。

docker-compose.yml 新增了數個新設定鍵

dockerfile，就像 docker build --file 一樣，讓您可以指定與 build 一起使用的替代 Dockerfile。
labels，就像 docker run --labels 一樣，讓您可以為容器新增自訂中繼資料。
extra_hosts，就像 docker run --add-host 一樣，讓您可以新增項目到容器的 /etc/hosts 檔案中。
pid: host，就像 docker run --pid=host 一樣，讓您可以重複使用與主機機器相同的 PID 命名空間。
cpuset，就像 docker run --cpuset-cpus 一樣，讓您可以指定允許在哪些 CPU 上執行。
read_only，就像 docker run --read-only 一樣，讓您可以將容器的檔案系統掛載為唯讀。
security_opt，就像 docker run --security-opt 一樣，讓您可以指定安全選項。
log_driver，就像 docker run --log-driver 一樣，讓您可以指定紀錄驅動程式。

錯誤修復 (Bug fixes)

docker-compose run 的輸出有時會被截斷，特別是在 Jenkins 下執行時。
在 docker-compose.yml 中變更卷冊設定後，服務的卷冊有時不會更新。
針對第三方註冊中心的驗證有時會失敗。
若服務設定了 restart 策略，docker-compose run --rm 將無法移除容器。
若服務在主機上暴露了特定連接埠號，docker-compose scale 會拒絕將服務擴展超過 1 個容器。
Compose 會拒絕建立多個具有相同主機路徑的卷冊項目。

感謝 @ahromis, @albers, @aleksandr-vin, @antoineco, @ccverak, @chernjie, @dnephin, @edmorley, @fordhurley, @josephpage, @KyleJamesWalker, @lsowen, @mchasal, @noironetworks, @sdake, @sdurrheimer, @sherter, @stephenlawrence, @thaJeztah, @thieman, @turtlemonvh, @twhiteman, @vdemeester, @xuxinkun 和 @zwily！

1.2.0

(2015-04-16)

docker-compose.yml 現在支援 extends 選項，使服務能夠繼承另一個設定檔案中服務的設定。這對於在應用程式間共享通用設定，或針對不同環境設定同一個應用程式非常有用。這裡是說明文件。
當與 Swarm 叢集一起使用 Compose 時，相依的容器將被共同排程在同一個節點上。這意味著大多數 Compose 應用程式現在將能直接運作，只要它們不使用 build。
當與 Swarm 叢集一起使用 Compose 時，重複呼叫 docker-compose up 現在能可靠運作。
傳遞給 build 的目錄、傳遞給 env_file 的檔名以及傳遞給 volumes 的卷冊主機路徑，現在被視為相對於 設定檔所在的目錄，而非 docker-compose 執行所在的目錄。在大多數情況下，兩者是一樣的，但如果您使用 -f|--file 引數在其他目錄中指定設定檔，這是一個破壞性變更。
服務現在可以透過 net: container:<service> 與另一個服務共享網路命名空間。
在解析相依性時會考慮 volumes_from 和 net: container:<service> 項目，因此 docker-compose up <service> 將正確啟動 <service> 的所有相依性。
docker-compose run 現在接受 --user 引數，就像 docker run 一樣，用於指定執行指令的使用者。
up、stop 和 restart 指令現在接受 --timeout（或 -t）引數，就像 docker stop 一樣，用於指定優雅停止容器時要等待的時間。
docker-compose rm 現在接受 -f 作為 --force 的簡寫，就像 docker rm 一樣。

感謝 @abesto, @albers, @alunduil, @dnephin, @funkyfuture, @gilclark, @IanVS, @KingsleyKelly, @knutwalker, @thaJeztah 和 @vmalloc！

1.1.0

(2015-02-25)

Fig 已更名為 Docker Compose，簡稱 Compose。這對您有幾個影響

您輸入的指令現在是 docker-compose，而非 fig。
您應該將 fig.yml 更名為 docker-compose.yml。
如果您透過 PyPI 安裝，套件名稱現在是 docker-compose，請使用 pip install docker-compose 安裝。

除此之外，此版本還有許多新功能

我們做了一些小變更以確保 Compose 能與 Swarm（Docker 的新叢集工具）運作 (https://github.com/docker/swarm)。最終您將能夠將 Compose 指向 Swarm 叢集而非單機 Docker 主機，它將在叢集上執行您的容器，無需您進行額外工作。由於 Swarm 仍在發展中，整合尚不完善，許多 Compose 功能還無法運作。
docker-compose run 現在具備 --service-ports 旗標，用於暴露指定服務的連接埠。這對於使用互動式偵錯器執行網頁應用程式很有用。
您現在可以使用 docker-compose.yml 中的 external_links 選項，連結到應用程式之外的容器。
您現在可以使用 --no-build 選項防止 docker-compose up 自動建置映像檔。這會進行較少的 API 呼叫且執行速度更快。
若您在使用 image 金鑰時未指定標籤，Compose 將預設使用 latest 標籤，而非拉取所有標籤。
docker-compose kill 現在支援 -s 旗標，允許您指定要傳送給服務容器的確切訊號。
docker-compose.yml 現在具備 env_file 金鑰，類似於 docker run --env-file，讓您可以在獨立檔案中指定多個環境變數。這對於變數很多，或者您想將敏感資訊排除在版本控制之外時非常有用。
docker-compose.yml 現在支援 dns_search、cap_add、cap_drop、cpu_shares 和 restart 選項，類似於 docker run 的 --dns-search、--cap-add、--cap-drop、--cpu-shares 和 --restart 選項。
Compose 現在附帶 Bash 自動補全功能 - 請參閱安裝與使用說明文件 https://github.com/docker/compose/blob/1.1.0/docs/completion.md
修復了許多錯誤 - 詳情請見里程碑：https://github.com/docker/compose/issues?q=milestone%3A1.1.0+

感謝 @dnephin, @squebe, @jbalonso, @raulcd, @benlangfield, @albers, @ggtools, @bersace, @dtenenba, @petercv, @drewkett, @TFenby, @paulRbr, @Aigeruth 和 @salehe！

1.0.1

(2014-11-04)

新增 --allow-insecure-ssl 選項，允許 fig up、fig run 和 fig pull 從不安全的註冊中心拉取。
修復 fig run 在 Jenkins 中未顯示輸出的問題。
修復 fig 無法建置 Dockerfile 中指向 URL 的 ADD 陳述式之錯誤。

1.0.0

(2014-10-16)

亮點

Fig 加入了 Docker。 Fig 將會繼續維護，但我們也會將 Fig 的精華部分併入 Docker 本身。
這意味著 GitHub 儲存庫已遷移至 https://github.com/docker/fig，我們的 IRC 頻道現在是 Freenode 上的 #docker-fig。
Fig 可與官方 Docker OS X 安裝程式一起使用。Boot2Docker 會掛載主機機器的家目錄，以便卷冊能按預期運作。
Fig 支援 Docker 1.3。
現在可以透過 DOCKER_CERT_PATH 和 DOCKER_TLS_VERIFY 環境變數，使用 TLS 連線到 Docker daemon。
有一個新的 fig port 指令，它會輸出服務的主機連接埠繫結，類似於 docker port。
有一個新的 fig pull 指令，用於拉取服務的最新映像檔。
有一個新的 fig restart 指令，用於重啟服務的容器。
Fig 會透過在服務名稱後加上數字來建立服務中的多個容器。例如，db_1、db_2。為了方便起見，Fig 現在會將第一個容器指定為服務名稱的別名。例如，db。
此連結別名也是一個有效的主機名稱，並已加入 /etc/hosts，因此您可以使用主機名稱連接到連結的服務。例如，與其解析環境變數 DB_PORT_5432_TCP_ADDR 和 DB_PORT_5432_TCP_PORT，您可以直接使用主機名稱 db 和連接埠 5432。
卷冊定義現在支援 ro 模式，擴展 ~ 並擴展環境變數。
建置時支援 .dockerignore。
專案名稱可以使用 FIG_PROJECT_NAME 環境變數設定。
--env 和 --entrypoint 選項已新增至 fig run。
Linux 的 Fig 二進位檔現在連結到較舊版本的 glibc，因此可在 CentOS 6 和 Debian Wheezy 上運作。

其他內容

fig ps 現在可在 Jenkins 上運作，且對 Docker daemon 的 API 呼叫次數更少。
--verbose 顯示更有用的偵錯輸出。
啟動 volumes_from 指向沒有任何執行中容器的服務時，該服務現在將會啟動。
大量說明文件改進。值得注意的是，環境變數已完整記錄，且全程使用官方儲存庫。

感謝 @dnephin, @d11wtq, @marksteve, @rubbish, @jbalonso, @timfreund, @alunduil, @mieciu, @shuron, @moss, @suzaku 和 @chmouel！呼。

0.5.2

(2014-07-28)

為 fig build 新增 --no-cache 選項，就像 docker build --no-cache 一樣繞過快取。
修復 dns: fig.yml 選項，這導致 fig 出錯。
修復 fig 在 Python 2.6 下無法啟動的錯誤。
修復導致 fig 偶爾退出的紀錄串流錯誤。

感謝 @dnephin 和 @marksteve！

0.5.1

(2014-07-11)

若服務定義了指令，沒有進一步引數的 fig run [service] 將執行它。
專案名稱現在預設為包含 fig.yml 的目錄，而非當前工作目錄（若兩者不同）
volumes_from 現在能正確處理容器以及服務
修復 fig up 中重建容器時的競爭條件（race condition）

感謝 @ryanbrainard 和 @d11wtq！

0.5.0

(2014-07-11)

Fig 現在在執行 fig run 或 fig up 時會啟動連結。
例如，如果您有一個相依於 db 服務的 web 服務，fig run web ... 將啟動 db 服務。
環境變數現在可以從 Fig 執行的環境中解析。只需在您的 fig.yml 中將其指定為空白變數，若已設定，它就會被解析
environment: RACK_ENV: development SESSION_SECRET:
volumes_from 現在在 fig.yml 中受支援。來自指定服務和容器的所有卷冊都將被掛載
volumes_from: - service_name - container_name

現在可以在 ports 中指定主機位址

ports: - "0.0.0.0:8000:8000" - "127.0.0.1:8001:8001"

net 和 workdir 選項現在在 fig.yml 中受支援。
hostname 選項現在運作方式與 Docker CLI 相同，拆分為 domainname 選項。
TTY 行為更加穩健，且正確支援大小調整。
安全地載入 YAML 檔案。

感謝 @d11wtq, @ryanbrainard, @rail44, @j0hnsmith, @binarin, @Elemecca, @mozz100 和 @marksteve 對此版本的幫助！

0.4.2

(2014-06-18)

修復使用 fig run、fig up 和 fig build 時的各種編碼錯誤。

0.4.1

(2014-05-08)

新增對 Docker 0.11.0 的支援。（感謝 @marksteve！）
使專案名稱可設定。（感謝 @jefmathiot！）
從 fig run 回傳正確退出代碼。

0.4.0

(2014-04-29)

支援 Docker 0.9 和 0.10
在拉取映像檔時正確顯示進度條
fig up 現在會在任何容器退出時停止所有服務
新增對 fig.yml 中 privileged 設定選項的支援（感謝 @kvz！）
縮短並對齊 fig up 輸出中的紀錄首碼
僅以 fig run 啟動的容器會連結回其自身服務
串流 fig build/run/up 輸出時正確處理 UTF-8（感謝 @mauvm 和 @shanejonas！）
錯誤訊息改進

0.3.2

(2014-03-05)

為 fig run 新增 --rm 選項。（感謝 @marksteve！）
為 fig.yml 新增 expose 選項。

0.3.1

(2014-03-04)

新增貢獻說明。（感謝 @kvz！）
修復 fig rm 拋出錯誤的問題。
修復 Docker 0.8.1 上存在沒有指令的容器時，fig ps 中的一個錯誤。

0.3.0

(2014-03-03)

我們現在為 OS X 和 Linux 提供二進位檔。無需再使用 Pip 安裝！
新增 -f 旗標以指定替代的 fig.yml 檔案
新增對自訂連結名稱的支援
修復重建時有時會掛起的問題
更新 docker-py 以支援 Docker 0.8.0。
各種說明文件改進
各種錯誤訊息改進

感謝 @marksteve, @Gazler 和 @teozkr！

0.2.2

(2014-02-17)

使用 Cormen/Tarjan 拓撲排序解析相依性
修復 fig up 未列印紀錄輸出的問題
按啟動的相反順序停止容器
修復 scale 指令未繫結連接埠的問題

感謝 @barnybug 和 @dustinlacewell 對此版本的工作。

0.2.1

(2014-02-04)

錯誤報告的通用改進 (#77, #79)

0.2.0

(2014-01-31)

將服務連結到其自身，以便 run 指令可以存取執行中的服務。(#67)
更好的說明文件。
使服務相依性解析更可靠。(#48)
載入具有 .yaml 副檔名的 Fig 設定。(#58)

非常感謝 @cameronmaske, @mrchrisadams 和 @damianmoore 對此版本的幫助。

0.1.4

(2014-01-27)

新增不帶專案名稱的連結別名。這使得環境變數稍微簡短一點： REDIS_1_PORT_6379_TCP_ADDR。(#54)

0.1.3

(2014-01-23)

修復連接埠有時設定不正確的問題。(#46)
修復紀錄輸出有時未顯示的問題。(#47)

0.1.2

(2014-01-22)

為 fig run 新增 -T 選項以停用虛擬 TTY。(#34)
修復 fig up 需要拉取 ubuntu 映像檔才能重建容器的問題。(#33) 感謝 @cameronmaske！
提高可靠性，修復方向鍵並修復 fig run 中的競爭條件。(#34, #39, #40)

0.1.1

(2014-01-17)

修復連接埠未正確暴露的錯誤 (#29)。感謝 @dustinlacewell！

0.1.0

(2014-01-16)

容器會在每次 fig up 時重建，確保設定與 fig.yml 一致 (#2)
新增 fig scale 指令 (#9)
使用 DOCKER_HOST 環境變數尋找 Docker daemon，與官方 Docker 用戶端保持一致（先前為 DOCKER_URL）(#19)
在 fig ps 中截斷長指令 (#18)
填寫指令的 CLI 幫助標語 (#15, #16)
當 fig.yml 遺失時顯示更友好的錯誤 (#4)
修復 fig build 紀錄的錯誤 (#3)
修復若步驟在沒有產生輸出的情況下耗時過長，建置會逾時的錯誤 (#6)
修復透過 Unix socket 串流容器輸出時引發錯誤的問題 (#7)

非常感謝 @tomstuart, @EnTeQuAk, @schickling, @aronasorman 和 @GeoffreyPlitt。

0.0.2

(2014-01-02)

改進說明文件
嘗試連線到 tcp://localdocker:4243 上的 Docker 以及除了 localhost 之外的 UNIX socket。
改進 fig up 行為
為 fig rm 新增確認提示
新增 fig build 指令

0.0.1

(2013-12-20)

初始版本。