企業部署常見問題解答

MSI

關於使用 MSI 安裝程式安裝 Docker Desktop 的常見問題。

如果使用者安裝了舊版 Docker Desktop（即 `.exe` 檔案），使用者資料會怎樣？

使用者必須先解除安裝舊版 .exe 安裝程式，然後才能使用新的 MSI 版本。這將刪除機器上所有 Docker 容器、映象、卷和其他 Docker 相關資料，並移除 Docker Desktop 生成的檔案。

為了在解除安裝前保留現有資料，使用者應備份其容器和卷。

對於 Docker Desktop 4.30 及更高版本，.exe 安裝程式包含一個 -keep-data 標誌，用於移除 Docker Desktop 同時保留底層資源（如容器虛擬機器）。

& 'C:\Program Files\Docker\Docker\Docker Desktop Installer.exe' uninstall -keep-data

如果使用者的機器安裝了舊版 `.exe` 檔案會怎樣？

MSI 安裝程式會檢測舊版 .exe 安裝，並阻止安裝，直到解除安裝舊版本。它會提示使用者先解除安裝當前/舊版本，然後再嘗試安裝 MSI 版本。

我的安裝失敗了，如何找出原因？

MSI 安裝可能會靜默失敗，診斷反饋很少。

要除錯失敗的安裝，請重新執行安裝並啟用詳細日誌記錄。

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log"

安裝失敗後，開啟日誌檔案並搜尋 value 3。這是 Windows 安裝程式失敗時輸出的退出程式碼。在該行上方，您將找到失敗原因。

為什麼每次全新安裝結束時，安裝程式都會提示重啟？

安裝程式提示重啟，因為它假定系統已進行更改，需要重啟才能完成其配置。

例如，如果您選擇 WSL 引擎，安裝程式會新增所需的 Windows 功能。安裝這些功能後，系統會重啟以完成配置，從而使 WSL 引擎正常執行。

透過在從命令列啟動安裝程式時使用 /norestart 選項，您可以取消重啟。

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /norestart

為什麼在使用 Intune 或其他 MDM 解決方案安裝 MSI 時，`docker-users` 組沒有被填充？

MDM 解決方案通常在系統賬戶的上下文中安裝應用程式。這意味著 docker-users 組不會填充使用者的賬戶，因為系統賬戶無權訪問使用者上下文。

例如，您可以透過在提升的命令提示符下使用 psexec 執行安裝程式來重現此問題。

psexec -i -s msiexec /i "DockerDesktop.msi"

安裝應成功完成，但 docker-users 組將不會被填充。

作為一種解決方法，您可以建立一個在使用者賬戶上下文中執行的指令碼。

該指令碼將負責建立 docker-users 組並用正確的使用者填充它。

以下是一個建立 docker-users 組並將當前使用者新增到其中的示例指令碼（要求可能因環境而異）

$Group = "docker-users"
$CurrentUser = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name

# Create the group
New-LocalGroup -Name $Group

# Add the user to the group
Add-LocalGroupMember -Group $Group -Member $CurrentUser

注意
將新使用者新增到 docker-users 組後，使用者必須先登出，然後重新登入，更改才會生效。

MDM

關於使用 Jamf、Intune 或 Workspace ONE 等移動裝置管理 (MDM) 工具部署 Docker Desktop 的常見問題。

為什麼我的 MDM 工具不能一次性應用所有 Docker Desktop 配置設定？

某些 MDM 工具（例如 Workspace ONE）可能不支援在單個 XML 檔案中應用多個配置設定。在這種情況下，您可能需要將每個設定部署到單獨的 XML 檔案中。

有關具體的部署要求或限制，請參閱您的 MDM 提供商文件。