Comment utiliser la commande docker plugin rm pour supprimer un plugin

Introduction

Dans ce laboratoire, vous apprendrez à supprimer un plugin Docker en utilisant la commande docker plugin rm. Vous commencerez par installer un plugin d'exemple pour travailler avec. Ensuite, vous tenterez de supprimer le plugin alors qu'il est toujours activé pour comprendre le comportement par défaut et l'erreur rencontrée.

Après la tentative infructueuse, vous apprendrez à désactiver le plugin, qui est une condition préalable nécessaire pour la suppression. Enfin, vous supprimerez avec succès le plugin désactivé et explorerez également l'option d'utiliser le drapeau de force pour la suppression.

Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL docker(("Docker")) -.-> docker/VolumeOperationsGroup(["Volume Operations"]) docker(("Docker")) -.-> docker/ContainerOperationsGroup(["Container Operations"]) docker/ContainerOperationsGroup -.-> docker/ls("List Containers") docker/ContainerOperationsGroup -.-> docker/rm("Remove Container") docker/VolumeOperationsGroup -.-> docker/volume("Manage Volumes") subgraph Lab Skills docker/ls -.-> lab-555194{{"Comment utiliser la commande docker plugin rm pour supprimer un plugin"}} docker/rm -.-> lab-555194{{"Comment utiliser la commande docker plugin rm pour supprimer un plugin"}} docker/volume -.-> lab-555194{{"Comment utiliser la commande docker plugin rm pour supprimer un plugin"}} end

Installer un plugin d'exemple

Dans cette étape, vous apprendrez à installer un plugin Docker. Les plugins Docker étendent les fonctionnalités de Docker, vous permettant d'intégrer des systèmes externes pour des choses telles que le stockage, le réseau et la journalisation.

Nous allons installer un simple plugin d'exemple pour démontrer le processus. La commande pour installer un plugin est docker plugin install. Vous devrez accepter les capacités et les autorisations du plugin pendant l'installation.

Tout d'abord, installons le plugin vieux/sshfs. Ce plugin vous permet d'utiliser SSHFS pour monter des volumes.

docker plugin install vieux/sshfs

Vous serez invité à accepter les capacités du plugin. Tapez y et appuyez sur Entrée pour continuer.

Plugin "vieux/sshfs" is requesting the following capabilities:
  - Network: host
  - Mounts: [/dev/fuse]
  - Args: [--sshkey-path]
Do you grant the plugin these permissions? [y/N] y

Après avoir accepté, le plugin sera installé et activé. Vous pouvez vérifier l'installation en listant les plugins installés.

docker plugin ls

Vous devriez voir vieux/sshfs répertorié avec le statut ENABLED défini sur true.

Tenter de supprimer un plugin activé

Dans l'étape précédente, vous avez installé et activé le plugin vieux/sshfs. Dans cette étape, vous allez tenter de supprimer ce plugin alors qu'il est toujours activé. Cela démontrera que vous ne pouvez pas supprimer directement un plugin activé.

La commande pour supprimer un plugin Docker est docker plugin rm. Nous allons essayer de supprimer le plugin vieux/sshfs.

docker plugin rm vieux/sshfs

Vous verrez un message d'erreur indiquant que le plugin est activé et ne peut pas être supprimé. C'est un comportement attendu, car Docker vous empêche de supprimer un plugin qui est actuellement utilisé ou actif.

La sortie sera similaire à ceci :

Error response from daemon: plugin vieux/sshfs is enabled. Disable it before removing

Cela confirme que vous devez désactiver un plugin avant de pouvoir le supprimer. Dans l'étape suivante, vous apprendrez à désactiver le plugin.

Désactiver le plugin

Dans l'étape précédente, vous avez appris que vous ne pouvez pas supprimer un plugin Docker activé. Pour supprimer un plugin, vous devez d'abord le désactiver.

La commande pour désactiver un plugin Docker est docker plugin disable. Nous allons maintenant désactiver le plugin vieux/sshfs que vous avez installé dans la première étape.

