Extensions hors Marketplace

Installer une extension non disponible dans le Marketplace

Warning

Les extensions Docker qui ne sont pas dans le Marketplace n'ont pas passé le processus de vérification de Docker. Les extensions peuvent installer des binaires, invoquer des commandes et accéder aux fichiers sur votre machine. Leur installation se fait à vos propres risques.

Le Marketplace des Extensions est l'endroit de confiance et officiel pour installer des extensions depuis Docker Desktop. Ces extensions ont passé un processus de vérification par Docker. Cependant, d'autres extensions peuvent également être installées dans Docker Desktop si vous faites confiance à l'auteur de l'extension.

Étant donné la nature d'une extension Docker (c'est-à-dire une image Docker), vous pouvez trouver d'autres endroits où les utilisateurs ont publié le code source de leur extension. Par exemple sur GitHub, GitLab ou même hébergé dans des registres d'images comme DockerHub ou GHCR. Vous pouvez installer une extension qui a été développée par la communauté ou en interne dans votre entreprise par un collègue. Vous n'êtes pas limité à installer des extensions uniquement depuis le Marketplace.

Note

Assurez-vous que l'option Autoriser uniquement les extensions distribuées via le Marketplace Docker est désactivée. Sinon, cela empêche toute extension non listée dans le Marketplace d'être installée via les outils du SDK d'Extension. Vous pouvez modifier cette option dans Paramètres.

Pour installer une extension qui n'est pas présente dans le Marketplace, vous pouvez utiliser la CLI Extensions qui est fournie avec Docker Desktop.

Dans un terminal, tapez docker extension install IMAGE[:TAG] pour installer une extension par sa référence d'image et optionnellement un tag. Utilisez le flag -f ou --force pour éviter la confirmation interactive.

Allez au tableau de bord Docker Desktop pour voir la nouvelle extension installée.

Lister les extensions installées

Peu importe si l'extension a été installée depuis le Marketplace ou manuellement en utilisant la CLI Extensions, vous pouvez utiliser la commande docker extension ls pour afficher la liste des extensions installées. Dans la sortie, vous verrez l'ID de l'extension, le fournisseur, la version, le titre et si elle exécute un conteneur backend ou a déployé des binaires sur l'hôte, par exemple :

$ docker extension ls
ID                  PROVIDER            VERSION             UI                    VM                  HOST
john/my-extension   John                latest              1 tab(My-Extension)   Running(1)          -

Allez au tableau de bord Docker Desktop, sélectionnez Ajouter des Extensions et dans l'onglet Géré pour voir la nouvelle extension installée. Notez qu'un label NON PUBLIÉE s'affiche, indiquant que l'extension n'a pas été installée depuis le Marketplace.

Mettre à jour une extension

Pour mettre à jour une extension qui n'est pas présente dans le Marketplace, dans un terminal tapez docker extension update IMAGE[:TAG] où le TAG doit être différent de l'extension déjà installée.

Par exemple, si vous avez installé une extension avec docker extension install john/my-extension:0.0.1, vous pouvez la mettre à jour en exécutant docker extension update john/my-extension:0.0.2. Allez au tableau de bord Docker Desktop pour voir la nouvelle extension mise à jour.

Note

Les extensions qui ne sont pas installées via le Marketplace ne reçoivent pas de notifications de mise à jour de Docker Desktop.

Désinstaller une extension

Pour désinstaller une extension qui n'est pas présente dans le Marketplace, vous pouvez soit naviguer vers l'onglet Géré dans le Marketplace et sélectionner le bouton Désinstaller, soit depuis un terminal taper docker extension uninstall IMAGE[:TAG].