Comment utiliser la commande docker config ls pour lister les configurations

Introduction

Dans ce lab, vous apprendrez à utiliser efficacement la commande docker config ls pour gérer vos configurations Docker. Vous commencerez par lister toutes les configurations disponibles, puis comprendrez comment les créer et les visualiser.

Ensuite, vous explorerez des techniques de filtrage avancées en utilisant le flag --filter pour localiser des configurations spécifiques par nom et par étiquette (label). Enfin, vous apprendrez à formater la sortie de la commande docker config ls pour afficher les informations de la manière qui correspond le mieux à vos besoins.

Skills Graph

Lister toutes les configurations

Dans cette étape, vous apprendrez à lister toutes les configurations Docker en utilisant la commande docker config ls. Les configurations Docker sont utilisées pour stocker des données sensibles ou des fichiers de configuration accessibles par les services.

Commençons par créer une configuration simple. Nous allons créer un fichier nommé my_config.txt dans votre répertoire personnel avec un contenu exemple.

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

Maintenant, créons une configuration Docker à partir de ce fichier.

docker config create my_config ~/my_config.txt

Vous devriez voir l'ID de la configuration créée en sortie.

Vous pouvez maintenant lister toutes les configurations Docker disponibles avec la commande docker config ls.

docker config ls

Cette commande affichera un tableau avec des informations sur vos configurations, incluant l'ID, le Nom et le timestamp CreatedAt. Vous devriez voir la configuration my_config que vous venez de créer dans la liste.

Filtrer les configurations par nom

Dans cette étape, vous apprendrez à filtrer les configurations Docker par nom en utilisant le flag --filter avec la clé name. Cette fonctionnalité est utile lorsque vous avez de nombreuses configurations et que vous souhaitez en trouver une spécifique.

Lors de l'étape précédente, vous avez créé une configuration nommée my_config. Créons maintenant une autre configuration pour illustrer le filtrage.

Commencez par créer un nouveau fichier nommé another_config.txt dans votre répertoire personnel.

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

Maintenant, créez une configuration Docker à partir de ce fichier.

docker config create another_config ~/another_config.txt

Vous devriez voir l'ID de la nouvelle configuration créée.

Listons à nouveau toutes les configurations pour voir les deux.

docker config ls

Vous devriez voir à la fois my_config et another_config dans le résultat.

Pour filtrer les configurations et n'afficher que celle nommée my_config, utilisez l'option --filter name=my_config.

docker config ls --filter name=my_config

Cette commande n'affichera que la configuration portant le nom my_config.

De même, pour filtrer et n'afficher que another_config, vous utiliserez :

docker config ls --filter name=another_config

Ceci démontre comment utiliser le filtre name pour trouver des configurations spécifiques.

Filtrer les configurations par étiquette (label)

Dans cette étape, vous apprendrez à filtrer les configurations Docker par étiquettes (labels) en utilisant le flag --filter avec la clé label. Les étiquettes sont des paires clé-valeur que vous pouvez associer aux objets Docker pour les organiser et les catégoriser.

Commençons par créer une nouvelle configuration et lui ajouter une étiquette. Nous allons créer un fichier nommé labeled_config.txt dans votre répertoire personnel.

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

Maintenant, créez une configuration Docker à partir de ce fichier et ajoutez l'étiquette env=production en utilisant le flag --label.

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

Vous devriez voir l'ID de la configuration créée.

Créons une autre configuration avec une étiquette différente. Créez un fichier nommé another_labeled_config.txt.

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

Maintenant, créez une configuration Docker avec l'étiquette env=development.

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

Listons maintenant toutes les configurations pour voir les nouvelles configurations avec leurs étiquettes.

docker config ls

Vous devriez voir labeled_config et another_labeled_config dans la liste.

Pour filtrer les configurations par étiquette, utilisez le format --filter label=<clé>=<valeur>. Par exemple, pour lister les configurations avec l'étiquette env=production :

docker config ls --filter label=env=production

Cette commande n'affichera que la configuration labeled_config.

Pour lister les configurations avec l'étiquette env=development :

docker config ls --filter label=env=development

Cette commande affichera la configuration another_labeled_config.

Vous pouvez également filtrer uniquement par la clé d'étiquette, indépendamment de sa valeur. Par exemple, pour lister toutes les configurations ayant une étiquette env :

docker config ls --filter label=env

Cette commande affichera à la fois labeled_config et another_labeled_config.

Formater la sortie de la liste des configurations

Dans cette étape, vous apprendrez à formater la sortie de la commande docker config ls en utilisant le flag --format. Cela vous permet de personnaliser l'affichage pour ne montrer que les informations nécessaires ou de les présenter dans un format spécifique comme JSON.

Par défaut, docker config ls affiche un tableau.

docker config ls

Vous pouvez utiliser le flag --format pour spécifier un template Go afin de formater la sortie. Par exemple, pour afficher uniquement l'ID et le nom de la configuration :

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

Cette commande affichera l'ID et le nom de chaque configuration, séparés par une tabulation.

Vous pouvez également obtenir les données au format JSON, ce qui est utile pour des scripts ou une intégration avec d'autres outils.

docker config ls --format json

Cela produira un tableau JSON où chaque élément représente une configuration.

Essayons un autre format pour afficher le nom et la date de création.

docker config ls --format "Nom de la configuration : {{.Name}}, Créée le : {{.CreatedAt}}"

Cette commande affichera une chaîne personnalisée pour chaque configuration, montrant son nom et son horodatage de création.

Vous pouvez explorer d'autres champs disponibles à inclure dans votre format en inspectant une configuration avec docker config inspect <config_id>.

Par exemple, inspectons my_config pour voir ses détails. Remplacez <config_id> par l'ID réel de my_config obtenu dans la sortie de docker config ls.

docker config inspect my_config

La sortie montrera différents champs comme ID, Name, CreatedAt, UpdatedAt, Spec et Version. Vous pouvez utiliser ces noms de champs dans votre chaîne de format --format.

Expérimentez avec différentes chaînes de format pour voir comment personnaliser l'affichage selon vos besoins.

Résumé

Dans ce lab, vous avez appris à utiliser la commande docker config ls pour lister les configurations Docker. Vous avez commencé par créer une configuration exemple avec docker config create, puis utilisé docker config ls pour visualiser toutes les configurations disponibles, en observant l'ID, le Nom et l'horodatage CreatedAt.

De plus, vous avez exploré comment filtrer les configurations listées en utilisant le flag --filter. Vous avez appris à filtrer par nom avec --filter name=<config_name> pour n'afficher que les configurations correspondant à un nom spécifique.