Verwendung des docker config ls Befehls zum Auflisten von Konfigurationen

Einführung

In diesem Lab lernen Sie, wie Sie den Befehl docker config ls effektiv zur Verwaltung Ihrer Docker-Konfigurationen einsetzen. Sie beginnen damit, alle verfügbaren Konfigurationen aufzulisten und verstehen, wie diese erstellt und angezeigt werden.

Darauf aufbauend erkunden Sie leistungsfähige Filtertechniken mit dem --filter-Flag, um spezifische Konfigurationen nach Namen und Labeln zu lokalisieren. Abschließend lernen Sie, wie Sie die Ausgabe des docker config ls-Befehls formatieren, um die Informationen optimal darzustellen.

Skills Graph

Alle Konfigurationen auflisten

In diesem Schritt lernen Sie, wie Sie alle Docker-Konfigurationen mit dem Befehl docker config ls anzeigen können. Docker-Konfigurationen werden verwendet, um sensible Daten oder Konfigurationsdateien zu speichern, auf die von Services zugegriffen werden kann.

Zuerst erstellen wir eine einfache Konfiguration. Wir legen eine Datei namens my_config.txt in Ihrem Home-Verzeichnis mit beispielhaftem Inhalt an.

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

Nun erstellen wir eine Docker-Konfiguration aus dieser Datei.

docker config create my_config ~/my_config.txt

Sie sollten die ID der erstellten Konfiguration als Ausgabe sehen.

Jetzt können Sie alle verfügbaren Docker-Konfigurationen mit dem Befehl docker config ls auflisten.

docker config ls

Dieser Befehl zeigt eine Tabelle mit Informationen zu Ihren Konfigurationen an, einschließlich der ID, des Namens und des Erstellungszeitpunkts (CreatedAt). In der Liste sollten Sie die gerade erstellte Konfiguration my_config sehen.

Konfigurationen nach Namen filtern

In diesem Schritt lernen Sie, wie Sie Docker-Konfigurationen nach Namen filtern können, indem Sie das --filter-Flag mit dem name-Schlüssel verwenden. Dies ist besonders nützlich, wenn Sie viele Konfigurationen haben und eine bestimmte suchen.

Im vorherigen Schritt haben Sie eine Konfiguration namens my_config erstellt. Lassen Sie uns nun eine weitere Konfiguration anlegen, um die Filterfunktion zu demonstrieren.

Erstellen Sie zunächst eine neue Datei namens another_config.txt in Ihrem Home-Verzeichnis.

echo "This is another configuration." > ~/another_config.txt

Erstellen Sie nun eine Docker-Konfiguration aus dieser Datei.

docker config create another_config ~/another_config.txt

Sie sollten die ID der neu erstellten Konfiguration sehen.

Lassen Sie uns nun alle Konfigurationen erneut auflisten, um beide zu sehen.

docker config ls

In der Ausgabe sollten sowohl my_config als auch another_config erscheinen.

Um die Konfigurationen zu filtern und nur die mit dem Namen my_config anzuzeigen, können Sie die Option --filter name=my_config verwenden.

docker config ls --filter name=my_config

Dieser Befehl zeigt nur die Konfiguration mit dem Namen my_config an.

Analog können Sie mit folgendem Befehl nur another_config anzeigen:

docker config ls --filter name=another_config

Dies demonstriert, wie Sie den name-Filter verwenden können, um bestimmte Konfigurationen zu finden.

Konfigurationen nach Labels filtern

In diesem Schritt lernen Sie, wie Sie Docker-Konfigurationen nach Labels filtern können, indem Sie das --filter-Flag mit dem label-Schlüssel verwenden. Labels sind Schlüssel-Wert-Paare, die Sie Docker-Objekten zuordnen können, um sie zu organisieren und zu kategorisieren.

Erstellen wir zunächst eine neue Konfiguration und fügen ein Label hinzu. Wir legen eine Datei namens labeled_config.txt in Ihrem Home-Verzeichnis an.

echo "This config has a label." > ~/labeled_config.txt

Erstellen Sie nun eine Docker-Konfiguration aus dieser Datei und fügen Sie das Label env=production mit dem --label-Flag hinzu.

docker config create --label env=production labeled_config ~/labeled_config.txt

Sie sollten die ID der erstellten Konfiguration sehen.