docker plugin disable vieux/sshfs

Cette commande arrêtera le plugin et le rendra inactif. Vous ne verrez pas beaucoup de sortie si la commande réussit.

Pour confirmer que le plugin a été désactivé, vous pouvez lister à nouveau les plugins installés.

docker plugin ls

Maintenant, la sortie pour vieux/sshfs devrait indiquer ENABLED comme false.

ID                  NAME                DESCRIPTION         ENABLED
f51132325c3b        vieux/sshfs         Create SSHFS mounts true

Attendez, la sortie montre toujours true ? C'est parce que la commande docker plugin ls peut afficher des informations mises en cache. Essayons de lister les plugins à nouveau pour voir le statut mis à jour.

docker plugin ls

Maintenant, vous devriez voir le statut ENABLED pour vieux/sshfs comme false.

ID                  NAME                DESCRIPTION         ENABLED
f51132325c3b        vieux/sshfs         Create SSHFS mounts false

Le plugin est maintenant désactivé et prêt à être supprimé.

Supprimer le plugin désactivé

Dans l'étape précédente, vous avez réussi à désactiver le plugin vieux/sshfs. Maintenant que le plugin est désactivé, vous pouvez le supprimer en utilisant la commande docker plugin rm.

docker plugin rm vieux/sshfs

Si le plugin a été supprimé avec succès, vous verrez le nom du plugin affiché dans la sortie.

vieux/sshfs

Pour confirmer que le plugin a été supprimé, listez à nouveau les plugins installés.

docker plugin ls

Cette fois, le plugin vieux/sshfs ne devrait plus apparaître dans la liste.

Cela démontre le processus standard pour supprimer un plugin Docker : d'abord le désactiver, puis le supprimer. Dans l'étape suivante, vous allez explorer ce qui se passe si vous essayez de forcer la suppression d'un plugin.

Tenter de supprimer le plugin en utilisant la force

Dans les étapes précédentes, vous avez appris que vous devez désactiver un plugin avant de le supprimer. Que se passe-t-il si vous essayez de forcer la suppression d'un plugin activé ?

La commande docker plugin rm dispose d'un indicateur --force ou -f qui peut être utilisé pour tenter de forcer la suppression d'un plugin. Cependant, même avec l'indicateur de force, Docker ne supprimera pas un plugin activé.

Commençons par réinstaller le plugin vieux/sshfs afin d'avoir un plugin activé avec lequel travailler.

docker plugin install vieux/sshfs

N'oubliez pas de taper y et d'appuyer sur Entrée lorsque vous êtes invité à accepter les capacités.

Maintenant que le plugin est réinstallé et activé, essayons de le supprimer en utilisant l'indicateur de force.

docker plugin rm --force vieux/sshfs

Vous verrez un message d'erreur similaire à celui que vous avez obtenu lorsque vous avez essayé de le supprimer sans l'indicateur de force, indiquant que le plugin est activé et ne peut pas être supprimé.

Error response from daemon: plugin vieux/sshfs is enabled. Disable it before removing

Cela confirme que l'indicateur de force ne contourne pas la nécessité de désactiver un plugin avant de le supprimer. L'indicateur de force est généralement utilisé dans d'autres contextes Docker, comme la suppression de conteneurs, d'images ou de volumes, pour contourner certains contrôles, mais il ne s'applique pas à la suppression de plugins activés.

Pour nettoyer, vous pouvez désactiver et supprimer le plugin à nouveau si vous le souhaitez, en suivant les étapes que vous avez apprises précédemment.

Résumé

Dans ce laboratoire (lab), vous avez appris à installer un plugin Docker en utilisant la commande docker plugin install et à vérifier son installation avec docker plugin ls. Vous avez ensuite tenté de supprimer un plugin activé en utilisant docker plugin rm et découvert que Docker empêche la suppression de plugins actifs, exigeant qu'ils soient d'abord désactivés.