Comment utiliser la commande docker config inspect pour visualiser les détails d'une configuration

Introduction

Dans ce lab, vous apprendrez à utiliser la commande docker config inspect pour afficher des informations détaillées sur les configurations Docker. Nous commencerons par créer une configuration Docker à partir d'un fichier, une étape fondamentale pour gérer des données de configuration non sensibles au sein d'un essaim (swarm) Docker.

Après la création, vous explorerez comment inspecter la configuration créée en utilisant à la fois son nom et son ID unique, démontrant ainsi différentes méthodes pour accéder aux détails de la configuration. Enfin, vous apprendrez à formater la sortie de la commande docker config inspect en utilisant le drapeau --format pour personnaliser les informations affichées.

Skills Graph

Créer une configuration Docker

Dans cette étape, vous apprendrez à créer une configuration Docker. Les configurations Docker sont utilisées pour stocker des informations non sensibles, telles que des fichiers de configuration, qui peuvent être accessibles par des services dans un essaim (swarm).

Tout d'abord, créons un simple fichier de configuration. Nous allons créer un fichier nommé my_config.txt dans le répertoire ~/project avec un contenu d'exemple.

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

Maintenant, nous pouvons créer une configuration Docker à partir de ce fichier en utilisant la commande docker config create. La syntaxe de base est docker config create <nom_configuration> <chemin_fichier>.

docker config create my_config ~/project/my_config.txt

Vous devriez voir l'ID de la nouvelle configuration affiché dans la console. Cela indique que la configuration a été créée avec succès.

Pour vérifier que la configuration a bien été créée, vous pouvez lister toutes les configurations Docker en utilisant la commande docker config ls.

docker config ls

Vous devriez voir my_config dans la sortie, accompagné de son ID et de sa date de création.

Inspecter une configuration par son nom

Dans cette étape, vous apprendrez comment inspecter une configuration Docker en utilisant son nom. La commande docker config inspect vous permet de visualiser des informations détaillées sur une configuration spécifique.

Pour inspecter la configuration my_config créée précédemment, utilisez la commande docker config inspect suivie du nom de la configuration.

docker config inspect my_config

Cette commande affichera un objet JSON contenant diverses informations sur la configuration my_config, telles que son ID, sa date de création et le contenu des données de configuration.

Le résultat fournit une vue détaillée des propriétés de la configuration. Vous pouvez voir les champs ID, CreatedAt, UpdatedAt, Spec et Version. Le champ Spec contient les données de configuration réelles, qui sont encodées en base64.

Inspecter une configuration par son ID

Dans cette étape, vous apprendrez comment inspecter une configuration Docker en utilisant son ID. Bien que l'inspection par nom soit pratique, l'utilisation de l'ID est également possible et peut s'avérer utile dans certains scénarios.

Tout d'abord, récupérons l'ID de la configuration my_config créée précédemment. Vous pouvez obtenir cet ID à partir de la sortie de la commande docker config ls.

docker config ls

Recherchez la colonne ID dans la sortie pour l'entrée my_config. Copiez cet ID.

Maintenant, utilisez la commande docker config inspect suivie de l'ID de configuration que vous venez de copier. Remplacez <config_id> par l'ID réel.

docker config inspect <config_id>

Par exemple, si l'ID était abc123def456, la commande serait :

docker config inspect abc123def456

Cette commande produira le même résultat JSON détaillé que lors de l'inspection par nom, fournissant des informations sur les propriétés de la configuration.

L'inspection par ID est particulièrement utile lorsque vous avez plusieurs configurations avec des noms similaires ou lorsque vous travaillez avec des scripts qui dépendent des ID de configuration.

Formater la sortie avec --format

Dans cette étape, vous apprendrez comment formater la sortie de la commande docker config inspect en utilisant le flag --format. Ceci est utile lorsque vous souhaitez extraire des informations spécifiques du résultat JSON dans un format plus lisible.

Le flag --format utilise le package text/template de Go. Vous pouvez spécifier les champs à afficher et leur formatage.

Essayons d'afficher uniquement l'ID et la date de création de my_config. Nous pouvons utiliser la chaîne de format suivante : {{.ID}} {{.CreatedAt}}.

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

Cette commande affichera l'ID et la date de création de my_config, séparés par un espace.

Vous pouvez également accéder aux champs imbriqués dans le résultat JSON. Par exemple, pour accéder au nom de la configuration (situé sous Spec.Name), vous utiliserez {{.Spec.Name}}.

Affichons maintenant le nom et les données encodées en base64 de la configuration.

docker config inspect --format 'Nom: {{.Spec.Name}}, Données: {{.Spec.Data}}' my_config

Cette commande affichera le nom et les données encodées en base64 de la configuration dans un format plus structuré.

Le flag --format est un outil puissant pour personnaliser la sortie des commandes Docker et extraire les informations dont vous avez besoin.

Résumé

Dans ce lab, vous avez appris à créer une configuration Docker à partir d'un fichier en utilisant la commande docker config create et à vérifier sa création avec docker config ls. Vous avez ensuite exploré comment inspecter une configuration Docker pour visualiser ses informations détaillées à l'aide de la commande docker config inspect, en démontrant comment inspecter une configuration par son nom.