FAQ du déploiement d'entreprise

MSI

Questions courantes concernant l'installation de Docker Desktop en utilisant l'installateur MSI.

Que se passe-t-il avec les données utilisateur s'ils ont une installation Docker Desktop plus ancienne (c'est-à-dire .exe) ?

Les utilisateurs doivent désinstaller les anciennes installations .exe avant d'utiliser la nouvelle version MSI. Cela supprime tous les conteneurs Docker, images, volumes et autres données liées à Docker locales à la machine, et supprime les fichiers générés par Docker Desktop.

Pour préserver les données existantes avant la désinstallation, les utilisateurs doivent sauvegarder leurs conteneurs et volumes.

Pour Docker Desktop 4.30 et ultérieur, l'installateur .exe inclut un flag -keep-data qui supprime Docker Desktop tout en préservant les ressources sous-jacentes telles que les VMs de conteneur :

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

Que se passe-t-il si la machine de l'utilisateur a une installation .exe plus ancienne ?

L'installateur MSI détecte les anciennes installations .exe et bloque l'installation jusqu'à ce que la version précédente soit désinstallée. Il invite l'utilisateur à désinstaller sa version actuelle/ancienne d'abord, avant d'essayer de réinstaller la version MSI.

Mon installation a échoué, comment puis-je découvrir ce qui s'est passé ?

Les installations MSI peuvent échouer silencieusement, offrant peu de retour de diagnostic.

Pour déboguer une installation qui a échoué, exécutez l'installation à nouveau avec la journalisation détaillée activée :

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

Après que l'installation ait échoué, ouvrez le fichier de log et recherchez les occurrences de value 3. C'est le code de sortie que Windows Installer produit quand il a échoué. Juste au-dessus de la ligne, vous trouverez la raison de l'échec.

Pourquoi l'installateur demande-t-il un redémarrage à la fin de chaque nouvelle installation ?

L'installateur demande un redémarrage car il suppose que des changements ont été apportés au système qui nécessitent un redémarrage pour terminer leur configuration.

Par exemple, si vous sélectionnez le moteur WSL, l'installateur ajoute les fonctionnalités Windows requises. Après que ces fonctionnalités soient installées, le système redémarre pour terminer les configurations afin que le moteur WSL soit fonctionnel.

Vous pouvez supprimer les redémarrages en utilisant l'option /norestart lors du lancement de l'installateur depuis la ligne de commande :

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

Pourquoi le groupe docker-users n'est-il pas rempli lorsque le MSI est installé avec Intune ou une autre solution MDM ?

Il est courant que les solutions MDM installent les applications dans le contexte du compte système. Cela signifie que le groupe docker-users n'est pas rempli avec le compte de l'utilisateur, car le compte système n'a pas accès au contexte de l'utilisateur.

À titre d'exemple, vous pouvez reproduire cela en exécutant l'installateur avec psexec dans une invite de commande élevée :

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

L'installation devrait se terminer avec succès, mais le groupe docker-users ne sera pas rempli.

Comme solution de contournement, vous pouvez créer un script qui s'exécute dans le contexte du compte utilisateur.

Le script serait responsable de créer le groupe docker-users et de le remplir avec l'utilisateur correct.

Voici un exemple de script qui crée le groupe docker-users et y ajoute l'utilisateur actuel (les exigences peuvent varier selon l'environnement) :

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

# Créer le groupe
New-LocalGroup -Name $Group

# Ajouter l'utilisateur au groupe
Add-LocalGroupMember -Group $Group -Member $CurrentUser

Note

Après avoir ajouté un nouvel utilisateur au groupe docker-users, l'utilisateur doit se déconnecter puis se reconnecter pour que les changements prennent effet.

MDM

Questions courantes concernant le déploiement de Docker Desktop en utilisant des outils de gestion des appareils mobiles (MDM) tels que Jamf, Intune, ou Workspace ONE.

Pourquoi mon outil MDM n'applique-t-il pas tous les paramètres de configuration Docker Desktop en une seule fois ?

Certains outils MDM, tels que Workspace ONE, peuvent ne pas prendre en charge l'application de plusieurs paramètres de configuration dans un seul fichier XML. Dans ces cas, vous pourriez avoir besoin de déployer chaque paramètre dans un fichier XML séparé.

Référez-vous à la documentation de votre fournisseur MDM pour les exigences de déploiement spécifiques ou les limitations.