Wie man den docker context update Befehl zur Konfigurationsänderung nutzt

Einführung

In diesem Lab untersuchen wir, wie die Konfiguration bestehender Docker-Kontexte mit dem Befehl docker context update modifiziert werden kann. Wir beginnen mit der Erstellung eines neuen Docker-Kontexts, mit dem wir arbeiten werden.

Nach der Erstellung des Kontexts demonstrieren wir, wie dessen Beschreibung aktualisiert und der Docker-Endpunkt, mit dem er verbunden ist, geändert werden kann. Abschließend überprüfen wir, ob die Kontextkonfiguration erfolgreich aktualisiert wurde. Diese praktische Übung vermittelt Erfahrung im Verwalten und Anpassen von Docker-Kontexten für die Verbindung mit verschiedenen Docker-Daemons.

Skills Graph

Einen neuen Docker-Kontext erstellen

In diesem Schritt lernen wir, wie ein neuer Docker-Kontext erstellt wird. Ein Docker-Kontext ist eine Methode, um Verbindungen zu verschiedenen Docker-Daemons zu verwalten. Standardmäßig verwendet Docker den default-Kontext, der mit dem lokalen Docker-Daemon verbunden ist. Sie können jedoch neue Kontexte erstellen, um sich mit entfernten Docker-Daemons oder anderen Container-Orchestrierungsplattformen zu verbinden.

Um einen neuen Docker-Kontext zu erstellen, verwenden wir den Befehl docker context create. Dieser Befehl benötigt einen Namen für den neuen Kontext und den Endpunkt des Docker-Daemons, mit dem er verbunden werden soll. Für dieses Lab erstellen wir einen Kontext namens my-context, der mit dem lokalen Docker-Daemon verbunden ist.

Öffnen Sie Ihr Terminal und führen Sie folgenden Befehl aus:

docker context create my-context --docker host=unix:///var/run/docker.sock

Dieser Befehl erstellt einen neuen Kontext namens my-context. Die Option --docker host=unix:///var/run/docker.sock gibt an, dass dieser Kontext über den Unix-Socket unter /var/run/docker.sock mit dem Docker-Daemon verbunden werden soll. Dies ist der Standardpfad für den Docker-Socket auf den meisten Linux-Systemen.

Nach Ausführung des Befehls sollten Sie eine ähnliche Ausgabe sehen, die den erfolgreichen Erstellungsprozess bestätigt:

my-context
Successfully created context "my-context"

Nachdem der Kontext erstellt wurde, können wir seine Existenz überprüfen, indem wir die verfügbaren Kontexte auflisten. Verwenden Sie dazu den Befehl docker context ls:

docker context ls

Sie sollten eine Liste der Kontexte sehen, einschließlich des default-Kontexts und des neu erstellten my-context. Die Ausgabe sieht etwa so aus:

NAME                DESCRIPTION                               DOCKER ENDPOINT                               KUBERNETES ENDPOINT   ORCHESTRATOR
default *           Current DOCKER_HOST                         unix:///var/run/docker.sock                                           swarm
my-context                                                    unix:///var/run/docker.sock

Das Sternchen (*) neben default zeigt an, dass dies der aktuell aktive Kontext ist. In einem späteren Schritt lernen wir, wie zwischen Kontexten gewechselt wird.

Beschreibung des Kontexts aktualisieren

In diesem Schritt werden wir die Beschreibung des Docker-Kontexts aktualisieren, den wir im vorherigen Schritt erstellt haben. Das Hinzufügen einer Beschreibung zu einem Kontext kann hilfreich sein, um sich dessen Verwendungszweck zu merken, insbesondere wenn Sie mehrere Kontexte verwenden.

Um einen Docker-Kontext zu aktualisieren, verwenden wir den Befehl docker context update. Dieser Befehl benötigt den Namen des zu aktualisierenden Kontexts sowie die zu ändernden Optionen. Wir werden den Kontext my-context aktualisieren und ihm eine Beschreibung hinzufügen.

Öffnen Sie Ihr Terminal und führen Sie folgenden Befehl aus:

docker context update my-context --description "My local Docker context"

Dieser Befehl aktualisiert den my-context und setzt dessen Beschreibung auf "My local Docker context".

Nach Ausführung des Befehls sollten Sie eine ähnliche Ausgabe sehen, die die Aktualisierung bestätigt:

my-context
Successfully updated context "my-context"

Lassen Sie uns nun überprüfen, ob die Beschreibung aktualisiert wurde. Wir können erneut den Befehl docker context ls verwenden, um die Kontexte mit ihren Beschreibungen aufzulisten:

docker context ls

Sie sollten nun die Beschreibung "My local Docker context" beim my-context sehen. Die Ausgabe sieht wie folgt aus:

NAME                DESCRIPTION                 DOCKER ENDPOINT                               KUBERNETES ENDPOINT   ORCHESTRATOR
default *           Current DOCKER_HOST         unix:///var/run/docker.sock                                           swarm
my-context          My local Docker context     unix:///var/run/docker.sock

