Wie man den docker plugin install-Befehl verwendet, um Plugins zu installieren und zu verwalten

Einführung

In diesem Lab erfahren Sie, wie Sie Docker-Plugins mit dem Befehl docker plugin install installieren und verwalten können. Sie werden verschiedene Installationsszenarien untersuchen, darunter die Installation eines Plugins mit Standard-Einstellungen, die Installation eines Plugins und die Konfiguration mit bestimmten Parametern sowie die Installation eines Plugins ohne sofortige Aktivierung.

Durch praktische Beispiele gewinnen Sie praktische Erfahrungen bei der Erweiterung der Docker-Funktionalitäten durch die Integration externer Dienste für Speicher und andere Funktionen. Abschließend erfahren Sie, wie Sie die erfolgreiche Installation Ihrer Plugins überprüfen können.

Skills Graph

Installation eines Plugins mit Standard-Einstellungen

In diesem Schritt erfahren Sie, wie Sie ein Docker-Plugin mit seinen Standard-Einstellungen installieren können. Docker-Plugins erweitern die Funktionalität von Docker und ermöglichen die Integration mit externen Systemen für Speicher, Netzwerke und mehr.

Um ein Plugin zu installieren, verwenden Sie den Befehl docker plugin install, gefolgt vom Namen des Plugins. Docker lädt das Plugin standardmäßig von Docker Hub herunter.

Installieren wir das rexray/s3fs-Plugin, das S3-basierten Speicher für Docker-Volumes bereitstellt.

docker plugin install rexray/s3fs

Wenn Sie diesen Befehl ausführen, lädt Docker das Plugin herunter und fordert Sie auf, die erforderlichen Berechtigungen zu gewähren. Geben Sie y ein und drücken Sie die Eingabetaste, um fortzufahren.

Plugin "rexray/s3fs" is requesting the following permissions:
 - network: [host]
 - mount: [/dev/fuse]
 - allow-vulnerable-api: true
 - allow-host-access: true
 - allow-device: [/dev/fuse]
 - allow-cap: [sys_admin]
Do you grant the plugin "rexray/s3fs" these permissions? [y/N] y

Nach der Bestätigung installiert und aktiviert Docker das Plugin. Sie sollten eine Ausgabe sehen, die darauf hinweist, dass das Plugin installiert und aktiviert wurde.

rexray/s3fs:latest

Diese Ausgabe bestätigt, dass das rexray/s3fs-Plugin erfolgreich installiert und jetzt aktiviert ist und zur Erstellung von S3-basierten Volumes bereit ist.

Installation eines Plugins und Einstellung von Konfigurationsparametern

In diesem Schritt erfahren Sie, wie Sie ein Docker-Plugin installieren und es während der Installation mit bestimmten Parametern konfigurieren können. Einige Plugins erfordern Konfigurationseinstellungen wie API-Schlüssel, Endpunkte oder andere dienstspezifische Details, um korrekt zu funktionieren.

Sie können Konfigurationsparameter an den Befehl docker plugin install übergeben, indem Sie das Format plugin_name parameter_name=parameter_value verwenden.

Installieren wir das vieux/sshfs-Plugin, das es Ihnen ermöglicht, SSHFS für Docker-Volumes zu nutzen. Dieses Plugin erfordert die Angabe des SSH-Benutzers und des Hosts.

docker plugin install vieux/sshfs SSH_USER=labex SSH_HOST=localhost

Ähnlich wie im vorherigen Schritt lädt Docker das Plugin herunter und fordert Sie um die Berechtigungen. Geben Sie y ein und drücken Sie die Eingabetaste, um die Berechtigungen zu gewähren.

Plugin "vieux/sshfs" is requesting the following permissions:
 - network: [host]
 - mount: [/dev/fuse]
 - allow-vulnerable-api: true
 - allow-host-access: true
 - allow-device: [/dev/fuse]
 - allow-cap: [sys_admin]
Do you grant the plugin "vieux/sshfs" these permissions? [y/N] y

Nach der Bestätigung wird das Plugin mit den angegebenen Konfigurationsparametern installiert und aktiviert.

vieux/sshfs:latest

Diese Ausgabe bestätigt, dass das vieux/sshfs-Plugin installiert und aktiviert wurde, wobei SSH_USER auf labex und SSH_HOST auf localhost gesetzt ist. Diese Parameter werden vom Plugin bei der Erstellung von Volumes verwendet.

Installation eines Plugins ohne Aktivierung

In diesem Schritt erfahren Sie, wie Sie ein Docker-Plugin installieren können, ohne es sofort zu aktivieren. Dies kann nützlich sein, wenn Sie ein Plugin installieren möchten, es aber erst aktivieren wollen, wenn Sie es tatsächlich nutzen möchten, oder wenn Sie zusätzliche Konfigurationsschritte durchführen müssen, bevor Sie es aktivieren.

Um ein Plugin zu installieren, ohne es zu aktivieren, verwenden Sie die Option --disable mit dem Befehl docker plugin install.

Installieren wir das containernetworking/cni-Plugin, das CNI-Netzwerkfunktionen bereitstellt, und lassen es vorerst deaktiviert.

docker plugin install --disable containernetworking/cni

