Verwendung des docker config create Befehls zur Konfigurationsverwaltung

Einführung

In diesem Lab lernen Sie, wie Sie Konfigurationen in Docker effektiv mit dem Befehl docker config create verwalten. Wir untersuchen verschiedene Methoden zur Erstellung von Konfigurationen, beginnend mit der direkten Erstellung einer einfachen Konfiguration über die Standardeingabe.

Anschließend erfahren Sie, wie Sie eine Konfiguration aus einer bestehenden Datei erstellen – ein praktischer Ansatz für die Verwaltung umfangreicherer Konfigurationsdaten. Wir behandeln auch das Hinzufügen von Labels zu Ihren Konfigurationen für eine bessere Organisation und Identifizierung. Abschließend lernen Sie, wie Sie die Details der erstellten Konfigurationen überprüfen, um deren Inhalt und Eigenschaften zu verifizieren.

Einfache Konfiguration über STDIN erstellen

In diesem Schritt lernen Sie, wie Sie eine Docker-Konfiguration aus der Standardeingabe (STDIN) erstellen. Docker-Konfigurationen (configs) werden verwendet, um nicht-sensitive Daten wie Konfigurationsdateien zu speichern, auf die Docker-Services zugreifen können.

Zuerst erstellen wir einen einfachen Konfigurationsinhalt. Wir verwenden den echo-Befehl, um einen String auszugeben und leiten ihn an den docker config create-Befehl weiter.

echo "This is my simple config content." | docker config create my_simple_config -

In dem obigen Befehl:

• echo "This is my simple config content." gibt den String aus, der den Inhalt unserer Konfiguration bildet.
• | ist der Pipe-Operator, der die Ausgabe des echo-Befehls als Eingabe an den nächsten Befehl weiterleitet.
• docker config create ist der Befehl zum Erstellen einer neuen Docker-Konfiguration.
• my_simple_config ist der Name, den wir unserer Konfiguration geben.
• - weist docker config create an, den Konfigurationsinhalt von STDIN zu lesen.

Nach Ausführung dieses Befehls erstellt Docker eine Konfiguration namens my_simple_config mit dem angegebenen Inhalt.

Um zu überprüfen, ob die Konfiguration erfolgreich erstellt wurde, können Sie die vorhandenen Docker-Konfigurationen mit dem Befehl docker config ls auflisten.

docker config ls

In der Ausgabe sollte my_simple_config aufgeführt sein.

Konfiguration aus einer Datei erstellen

Im vorherigen Schritt haben Sie gelernt, wie man eine Docker-Konfiguration aus der Standardeingabe erstellt. In diesem Schritt lernen Sie, wie man eine Docker-Konfiguration aus einer Datei erstellt. Dies ist eine gängige Methode, um größere oder komplexere Konfigurationsdaten zu verwalten.

Zuerst erstellen wir eine einfache Konfigurationsdatei. Wir verwenden den nano-Editor, um eine Datei namens my_config_file.txt in Ihrem ~/project-Verzeichnis anzulegen.

nano ~/project/my_config_file.txt

Geben Sie im nano-Editor folgenden Inhalt ein:

This is the content from my config file.
Another line of configuration.

Drücken Sie Strg + X, dann Y und Enter, um die Datei zu speichern und den Editor zu verlassen.

Nun können wir mit dem Befehl docker config create eine Docker-Konfiguration aus dieser Datei erstellen.

docker config create my_file_config ~/project/my_config_file.txt

In diesem Befehl:

• docker config create ist der Befehl zum Erstellen einer neuen Docker-Konfiguration
• my_file_config ist der Name, den wir dieser Konfiguration geben
• ~/project/my_config_file.txt ist der Pfad zur Datei mit dem Konfigurationsinhalt

Docker liest den Inhalt von ~/project/my_config_file.txt und erstellt eine Konfiguration namens my_file_config.

Um zu bestätigen, dass die Konfiguration erfolgreich erstellt wurde, können Sie erneut die Docker-Konfigurationen auflisten.

docker config ls

Sie sollten nun sowohl my_simple_config (aus dem vorherigen Schritt) als auch my_file_config in der Liste sehen.

Konfiguration mit Labels erstellen

