Verwendung des docker config inspect Befehls zur Anzeige von Config-Details

Einführung

In diesem Lab lernen Sie, wie Sie den Befehl docker config inspect verwenden, um detaillierte Informationen über Docker Configs (Konfigurationen) anzuzeigen. Wir beginnen mit der Erstellung einer Docker Config aus einer Datei, einem grundlegenden Schritt zur Verwaltung nicht-sensitiver Konfigurationsdaten innerhalb eines Docker Swarms.

Nach der Erstellung untersuchen Sie, wie die erstellte Config sowohl über ihren Namen als auch ihre eindeutige ID inspiziert werden kann, wobei verschiedene Methoden zum Zugriff auf Config-Details demonstriert werden. Abschließend lernen Sie, wie Sie die Ausgabe des Befehls docker config inspect mit dem Flag --format anpassen können, um die angezeigten Informationen zu individualisieren.

Skills Graph

Docker Config erstellen

In diesem Schritt lernen Sie, wie Sie eine Docker Config erstellen. Docker Configs werden verwendet, um nicht-sensitive Informationen wie Konfigurationsdateien zu speichern, die von Services in einem Swarm genutzt werden können.

Zuerst erstellen wir eine einfache Konfigurationsdatei. Wir legen eine Datei namens my_config.txt im Verzeichnis ~/project mit beispielhaftem Inhalt an.

echo "This is my sample configuration." > ~/project/my_config.txt

Nun können wir mit dem Befehl docker config create eine Docker Config aus dieser Datei erstellen. Die grundlegende Syntax lautet docker config create <config_name> <file_path>.

docker config create my_config ~/project/my_config.txt

Sie sollten die ID der neu erstellten Config in der Konsole ausgegeben sehen. Dies bestätigt, dass die Config erfolgreich erstellt wurde.

Um zu überprüfen, ob die Config erstellt wurde, können Sie alle Docker Configs mit dem Befehl docker config ls auflisten.

docker config ls

In der Ausgabe sollten Sie my_config zusammen mit der zugehörigen ID und dem Erstellungszeitpunkt sehen.

Config anhand des Namens inspizieren

In diesem Schritt lernen Sie, wie Sie eine Docker Config anhand ihres Namens untersuchen können. Der Befehl docker config inspect ermöglicht es Ihnen, detaillierte Informationen über eine bestimmte Config einzusehen.

Um die im vorherigen Schritt erstellte Config my_config zu inspizieren, verwenden Sie den Befehl docker config inspect gefolgt vom Config-Namen.

docker config inspect my_config

Dieser Befehl gibt ein JSON-Objekt aus, das verschiedene Details über die Config my_config enthält, wie z.B. die ID, Erstellungszeitpunkt und den Inhalt der Konfigurationsdaten.

Die Ausgabe bietet eine umfassende Übersicht über die Eigenschaften der Config. Sie können die Felder ID, CreatedAt, UpdatedAt, Spec und Version einsehen. Das Spec-Feld enthält die eigentlichen Konfigurationsdaten, die base64-kodiert sind.

Config anhand der ID inspizieren

In diesem Schritt lernen Sie, wie Sie eine Docker Config anhand ihrer ID untersuchen können. Während die Inspektion über den Namen praktisch ist, ist die Verwendung der ID ebenfalls möglich und in bestimmten Szenarien nützlich.

Zuerst rufen wir die ID der zuvor erstellten Config my_config ab. Sie können die ID aus der Ausgabe des Befehls docker config ls erhalten.

docker config ls

Suchen Sie in der Ausgabe nach der Spalte ID für den Eintrag my_config. Kopieren Sie diese ID.

Verwenden Sie nun den Befehl docker config inspect gefolgt von der soeben kopierten Config-ID. Ersetzen Sie <config_id> durch die tatsächliche ID.

docker config inspect <config_id>

Beispiel: Wenn die ID abc123def456 lautet, wäre der Befehl:

docker config inspect abc123def456

Dieser Befehl erzeugt die gleiche detaillierte JSON-Ausgabe wie bei der Inspektion über den Namen und liefert Informationen über die Eigenschaften der Config.

Die Inspektion per ID ist besonders nützlich, wenn Sie mehrere Configs mit ähnlichen Namen haben oder mit Skripten arbeiten, die auf Config-IDs angewiesen sind.

Ausgabe mit --format formatieren

In diesem Schritt lernen Sie, wie Sie die Ausgabe des docker config inspect-Befehls mit dem --format-Flag formatieren können. Dies ist nützlich, wenn Sie spezifische Informationen aus der JSON-Ausgabe in einem besser lesbaren Format extrahieren möchten.

Das --format-Flag verwendet Go's text/template-Paket. Sie können die anzuzeigenden Felder und deren Formatierung festlegen.

Lassen Sie uns versuchen, nur die ID und den Erstellungszeitpunkt der my_config anzuzeigen. Wir können folgende Formatierungszeichenkette verwenden: {{.ID}} {{.CreatedAt}}.

docker config inspect --format '{{.ID}} {{.CreatedAt}}' my_config

Dieser Befehl gibt die ID und den Erstellungszeitpunkt der my_config aus, durch ein Leerzeichen getrennt.

Sie können auch verschachtelte Felder innerhalb der JSON-Ausgabe ansprechen. Um beispielsweise den Namen der Config anzuzeigen, der unter Spec.Name liegt, würden Sie {{.Spec.Name}} verwenden.

Lassen Sie uns den Namen und die base64-kodierten Daten der Config anzeigen.

docker config inspect --format 'Name: {{.Spec.Name}}, Data: {{.Spec.Data}}' my_config

Dieser Befehl gibt den Namen und die base64-kodierten Daten der Config in einem strukturierteren Format aus.

Das --format-Flag ist ein leistungsfähiges Werkzeug, um die Ausgabe von Docker-Befehlen anzupassen und genau die benötigten Informationen zu extrahieren.

Zusammenfassung

In diesem Lab haben Sie gelernt, wie Sie mit dem Befehl docker config create eine Docker Config aus einer Datei erstellen und deren Erstellung mit docker config ls überprüfen können. Anschließend haben Sie untersucht, wie Sie eine Docker Config mit dem Befehl docker config inspect detailliert einsehen können, wobei gezeigt wurde, wie dies anhand des Config-Namens erfolgt.