Azure Service Fabric 中 Docker Compose 的部署支援 (預覽)
Docker 使用 docker-compose.yml 檔案定義多容器應用程式。 為了讓客戶能夠輕鬆地熟悉 Docker 以協調 Azure Service Fabric 上的現有容器應用程式，因此我們在平台中原生提供 Docker Compose 部署的預覽支援。 Service Fabric 可接受版本 3 以上的 docker-compose.yml 檔案。
此支援目前只能預覽，因此僅支援 Compose 指示詞子集。
若要使用此預覽，請透過 Azure 入口網站和對應的 SDK，以 Service Fabric 執行階段 5.7 版或更新版本建立您的叢集。
注意
此功能目前只能預覽，尚未在生產環境中受到支援。 下列範例是以執行階段 6.0 版及 SDK 2.8 版為基礎。
在 Service Fabric 上部署 Docker Compose 檔案
下列命令會建立一個 Service Fabric 應用程式 (名為 fabric:/TestContainerApp)，而監視及管理此應用程式的方式與任何其他 Service Fabric 應用程式一樣。 可使用指定的應用程式名稱查詢健康情況。
Service Fabric 會將 "DeploymentName" 視為 Compose 部署的識別碼。
使用 PowerShell
透過在 PowerShell 中執行下列命令，從 docker-compose.yml 檔案建立 Service Fabric Compose 部署：
New-ServiceFabricComposeDeployment -DeploymentName TestContainerApp -Compose docker-compose.yml [-RegistryUserName <>] [-RegistryPassword <>] [-PasswordEncrypted]
RegistryUserName 和 RegistryPassword 是指容器登錄使用者名稱與密碼。 您完成部署之後，可以使用下列命令檢查其狀態：
Get-ServiceFabricComposeDeploymentStatus -DeploymentName TestContainerApp
若要透過 PowerShell 刪除 Compose 部署，請使用下列命令：
Remove-ServiceFabricComposeDeployment -DeploymentName TestContainerApp
若要透過 PowerShell 啟動 Compose 部署升級，請使用下列命令：
Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName TestContainerApp -Compose docker-compose-v2.yml -Monitored -FailureAction Rollback
若要透過 PowerShell 復原 Compose 部署升級，請使用下列命令：
Start-ServiceFabricComposeDeploymentRollback -DeploymentName TestContainerApp
接受升級之後，可以使用下列命令追蹤升級進度：
Get-ServiceFabricComposeDeploymentUpgrade -DeploymentName TestContainerApp
使用 Azure Service Fabric CLI (sfctl)
或者，您也可以使用下列 Service Fabric CLI 命令：
sfctl compose create --deployment-name TestContainerApp --file-path docker-compose.yml [ [ --user --encrypted-pass ] | [ --user --has-pass ] ] [ --timeout ]
建立部署之後，可以使用下列命令檢查其狀態：
sfctl compose status --deployment-name TestContainerApp [ --timeout ]
若要刪除 Compose 部署，請使用下列命令：
sfctl compose remove --deployment-name TestContainerApp [ --timeout ]
若要啟動 Compose 部署升級，請使用下列命令：
sfctl compose upgrade --deployment-name TestContainerApp --file-path docker-compose-v2.yml [ [ --user --encrypted-pass ] | [ --user --has-pass ] ] [--upgrade-mode Monitored] [--failure-action Rollback] [ --timeout ]
若要復原 Compose 部署升級，請使用下列命令：
sfctl compose upgrade-rollback --deployment-name TestContainerApp [ --timeout ]
接受升級之後，可以使用下列命令追蹤升級進度：
sfctl compose upgrade-status --deployment-name TestContainerApp
支援的撰寫指示詞
此預覽支援 Compose 第 3 版格式的組態選項子集，包括下列基本項目：
- 服務 >部署> 複本
- 服務 > 部署 > 放置 > 條件約束
- 服務 > 部署 > 資源 > 限制
- -cpu-shares
- -memory
- -memory-swap
- 服務 > 命令
- 服務 > 環境
- 服務 > 連接埠
- 服務 > 映像
- 服務 > 隔離 (僅適用於 Windows)
- 服務 > 記錄 > 驅動程式
- 服務 > 記錄 > 驅動程式 > 選項
- 磁碟區與部署 > 磁碟區
設定叢集，以便強制執行資源限制，如 Service Fabric 資源管理 (英文) 中所述。 此預覽不支援所有其他的 Docker Compose 指示詞。
Ports 區段
在 Service Fabric 服務接聽程式將使用的 Ports 區段中指定 http 或 https 通訊協定。 這可確保使用命名服務正確發佈端點通訊協定，以允許反向 Proxy 轉送要求：
- 若要路由傳送至不安全的 Service Fabric Compose 服務，請指定 /http。 例如，- "80:80/http"。
- 若要路由傳送至安全的 Service Fabric Compose 服務，請指定 /https。 例如，- "443:443/https"。
注意
/Http 和 /https Ports 區段語法為 Service Fabric 特有，用以註冊正確的 Service Fabric 接聽程式 URL。 如果 Docker compose 檔案語法已經過程式驗證，則可能會導致驗證錯誤。
ServiceDnsName 計算
如果在 Compose 檔案中指定的服務名稱是完整的網域名稱 (亦即包含點 [.])，則由 Service Fabric 註冊的 DNS 名稱為 <ServiceName> (包含點)。 如果不是，則應用程式名稱中的每個路徑線段會變成服務 DNS 名稱中的網域標籤，其中的第一個路徑線段會變成最上層的網域標籤。
例如，如果指定的應用程式名稱是 fabric:/SampleApp/MyComposeApp，則 <ServiceName>.MyComposeApp.SampleApp 會是註冊的 DNS 名稱。
Compose 部署 (執行個體定義) 與 Service Fabric 應用程式模型 (類型定義) 的比較
docker-compose.yml 檔案描述一組可部署的容器，包括其屬性與組態。 例如，此檔案可包含環境變數與連接埠。 您也可以在 docker-compose.yml 檔案中指定放置條件約束、資源限制及 DNS 名稱等部署參數。
Service Fabric 應用程式模型使用服務類型與應用程式類型，其中您可以有許多相同類型的應用程式執行個體。 例如，可以讓每個客戶有一個應用程式執行個體。 這個以類型為基礎的模型支援同一個向執行階段註冊之應用程式的多個版本。
例如，客戶 A 可以有一個以類型 1.0 的 AppTypeA 具現化的應用程式，客戶 B 可以有另一個以相同類型與版本具現化的應用程式。 您在應用程式資訊清單中定義應用程式類型，並且在建立應用程式時指定應用程式名稱與部署參數。
雖然此模型提供彈性，但我們也正在規劃支援更簡單、以執行個體為基礎的部署類型，其中類型在資訊清單檔案中是隱含的。 在此模型中，每個應用程式會取得自己的獨立資訊清單。 我們正在透過新增對 docker-compose.yml (這是以執行個體為基礎的部署格式) 的支援來預覽此成果。