企業部署常見問題 (FAQ)

MSI

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

如果使用者有舊版的 Docker Desktop 安裝（例如 `.exe`），使用者資料會發生什麼事？

使用者在安裝新的 MSI 版本之前，必須先解除安裝舊的 .exe 安裝。這會刪除本機電腦上的所有 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 Installer 在失敗時輸出的結束代碼。在該行上方，您將找到失敗的原因。

為什麼每次全新安裝後，安裝程式都會提示重新啟動？

安裝程式會提示重新啟動，是因為它假設系統已進行了需要重新啟動才能完成設定的變更。

例如，如果您選擇了 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 提供者說明文件，了解具體的部署需求或限制。