為擴充功能設定私有市集

可用性：測試版 (Beta)

適用對象：管理員

瞭解如何為您的 Docker Desktop 使用者設定並配置包含精選擴充功能清單的私有市集。

Docker Extensions 的私有市集專為那些未賦予開發人員機器 root 權限的組織所設計。它利用設定管理 (Settings Management)，讓管理員能完全掌控私有市集。

先決條件

下載並安裝 Docker Desktop 4.26.0 或更新版本.
您必須是貴組織的管理員。
您有權透過裝置管理軟體（例如 Jamf）將 extension-marketplace 資料夾和 admin-settings.json 檔案推送至下方指定的位置。

初始化您的市集設定檔

$ /Applications/Docker.app/Contents/Resources/bin/extension-admin init

$ C:\Program Files\Docker\Docker\resources\bin\extension-admin init

$ /opt/docker-desktop/extension-admin init

這會建立 2 個檔案

產生的 admin-settings.json 檔案包含您可以修改的各種設定。

每個設定都有一個您可以設定的 value，其中包括一個 locked 欄位，可讓您鎖定該設定，使開發人員無法更改。

extensionsEnabled 用於啟用 Docker Extensions。
extensionsPrivateMarketplace 用於啟用私有市集，並確保 Docker Desktop 連接到由管理員定義和控制的內容，而不是公開的 Docker 市集。
onlyMarketplaceExtensions 允許或阻止開發人員透過命令列安裝其他擴充功能。正在開發新擴充功能的團隊必須將此設定解除鎖定 ("locked": false)，才能安裝並測試正在開發中的擴充功能。
extensionsPrivateMarketplaceAdminContactURL 定義開發人員請求私有市集中新擴充功能的聯絡連結。如果 value 為空，則 Docker Desktop 不會向您的開發人員顯示任何連結；否則，這可以是 HTTP 連結或 “mailto:” 連結。例如，
"extensionsPrivateMarketplaceAdminContactURL": { "locked": true, "value": "mailto:admin@acme.com" }

若要瞭解有關 admin-settings.json 檔案的更多資訊，請參閱設定管理。

產生的 extensions.txt 檔案定義了您的私有市集中可用的擴充功能清單。

檔案中的每一行都是一個允許的擴充功能，格式為 org/repo:tag。

例如，如果您想允許 Disk Usage 擴充功能，您將在 extensions.txt 檔案中輸入以下內容

docker/disk-usage-extension:0.2.8

如果未提供標籤 (tag)，則會使用該映像檔可用的最新 (latest) 標籤。您也可以使用 # 註解掉行，以便忽略該擴充功能。

此清單可包含不同類型的擴充功能映像檔

重要
您的開發人員只能安裝您所列出的該版本擴充功能。

當 extensions.txt 中的清單準備好後，您就可以產生市集

$ /Applications/Docker.app/Contents/Resources/bin/extension-admin generate

$ C:\Program Files\Docker\Docker\resources\bin\extension-admin generate

$ /opt/docker-desktop/extension-admin generate

這會建立一個 extension-marketplace 目錄，並下載所有允許的擴充功能的市集後設資料。

市集內容是根據擴充功能映像檔資訊作為映像檔標籤來產生的，這是與公開擴充功能相同的格式。它包含擴充功能標題、說明、螢幕截圖、連結等。

建議您先在自己的 Docker Desktop 安裝中嘗試私有市集。