Installateur MSI
Le paquet MSI prend en charge diverses solutions MDM (Mobile Device Management), ce qui le rend idéal pour les installations en masse et élimine le besoin de configurations manuelles par les utilisateurs individuels. Avec ce paquet, les administrateurs IT peuvent assurer des installations standardisées et pilotées par des politiques de Docker Desktop, améliorant l'efficacité et la gestion logicielle dans leurs organisations.
Installer de manière interactive
-
Dans la Console d'Administration Docker, naviguez vers votre organisation.
-
Sous Docker Desktop, sélectionnez la page Deploy.
-
Depuis l'onglet Windows OS, sélectionnez le bouton Download MSI installer.
-
Une fois téléchargé, double-cliquez sur
Docker Desktop Installer.msi
pour lancer l'installateur. -
Après avoir accepté l'accord de licence, choisissez l'emplacement d'installation. Par défaut, Docker Desktop est installé dans
C:\Program Files\Docker\Docker
. -
Configurez l'installation de Docker Desktop. Vous pouvez :
-
Créer un raccourci sur le bureau
-
Définir le type de démarrage du service Docker Desktop sur automatique
-
Désactiver l'utilisation des conteneurs Windows
-
Sélectionner le backend Docker Desktop : WSL ou Hyper-V. Si un seul est pris en charge par votre système, vous ne pourrez pas choisir.
-
-
Suivez les instructions de l'assistant d'installation pour autoriser l'installateur et procéder à l'installation.
-
Lorsque l'installation est réussie, sélectionnez Finish pour terminer le processus d'installation.
Si votre compte administrateur est différent de votre compte utilisateur, vous devez ajouter l'utilisateur au groupe docker-users :
- Exécutez Gestion de l'ordinateur en tant qu'administrateur.
- Naviguez vers Utilisateurs et groupes locaux > Groupes > docker-users.
- Cliquez avec le bouton droit pour ajouter l'utilisateur au groupe.
- Déconnectez-vous et reconnectez-vous pour que les changements prennent effet.
NoteLors de l'installation de Docker Desktop avec le MSI, les mises à jour intégrées sont automatiquement désactivées. Cela garantit que les organisations peuvent maintenir la cohérence des versions et empêcher les mises à jour non approuvées. Pour Docker Desktop installé avec l'installateur .exe, les mises à jour intégrées restent prises en charge.
Docker Desktop vous notifie lorsqu'une mise à jour est disponible. Pour mettre à jour Docker Desktop, téléchargez le dernier installateur depuis la Console d'Administration Docker. Naviguez vers la page Deploy > sous Docker Desktop.
Pour rester à jour avec les nouvelles versions, consultez la page notes de version.
Installer depuis la ligne de commande
Cette section couvre les installations en ligne de commande de Docker Desktop en utilisant PowerShell. Elle fournit des commandes d'installation communes que vous pouvez exécuter. Vous pouvez également ajouter des arguments supplémentaires qui sont décrits dans les options de configuration.
Lors de l'installation de Docker Desktop, vous pouvez choisir entre des installations interactives ou non-interactives.
Les installations interactives, sans spécifier /quiet
ou /qn
, affichent l'interface utilisateur et vous permettent de sélectionner vos propres propriétés.
Lors de l'installation via l'interface utilisateur, il est possible de :
- Choisir le dossier de destination
- Créer un raccourci sur le bureau
- Configurer le type de démarrage du service Docker Desktop
- Désactiver les conteneurs Windows
- Choisir entre le moteur WSL ou Hyper-V
Les installations non-interactives sont silencieuses et toute configuration supplémentaire doit être passée comme arguments.
Commandes d'installation communes
ImportantLes droits d'administrateur sont requis pour exécuter l'une des commandes suivantes.
Installer de manière interactive avec journalisation détaillée
msiexec /i "DockerDesktop.msi" /L*V ".\msi.log"
Installer de manière interactive sans journalisation détaillée
msiexec /i "DockerDesktop.msi"
Installer de manière non-interactive avec journalisation détaillée
msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet
Installer de manière non-interactive en supprimant les redémarrages
msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart
Installer de manière non-interactive avec paramètres d'administration
msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart ADMINSETTINGS="{"configurationFileVersion":2,"enhancedContainerIsolation":{"value":true,"locked":false}}" ALLOWEDORG="docker"
Installer de manière interactive et permettre aux utilisateurs de basculer vers les conteneurs Windows sans droits d'administrateur
msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart ALLOWEDORG="docker" ALWAYSRUNSERVICE=1
Installer avec l'option d'affichage passif
Vous pouvez utiliser l'option d'affichage /passive
au lieu de /quiet
lorsque vous voulez effectuer une installation non-interactive mais afficher une boîte de dialogue de progression.
En mode passif, l'installateur n'affiche aucune invite ou message d'erreur à l'utilisateur et l'installation ne peut pas être annulée.
Par exemple :
msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /passive /norestart
TipLors de la création d'une valeur qui attend une chaîne JSON :
- La propriété attend une chaîne formatée JSON
- La chaîne doit être entourée de guillemets doubles
- La chaîne ne doit contenir aucun espace
- Les noms de propriétés sont attendus entre guillemets doubles
Commandes de désinstallation communes
Lors de la désinstallation de Docker Desktop, vous devez utiliser le même fichier .msi
qui a été utilisé à l'origine pour installer l'application.
Si vous n'avez plus le fichier .msi
original, vous devez utiliser le code produit associé à l'installation. Pour trouver le code produit, exécutez :
Get-WmiObject Win32_Product | Select-Object IdentifyingNumber, Name | Where-Object {$_.Name -eq "Docker Desktop"}
Il devrait retourner une sortie similaire à ce qui suit :
IdentifyingNumber Name
----------------- ----
{10FC87E2-9145-4D7D-B493-2E99E8D8E103} Docker Desktop
NoteCette commande peut prendre du temps, selon le nombre d'applications installées.
IdentifyingNumber
est le code produit de l'application et peut être utilisé pour désinstaller Docker Desktop. Par exemple :
msiexec /x {10FC87E2-9145-4D7D-B493-2E99E8D8E103} /L*V ".\msi.log" /quiet
Désinstaller de manière interactive avec journalisation détaillée
msiexec /x "DockerDesktop.msi" /L*V ".\msi.log"
Désinstaller de manière interactive sans journalisation détaillée
msiexec /x "DockerDesktop.msi"
Désinstaller de manière non-interactive avec journalisation détaillée
msiexec /x "DockerDesktop.msi" /L*V ".\msi.log" /quiet
Désinstaller de manière non-interactive sans journalisation détaillée
msiexec /x "DockerDesktop.msi" /quiet
Options de configuration
ImportantEn plus des propriétés personnalisées suivantes, l'installateur MSI Docker Desktop prend également en charge les options de ligne de commande standard de Windows Installer.
Propriété | Description | Défaut |
---|---|---|
ENABLEDESKTOPSHORTCUT |
Crée un raccourci sur le bureau. | 1 |
INSTALLFOLDER |
Spécifie un emplacement personnalisé où Docker Desktop sera installé. | C:\Program Files\Docker |
ADMINSETTINGS |
Crée automatiquement un fichier admin-settings.json qui est utilisé pour
contrôler certains paramètres Docker Desktop sur les machines clientes au sein des organisations. Il doit être utilisé avec la propriété ALLOWEDORG . |
Aucun |
ALLOWEDORG |
Exige que l'utilisateur se connecte et fasse partie de l'organisation Docker Hub spécifiée lors de l'exécution de l'application. Cela crée une clé de registre appelée allowedOrgs dans HKLM\Software\Policies\Docker\Docker Desktop . |
Aucun |
ALWAYSRUNSERVICE |
Permet aux utilisateurs de basculer vers les conteneurs Windows sans avoir besoin de droits d'administrateur | 0 |
DISABLEWINDOWSCONTAINERS |
Désactive l'intégration des conteneurs Windows | 0 |
ENGINE |
Définit le moteur Docker utilisé pour exécuter les conteneurs. Cela peut être soit wsl , hyperv , ou windows |
wsl |
PROXYENABLEKERBEROSNTLM |
Lorsque défini à 1, active le support pour l'authentification proxy Kerberos et NTLM. Disponible avec Docker Desktop 4.33 et ultérieur | 0 |
PROXYHTTPMODE |
Définit le mode Proxy HTTP. Cela peut être soit system ou manual |
system |
OVERRIDEPROXYHTTP |
Définit l'URL du proxy HTTP qui doit être utilisé pour les requêtes HTTP sortantes. | Aucun |
OVERRIDEPROXYHTTPS |
Sets the URL of the HTTP proxy that must be used for outgoing HTTPS requests. | None |
OVERRIDEPROXYEXCLUDE |
Bypasses proxy settings for the hosts and domains. Uses a comma-separated list. | None |
HYPERVDEFAULTDATAROOT |
Specifies the default location for the Hyper-V VM disk. | None |
WINDOWSCONTAINERSDEFAULTDATAROOT |
Specifies the default location for Windows containers. | None |
WSLDEFAULTDATAROOT |
Specifies the default location for the WSL distribution disk. | None |
DISABLEANALYTICS |
When set to 1, analytics collection will be disabled for the MSI. For more information, see Analytics. | 0 |
Additionally, you can also use /norestart
or /forcerestart
to control reboot behaviour.
By default, the installer reboots the machine after a successful installation. When run silently, the reboot is automatic and the user is not prompted.
Analytics
The MSI installer collects anonymous usage statistics relating to installation only. This is to better understand user behaviour and to improve the user experience by identifying and addressing issues or optimizing popular features.
How to opt-out
When you install Docker Desktop from the default installer GUI, select the Disable analytics checkbox located on the bottom-left corner of the Welcome dialog.
When you install Docker Desktop from the command line, use the DISABLEANALYTICS
property.
msiexec /i "win\msi\bin\en-US\DockerDesktop.msi" /L*V ".\msi.log" DISABLEANALYTICS=1
Persistence
If you decide to disable analytics for an installation, your choice is persisted in the registry and honoured across future upgrades and uninstalls.
However, the key is removed when Docker Desktop is uninstalled and must be configured again via one of the previous methods.
The registry key is as follows:
SOFTWARE\Docker Inc.\Docker Desktop\DisableMsiAnalytics
When analytics is disabled, this key is set to 1
.