In diesem Schritt lernen Sie, wie Sie Ihren Docker-Konfigurationen Labels hinzufügen können. Labels sind Schlüssel-Wert-Paare, die Sie Docker-Objekten (einschließlich Konfigurationen) zuordnen können, um diese besser zu organisieren und zu identifizieren. Dies ist besonders bei umfangreichen Bereitstellungen nützlich.

Wir erstellen eine weitere Konfiguration, diesmal mit Labels während des Erstellungsprozesses. Wir verwenden denselben Inhalt wie in der vorherigen Schritt erstellten Datei, leiten ihn jedoch über cat an docker config create weiter und fügen Labels mit dem --label-Flag hinzu.

cat ~/project/my_config_file.txt | docker config create --label environment=development --label version=1.0 my_labeled_config -

Lassen Sie uns diesen Befehl aufschlüsseln:

• cat ~/project/my_config_file.txt liest den Inhalt der zuvor erstellten Datei
• | leitet den Dateiinhalt an den nächsten Befehl weiter
• docker config create ist der Befehl zum Erstellen einer neuen Docker-Konfiguration
• --label environment=development fügt ein Label mit dem Schlüssel environment und dem Wert development hinzu
• --label version=1.0 fügt ein weiteres Label mit dem Schlüssel version und dem Wert 1.0 hinzu (Sie können mehrere Labels durch mehrfache Verwendung des --label-Flags hinzufügen)
• my_labeled_config ist der Name, den wir dieser Konfiguration geben
• - zeigt an, dass der Konfigurationsinhalt von STDIN gelesen werden soll

Nach Ausführung dieses Befehls wird eine neue Konfiguration namens my_labeled_config mit dem angegebenen Inhalt und Labels erstellt.

Um die mit Ihren Konfigurationen verknüpften Labels anzuzeigen, können Sie den Befehl docker config ls mit dem --format-Flag verwenden:

docker config ls --format "{{.Name}}\t{{.Labels}}"

Dieser Befehl listet die Konfigurationsnamen und ihre zugehörigen Labels auf. Sie sollten die Labels environment und version für my_labeled_config sehen.

Erstellte Konfiguration überprüfen

In diesem letzten Schritt lernen Sie, wie Sie eine Docker-Konfiguration inspizieren können, um deren Details einzusehen - einschließlich ID, Name, Erstellungszeit und Labels. Dies ist nützlich, um die Eigenschaften der Konfiguration zu überprüfen und ihre Einstellungen zu verstehen.

Wir verwenden den Befehl docker config inspect, um die Details der im vorherigen Schritt erstellten Konfiguration my_labeled_config anzuzeigen.

docker config inspect my_labeled_config

Dieser Befehl gibt einen JSON-formatierten String mit detaillierten Informationen zur angegebenen Konfiguration aus. Sie sehen Felder wie ID, Name, CreatedAt, UpdatedAt und Labels. Das Feld Labels zeigt die von uns hinzugefügten Labels environment und version an.

Alternativ können Sie das Flag --pretty verwenden, um eine besser lesbare Ausgabe zu erhalten.

docker config inspect --pretty my_labeled_config

Dadurch werden die Informationen in einem übersichtlicheren Format angezeigt, was die Lesbarkeit verbessert.

Die Überprüfung von Konfigurationen ist ein entscheidender Schritt bei der Verwaltung Ihrer Docker-Konfigurationen, da Sie so deren Einstellungen bestätigen können, bevor Sie sie in Ihren Services verwenden.

Zusammenfassung

In diesem Lab haben Sie gelernt, wie Sie Docker-Konfigurationen mit dem Befehl docker config create erstellen. Sie haben geübt, eine einfache Konfiguration direkt über die Standardeingabe zu erstellen - besonders nützlich für schnelle, kleine Konfigurationen. Außerdem haben Sie gelernt, wie man Konfigurationen aus Dateien erstellt, was sich besser für die Verwaltung größerer oder komplexerer Konfigurationsdaten eignet. Abschließend haben Sie erkundet, wie Sie Ihren Konfigurationen Labels für eine bessere Organisation und Metadatenverwaltung hinzufügen können, sowie wie Sie die Details Ihrer erstellten Konfigurationen mit dem Befehl docker config inspect überprüfen.