Lassen Sie uns eine weitere Konfiguration mit einem anderen Label erstellen. Legen Sie eine Datei namens another_labeled_config.txt an.

echo "This config has a different label." > ~/another_labeled_config.txt

Erstellen Sie nun eine Docker-Konfiguration mit dem Label env=development.

docker config create --label env=development another_labeled_config ~/another_labeled_config.txt

Listen Sie nun alle Konfigurationen auf, um die neu erstellten mit Labels zu sehen.

docker config ls

In der Liste sollten labeled_config und another_labeled_config erscheinen.

Um Konfigurationen nach Label zu filtern, verwenden Sie das Format --filter label=<Schlüssel>=<Wert>. Zum Beispiel, um Konfigurationen mit dem Label env=production anzuzeigen:

docker config ls --filter label=env=production

Dieser Befehl zeigt nur die labeled_config an.

Um Konfigurationen mit dem Label env=development anzuzeigen:

docker config ls --filter label=env=development

Dies zeigt die another_labeled_config an.

Sie können auch nur nach dem Label-Schlüssel filtern, unabhängig vom Wert. Zum Beispiel, um alle Konfigurationen mit einem env-Label anzuzeigen:

docker config ls --filter label=env

Dies zeigt sowohl labeled_config als auch another_labeled_config an.

Ausgabe der Konfigurationsliste formatieren

In diesem Schritt lernen Sie, wie Sie die Ausgabe des docker config ls-Befehls mit dem --format-Flag formatieren können. Dies ermöglicht es Ihnen, die Ausgabe anzupassen, um nur die benötigten Informationen anzuzeigen oder sie in einem bestimmten Format wie JSON darzustellen.

Standardmäßig gibt docker config ls eine Tabelle aus.

docker config ls

Mit dem --format-Flag können Sie eine Go-Vorlage angeben, um die Ausgabe zu formatieren. Um beispielsweise nur die Konfigurations-ID und den Namen anzuzeigen, können Sie folgendes Format verwenden:

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

Dieser Befehl gibt die ID und den Namen jeder Konfiguration aus, getrennt durch einen Tab.

Sie können die Daten auch im JSON-Format ausgeben, was für Skripte oder die Integration mit anderen Tools nützlich ist.

docker config ls --format json

Dies gibt ein JSON-Array aus, wobei jedes Element eine Konfiguration repräsentiert.

Lassen Sie uns ein weiteres Format ausprobieren, um den Namen und den Erstellungszeitpunkt anzuzeigen.

docker config ls --format "Config Name: {{.Name}}, Created At: {{.CreatedAt}}"

Dieser Befehl gibt für jede Konfiguration eine benutzerdefinierte Zeichenkette aus, die ihren Namen und den Erstellungszeitstempel zeigt.

Sie können andere verfügbare Felder erkunden, die Sie in Ihr Format aufnehmen möchten, indem Sie eine Konfiguration mit docker config inspect <config_id> untersuchen.

Untersuchen wir beispielsweise my_config, um dessen Details zu sehen. Ersetzen Sie <config_id> durch die tatsächliche ID von my_config aus der docker config ls-Ausgabe.

docker config inspect my_config

Die Ausgabe zeigt verschiedene Felder wie ID, Name, CreatedAt, UpdatedAt, Spec und Version. Sie können diese Feldnamen in Ihrer --format-Zeichenkette verwenden.

Experimentieren Sie mit verschiedenen Formatzeichenketten, um zu sehen, wie Sie die Ausgabe nach Ihren Bedürfnissen anpassen können.

Zusammenfassung

In diesem Lab haben Sie gelernt, wie Sie den Befehl docker config ls verwenden, um Docker-Konfigurationen aufzulisten. Sie begannen damit, eine Beispielkonfiguration mit docker config create zu erstellen und nutzten dann docker config ls, um alle verfügbaren Konfigurationen anzuzeigen, wobei Sie die ID, den Namen und den Erstellungszeitstempel beobachteten.

Darüber hinaus haben Sie untersucht, wie Sie die aufgelisteten Konfigurationen mit dem --filter-Flag filtern können. Sie lernten, wie Sie nach Namen mit --filter name=<config_name> filtern, um nur Konfigurationen anzuzeigen, die einem bestimmten Namen entsprechen.