Wie man den Befehl docker plugin rm verwendet, um ein Plugin zu entfernen

Einführung

In diesem Lab lernen Sie, wie Sie ein Docker-Plugin mit dem Befehl docker plugin rm entfernen. Sie beginnen damit, ein Beispiel-Plugin zu installieren, mit dem Sie arbeiten können. Anschließend versuchen Sie, das Plugin zu entfernen, während es noch aktiviert ist, um das Standardverhalten und den auftretenden Fehler zu verstehen.

Nach dem fehlgeschlagenen Versuch lernen Sie, wie Sie das Plugin deaktivieren, was eine notwendige Voraussetzung für die Entfernung ist. Schließlich entfernen Sie das deaktivierte Plugin erfolgreich und erkunden auch die Möglichkeit, die Force-Flag (Zwangsmeldung) für die Entfernung zu verwenden.

Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL docker(("Docker")) -.-> docker/ContainerOperationsGroup(["Container Operations"]) docker(("Docker")) -.-> docker/VolumeOperationsGroup(["Volume 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{{"Wie man den Befehl docker plugin rm verwendet, um ein Plugin zu entfernen"}} docker/rm -.-> lab-555194{{"Wie man den Befehl docker plugin rm verwendet, um ein Plugin zu entfernen"}} docker/volume -.-> lab-555194{{"Wie man den Befehl docker plugin rm verwendet, um ein Plugin zu entfernen"}} end

Installation eines Beispiel-Plugins

In diesem Schritt lernen Sie, wie Sie ein Docker-Plugin installieren. Docker-Plugins erweitern die Funktionalität von Docker und ermöglichen es Ihnen, sich mit externen Systemen für Dinge wie Speicher, Netzwerk und Protokollierung (Logging) zu integrieren.

Wir werden ein einfaches Beispiel-Plugin installieren, um den Prozess zu demonstrieren. Der Befehl zur Installation eines Plugins lautet docker plugin install. Sie müssen während der Installation die Fähigkeiten und Berechtigungen des Plugins akzeptieren.

Zunächst installieren wir das vieux/sshfs-Plugin. Dieses Plugin ermöglicht es Ihnen, SSHFS zum Einhängen von Volumes zu verwenden.

docker plugin install vieux/sshfs

Sie werden aufgefordert, die Fähigkeiten des Plugins zu akzeptieren. Geben Sie y ein und drücken Sie die Eingabetaste, um fortzufahren.

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

Nach der Zustimmung wird das Plugin installiert und aktiviert. Sie können die Installation überprüfen, indem Sie die installierten Plugins auflisten.

docker plugin ls

Sie sollten vieux/sshfs in der Liste sehen, wobei der Status ENABLED auf true gesetzt ist.

Versuch, ein aktiviertes Plugin zu entfernen

Im vorherigen Schritt haben Sie das vieux/sshfs-Plugin installiert und aktiviert. In diesem Schritt versuchen Sie, dieses Plugin zu entfernen, während es noch aktiviert ist. Dies zeigt, dass Sie ein aktiviertes Plugin nicht direkt entfernen können.

Der Befehl zum Entfernen eines Docker-Plugins lautet docker plugin rm. Wir versuchen, das vieux/sshfs-Plugin zu entfernen.

docker plugin rm vieux/sshfs

Sie werden eine Fehlermeldung sehen, die darauf hinweist, dass das Plugin aktiviert ist und nicht entfernt werden kann. Dies ist das erwartete Verhalten, da Docker es verhindert, dass Sie ein Plugin entfernen, das derzeit in Verwendung oder aktiv ist.

Die Ausgabe wird in etwa so aussehen:

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

Dies bestätigt, dass Sie ein Plugin deaktivieren müssen, bevor Sie es entfernen können. Im nächsten Schritt lernen Sie, wie Sie das Plugin deaktivieren.

Deaktivieren des Plugins

Im vorherigen Schritt haben Sie gelernt, dass Sie ein aktiviertes Docker-Plugin nicht entfernen können. Um ein Plugin zu entfernen, müssen Sie es zuerst deaktivieren.

Der Befehl zum Deaktivieren eines Docker-Plugins lautet docker plugin disable. Wir werden nun das vieux/sshfs-Plugin deaktivieren, das Sie im ersten Schritt installiert haben.

docker plugin disable vieux/sshfs

Dieser Befehl stoppt das Plugin und macht es inaktiv. Wenn der Befehl erfolgreich ist, sehen Sie nicht viel Ausgabe.

Um zu bestätigen, dass das Plugin deaktiviert wurde, können Sie erneut die installierten Plugins auflisten.

docker plugin ls

Jetzt sollte die Ausgabe für vieux/sshfs ENABLED als false anzeigen.

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

Warten Sie, die Ausgabe zeigt immer noch true an? Dies liegt daran, dass der Befehl docker plugin ls möglicherweise zwischengespeicherte Informationen anzeigt. Versuchen wir es erneut, die Plugins aufzulisten, um den aktualisierten Status zu sehen.

docker plugin ls

Jetzt sollten Sie den ENABLED-Status für vieux/sshfs als false sehen.

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

Das Plugin ist jetzt deaktiviert und kann entfernt werden.

Entfernen des deaktivierten Plugins

Im vorherigen Schritt haben Sie das vieux/sshfs-Plugin erfolgreich deaktiviert. Da das Plugin jetzt deaktiviert ist, können Sie es mit dem Befehl docker plugin rm entfernen.

docker plugin rm vieux/sshfs

Wenn das Plugin erfolgreich entfernt wurde, sehen Sie den Namen des Plugins in der Ausgabe.

vieux/sshfs

Um zu bestätigen, dass das Plugin entfernt wurde, listen Sie erneut die installierten Plugins auf.

docker plugin ls

Diesmal sollte das vieux/sshfs-Plugin nicht mehr in der Liste erscheinen.

Dies zeigt den Standardprozess zum Entfernen eines Docker-Plugins: zuerst deaktivieren, dann entfernen. Im nächsten Schritt werden Sie untersuchen, was passiert, wenn Sie versuchen, ein Plugin erzwungenermaßen zu entfernen.

Versuch, das Plugin erzwungenermaßen zu entfernen

In den vorherigen Schritten haben Sie gelernt, dass Sie ein Plugin deaktivieren müssen, bevor Sie es entfernen können. Was passiert, wenn Sie versuchen, ein aktiviertes Plugin erzwungenermaßen zu entfernen?

Der Befehl docker plugin rm hat eine Option --force oder -f, mit der versucht werden kann, ein Plugin erzwungenermaßen zu entfernen. Doch selbst mit der Force-Option wird Docker kein aktiviertes Plugin entfernen.

Zuerst installieren wir erneut das vieux/sshfs-Plugin, damit wir ein aktiviertes Plugin haben, mit dem wir arbeiten können.

docker plugin install vieux/sshfs

Denken Sie daran, y einzugeben und Enter zu drücken, wenn Sie aufgefordert werden, die Berechtigungen zu akzeptieren.

Nachdem das Plugin erneut installiert und aktiviert ist, versuchen wir es, es mit der Force-Option zu entfernen.

docker plugin rm --force vieux/sshfs

Sie werden eine ähnliche Fehlermeldung sehen wie beim Versuch, es ohne die Force-Option zu entfernen. Darin wird angegeben, dass das Plugin aktiviert ist und nicht entfernt werden kann.

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

Dies bestätigt, dass die Force-Option die Anforderung, ein Plugin vor der Entfernung zu deaktivieren, nicht außer Kraft setzt. Die Force-Option wird normalerweise in anderen Docker-Kontexten, wie beim Entfernen von Containern, Images oder Volumes, verwendet, um bestimmte Prüfungen zu umgehen. Sie gilt jedoch nicht für das Entfernen von aktivierten Plugins.

Wenn Sie möchten, können Sie das Plugin wie in den vorherigen Schritten gelernt erneut deaktivieren und entfernen, um aufzuräumen.

Zusammenfassung

In diesem Lab haben Sie gelernt, wie Sie ein Docker-Plugin mit docker plugin install installieren und die Installation mit docker plugin ls überprüfen. Anschließend haben Sie versucht, ein aktiviertes Plugin mit docker plugin rm zu entfernen und festgestellt, dass Docker die Entfernung von aktiven Plugins verhindert und diese zuerst deaktiviert werden müssen.