Das Hinzufügen von Beschreibungen ist eine gute Praxis zur Organisation Ihrer Docker-Kontexte.

Docker-Endpunkt des Kontexts aktualisieren

In diesem Schritt werden wir den Docker-Endpunkt aktualisieren, der mit unserem my-context verknüpft ist. Während Sie in einem realen Szenario den Endpunkt möglicherweise auf einen entfernten Docker-Daemon umstellen würden, demonstrieren wir in diesem Lab den Prozess, indem wir den Endpunkt in ein leicht abgewandeltes Format ändern, das weiterhin auf den lokalen Daemon verweist. Dies zeigt, wie Sie bei Bedarf die Verbindungsdetails anpassen können.

Um den Docker-Endpunkt zu aktualisieren, verwenden wir erneut den Befehl docker context update, diesmal jedoch mit der Option --docker host und dem neuen Endpunkt. Wir werden den Endpunkt von unix:///var/run/docker.sock zu unix://var/run/docker.sock ändern (wobei der zusätzliche Schrägstrich nach unix: entfernt wird).

Öffnen Sie Ihr Terminal und führen Sie folgenden Befehl aus:

docker context update my-context --docker host=unix://var/run/docker.sock

Dieser Befehl aktualisiert den my-context und ändert dessen Docker-Endpunkt.

Nach Ausführung des Befehls sollten Sie eine ähnliche Ausgabe sehen, die die Aktualisierung bestätigt:

my-context
Successfully updated context "my-context"

Lassen Sie uns nun überprüfen, ob der Docker-Endpunkt aktualisiert wurde. Wir können erneut den Befehl docker context ls verwenden, um die Kontexte mit ihren Endpunkten aufzulisten:

docker context ls

Sie sollten nun den aktualisierten Docker-Endpunkt unix://var/run/docker.sock beim my-context sehen. Die Ausgabe sieht wie folgt aus:

NAME                DESCRIPTION                 DOCKER ENDPOINT             KUBERNETES ENDPOINT   ORCHESTRATOR
default *           Current DOCKER_HOST         unix:///var/run/docker.sock                                           swarm
my-context          My local Docker context     unix://var/run/docker.sock

Die Aktualisierung des Endpunkts ist entscheidend, wenn Sie die Verbindungsart Ihres Docker-Kontexts zum Docker-Daemon ändern müssen, beispielsweise beim Wechsel von einer lokalen zu einer entfernten Verbindung.

Aktualisierte Kontext-Konfiguration überprüfen

In diesem letzten Schritt führen wir eine umfassende Überprüfung des my-context durch, um sicherzustellen, dass sowohl die Beschreibung als auch der Docker-Endpunkt korrekt aktualisiert wurden. Wir verwenden dazu den Befehl docker context inspect, der detaillierte Informationen über einen bestimmten Kontext liefert.

Öffnen Sie Ihr Terminal und führen Sie folgenden Befehl aus:

docker context inspect my-context

Dieser Befehl gibt ein JSON-Dokument mit den Konfigurationsdetails des my-context aus. Wir interessieren uns insbesondere für die Felder Description und Docker.Endpoint in dieser Ausgabe.

Die Ausgabe sollte ähnlich wie folgt aussehen (kann je nach Docker-Version und Umgebung leicht variieren):

[
  {
    "Name": "my-context",
    "Metadata": {
      "Description": "My local Docker context"
    },
    "Endpoints": {
      "docker": {
        "Host": "unix://var/run/docker.sock"
      }
    },
    "TLSMaterial": {},
    "Storage": "my-context"
  }
]

Überprüfen Sie die Ausgabe, um sicherzustellen, dass das Feld Description den Wert "My local Docker context" und das Feld Docker.Endpoint den Wert "unix://var/run/docker.sock" enthält. Dies bestätigt, dass die in den vorherigen Schritten durchgeführten Aktualisierungen erfolgreich waren.

Dieser Schritt schließt unser Lab zum Erstellen und Aktualisieren von Docker-Kontexten ab. Sie haben gelernt, wie man einen neuen Kontext erstellt, eine Beschreibung hinzufügt und dessen Docker-Endpunkt ändert. Das Verständnis von Docker-Kontexten ist essentiell für die Verwaltung von Verbindungen zu verschiedenen Docker-Umgebungen.

Zusammenfassung

In diesem Lab haben wir gelernt, wie man mit dem Befehl docker context create einen neuen Docker-Kontext erstellt, wobei ein Name und der Docker-Endpunkt angegeben werden. Anschließend haben wir die Erstellung des neuen Kontexts überprüft, indem wir alle verfügbaren Kontexte mit docker context ls aufgelistet haben.

Nach der Erstellung haben wir untersucht, wie die Konfiguration eines bestehenden Kontexts mit dem Befehl docker context update modifiziert werden kann. Konkret haben wir die Beschreibung und den Docker-Endpunkt des neu erstellten Kontexts aktualisiert. Abschließend haben wir bestätigt, dass diese Aktualisierungen erfolgreich übernommen wurden, indem wir die Kontexte erneut aufgelistet und die Änderungen in der Ausgabe beobachtet haben.