Comment utiliser la commande docker config create pour gérer les configurations

Introduction

Dans ce labo (LabEx), vous apprendrez à gérer efficacement les configurations dans Docker en utilisant la commande docker config create. Nous explorerons différentes méthodes pour créer des configurations, en commençant par la création d'une configuration simple directement à partir de l'entrée standard.

Ensuite, vous découvrirez comment créer une configuration à partir d'un fichier existant, une approche pratique pour gérer des données de configuration plus volumineuses. Nous aborderons également comment ajouter des étiquettes (labels) à vos configurations pour une meilleure organisation et identification. Enfin, vous apprendrez à inspecter les détails des configurations que vous avez créées pour vérifier leur contenu et leurs propriétés.

Skills Graph

Créer une configuration simple à partir de STDIN

Dans cette étape, vous apprendrez à créer une configuration Docker à partir de l'entrée standard (STDIN). Les configurations Docker sont utilisées pour stocker des données non sensibles, telles que des fichiers de configuration, accessibles par les services Docker.

Commençons par créer un contenu de configuration simple. Nous utiliserons la commande echo pour afficher une chaîne de caractères et la rediriger vers la commande docker config create.

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

Dans la commande ci-dessus :

• echo "This is my simple config content." affiche la chaîne qui constituera le contenu de notre configuration.
• | est l'opérateur de redirection (pipe), qui envoie la sortie de la commande echo comme entrée à la commande suivante.
• docker config create est la commande pour créer une nouvelle configuration Docker.
• my_simple_config est le nom que nous donnons à notre configuration.
• - indique à docker config create de lire le contenu de la configuration depuis STDIN.

Après avoir exécuté cette commande, Docker créera une configuration nommée my_simple_config avec le contenu spécifié.

Pour vérifier que la configuration a bien été créée, vous pouvez lister les configurations Docker existantes à l'aide de la commande docker config ls.

docker config ls

Vous devriez voir my_simple_config apparaître dans la sortie.

Créer une configuration à partir d'un fichier

Dans l'étape précédente, vous avez appris à créer une configuration Docker depuis l'entrée standard. Dans cette étape, vous allez apprendre à créer une configuration Docker à partir d'un fichier. C'est une méthode courante pour gérer des données de configuration plus volumineuses ou complexes.

Commençons par créer un simple fichier de configuration. Nous utiliserons l'éditeur nano pour créer un fichier nommé my_config_file.txt dans votre répertoire ~/project.

nano ~/project/my_config_file.txt

Dans l'éditeur nano, saisissez le contenu suivant :

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

Appuyez sur Ctrl + X, puis Y, et enfin Entrée pour sauvegarder le fichier et quitter l'éditeur.

Maintenant que nous avons notre fichier de configuration, nous pouvons créer une configuration Docker à partir de celui-ci en utilisant la commande docker config create.

docker config create my_file_config ~/project/my_config_file.txt

Dans cette commande :

• docker config create est la commande pour créer une nouvelle configuration Docker
• my_file_config est le nom que nous donnons à cette configuration
• ~/project/my_config_file.txt est le chemin vers le fichier contenant le contenu de configuration

Docker lira le contenu de ~/project/my_config_file.txt et créera une configuration nommée my_file_config.

Pour confirmer que la configuration a bien été créée, vous pouvez à nouveau lister les configurations Docker.

docker config ls

Vous devriez maintenant voir à la fois my_simple_config (de l'étape précédente) et my_file_config dans la liste.

Créer une configuration avec des étiquettes (labels)

Dans cette étape, vous apprendrez à ajouter des étiquettes (labels) à vos configurations Docker. Les étiquettes sont des paires clé-valeur que vous pouvez associer aux objets Docker, y compris les configurations, pour mieux les organiser et les identifier. Cela s'avère particulièrement utile dans les déploiements à grande échelle.

Nous allons créer une autre configuration, mais cette fois en ajoutant des étiquettes lors du processus de création. Nous utiliserons le même contenu que le fichier créé à l'étape précédente, mais nous le redirigerons via cat vers docker config create tout en ajoutant des étiquettes avec l'option --label.

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

Décomposons cette commande :

• cat ~/project/my_config_file.txt lit le contenu du fichier créé précédemment
• | redirige le contenu du fichier vers la commande suivante
• docker config create est la commande pour créer une nouvelle configuration Docker
• --label environment=development ajoute une étiquette avec la clé environment et la valeur development
• --label version=1.0 ajoute une autre étiquette avec la clé version et la valeur 1.0. Vous pouvez ajouter plusieurs étiquettes en utilisant plusieurs fois l'option --label
• my_labeled_config est le nom que nous donnons à cette configuration
• - indique que le contenu de la configuration doit être lu depuis STDIN

Après exécution de cette commande, une nouvelle configuration nommée my_labeled_config sera créée avec le contenu spécifié et les étiquettes associées.

Pour visualiser les étiquettes associées à vos configurations, vous pouvez utiliser la commande docker config ls avec l'option --format pour afficher les étiquettes.

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

Cette commande listera les noms des configurations et leurs étiquettes associées. Vous devriez voir les étiquettes environment et version pour my_labeled_config.

Inspecter la configuration créée

Dans cette dernière étape, vous apprendrez à inspecter une configuration Docker pour visualiser ses détails, y compris son ID, son nom, sa date de création et ses étiquettes. Cela est utile pour vérifier les propriétés de la configuration et comprendre son paramétrage.

Nous utiliserons la commande docker config inspect pour visualiser les détails de la configuration my_labeled_config que nous avons créée à l'étape précédente.

docker config inspect my_labeled_config

Cette commande produira une chaîne JSON formatée contenant des informations détaillées sur la configuration spécifiée. Vous verrez des champs comme ID, Name, CreatedAt, UpdatedAt et Labels. Le champ Labels affichera les étiquettes environment et version que nous avons ajoutées.

Vous pouvez également utiliser l'option --pretty pour obtenir un format plus lisible.

docker config inspect --pretty my_labeled_config

Cela affichera les informations dans un format plus organisé, facilitant leur lecture.

L'inspection des configurations est une étape cruciale dans la gestion de vos configurations Docker, vous permettant de vérifier leurs paramètres avant de les utiliser dans vos services.

Récapitulatif

Dans ce lab, vous avez appris à créer des configurations Docker en utilisant la commande docker config create. Vous avez pratiqué la création d'une configuration simple directement depuis l'entrée standard (STDIN), ce qui est utile pour des configurations rapides et légères. Vous avez également appris à créer une configuration à partir d'un fichier, une approche plus pratique pour gérer des données de configuration plus volumineuses ou complexes. Enfin, vous avez exploré comment ajouter des étiquettes (labels) à vos configurations pour une meilleure organisation et gestion des métadonnées, ainsi que comment inspecter les détails de vos configurations créées à l'aide de la commande docker config inspect.