Docker lädt das Plugin herunter und fordert Sie um die Berechtigungen. Geben Sie y ein und drücken Sie die Eingabetaste, um die Berechtigungen zu gewähren.

Plugin "containernetworking/cni" is requesting the following permissions:
 - network: [host]
 - mount: [/dev/fuse]
 - allow-vulnerable-api: true
 - allow-host-access: true
 - allow-device: [/dev/fuse]
 - allow-cap: [sys_admin]
Do you grant the plugin "containernetworking/cni" these permissions? [y/N] y

Nach der Bestätigung wird das Plugin installiert, bleibt aber in einem deaktivierten Zustand.

containernetworking/cni:latest

Diese Ausgabe bestätigt, dass das containernetworking/cni-Plugin erfolgreich installiert wurde. Im nächsten Schritt werden wir seinen Status überprüfen.

Überprüfung des installierten Plugins

In diesem Schritt erfahren Sie, wie Sie den Status der installierten Docker-Plugins überprüfen können. Sie können prüfen, welche Plugins installiert sind, welche Versionen sie haben und ob sie aktiviert oder deaktiviert sind.

Um alle installierten Plugins aufzulisten, verwenden Sie den Befehl docker plugin ls.

docker plugin ls

Dieser Befehl zeigt eine Tabelle mit Informationen zu jedem installierten Plugin an, einschließlich seiner ID, des Namens, der Beschreibung, des Aktivierungsstatus und der Version.

Sie sollten die drei Plugins sehen, die wir in den vorherigen Schritten installiert haben: rexray/s3fs, vieux/sshfs und containernetworking/cni.

ID                  NAME                       DESCRIPTION                                            ENABLED             VERSION
a1b2c3d4e5f6        rexray/s3fs:latest         REX-Ray S3FS Plugin                                    true                latest
g7h8i9j0k1l2        vieux/sshfs:latest         The `sshfs` plugin for Docker.                         true                latest
m3n4o5p6q7r8        containernetworking/cni:latest CNI network plugin for Docker                        false               latest

Beachten Sie, dass rexray/s3fs und vieux/sshfs als AKTIVIERT (true) aufgeführt sind, während containernetworking/cni als AKTIVIERT (false) aufgeführt ist, da wir es mit der Option --disable installiert haben.

Sie können auch ein bestimmtes Plugin genauer untersuchen, indem Sie den Befehl docker plugin inspect gefolgt vom Plugin-Namen oder der ID verwenden.

Untersuchen wir das containernetworking/cni-Plugin:

docker plugin inspect containernetworking/cni

Dieser Befehl gibt ein detailliertes JSON-Objekt aus, das alle Konfigurations- und Statusinformationen für das Plugin enthält. Sie können diese Ausgabe untersuchen, um die Einstellungen und den Zustand des Plugins zu bestätigen. Suchen Sie nach der Zeile "Enabled": false in der Ausgabe, um zu bestätigen, dass es deaktiviert ist.

[
  {
    "Id": "m3n4o5p6q7r8",
    "Name": "containernetworking/cni:latest",
    "Enabled": false,
    "Settings": {
      "Args": [],
      "Env": [],
      "Devices": [],
      "Mounts": []
    },
    "PluginReference": "docker.io/containernetworking/cni:latest",
    "Config": {
      "DockerVersion": "20.10.21",
      "Description": "CNI network plugin for Docker",
      "Documentation": "https://github.com/containernetworking/cni",
      "Interface": {
        "Types": ["docker.networkdriver/1.0"],
        "Socket": "cni.sock"
      },
      "Entrypoint": ["/docker-cni-plugin"],
      "PropagatedMount": "/opt/cni",
      "WorkDir": "",
      "User": {},
      "Args": {
        "Name": "",
        "Description": ""
      },
      "Linux": {
        "Capabilities": ["CAP_SYS_ADMIN"],
        "AllowAllDevices": false,
        "Devices": [
          {
            "Name": "fuse",
            "Path": "/dev/fuse"
          }
        ]
      },
      "Rootfs": {
        "Type": "tar",
        "DiffIds": ["sha256:..."]
      }
    }
  }
]

Dieser Schritt beendet den Prozess der Installation und Überprüfung von Docker-Plugins. Sie haben gelernt, wie Sie Plugins mit Standard-Einstellungen, mit bestimmten Konfigurationsparametern installieren können und wie Sie sie installieren können, ohne sie sofort zu aktivieren. Sie wissen auch, wie Sie installierte Plugins auflisten und untersuchen können, um ihren Status zu überprüfen.

Zusammenfassung

In diesem Lab haben Sie gelernt, wie Sie Docker-Plugins mit dem Befehl docker plugin install installieren und verwalten können. Sie haben das Installieren eines Plugins mit Standard-Einstellungen geübt, was einfach darin besteht, den Plugin-Namen anzugeben und die angeforderten Berechtigungen zu bestätigen.

Darüber hinaus haben Sie untersucht, wie Sie ein Plugin installieren können, während Sie während des Installationsprozesses bestimmte Konfigurationsparameter festlegen, was zeigt, wie Sie das Verhalten eines Plugins von Anfang an anpassen können. Schließlich haben Sie gelernt, wie Sie die erfolgreiche Installation eines Plugins überprüfen können.