Comment utiliser la commande docker plugin set pour modifier les paramètres d'un plugin

Introduction

Dans ce laboratoire (lab), vous apprendrez à utiliser la commande docker plugin set pour modifier les paramètres d'un plugin Docker. Nous commencerons par inspecter la configuration initiale d'un plugin à l'aide de la commande docker plugin inspect afin de comprendre son état actuel.

Après l'inspection, vous allez pratiquer la modification de divers paramètres du plugin, notamment les variables d'environnement, la source d'un montage, le chemin d'un périphérique et la source des arguments, tout cela en utilisant la commande docker plugin set. Cette expérience pratique démontrera la flexibilité et le contrôle que vous avez sur le comportement des plugins Docker.

Skills Graph

Inspecter les paramètres initiaux d'un plugin

Dans cette étape, nous apprendrons à inspecter les paramètres initiaux d'un plugin Docker. Les plugins Docker étendent les fonctionnalités de Docker, permettant d'utiliser des pilotes de stockage personnalisés, des pilotes réseau, etc. Avant de modifier les paramètres d'un plugin, il est essentiel de comprendre sa configuration actuelle.

Nous utiliserons la commande docker plugin inspect pour afficher les détails d'un plugin spécifique. Pour ce laboratoire (lab), nous utiliserons le plugin vieux/sshfs comme exemple. Ce plugin vous permet de monter des systèmes de fichiers SSH distants dans vos conteneurs.

Tout d'abord, assurons-nous que le plugin vieux/sshfs est installé et activé. S'il ne l'est pas, vous pouvez l'installer en utilisant la commande docker plugin install.

docker plugin install vieux/sshfs:latest

Cette commande installe le plugin vieux/sshfs depuis Docker Hub. L'étiquette :latest spécifie la dernière version du plugin.

Une fois le plugin installé, vous pouvez vérifier son statut en utilisant la commande docker plugin ls.

docker plugin ls

Vous devriez voir vieux/sshfs:latest répertorié avec le statut ENABLED défini sur true.

Maintenant, inspectons les paramètres du plugin en utilisant la commande docker plugin inspect.

docker plugin inspect vieux/sshfs:latest

Cette commande affichera un objet JSON détaillé contenant tous les détails de configuration du plugin vieux/sshfs. Cette sortie inclut des informations sur l'ID du plugin, le nom, le statut d'activation, les paramètres, etc.

Faites défiler la sortie pour voir les diverses options de configuration disponibles pour ce plugin. Faites attention à la section Settings, qui contient les paramètres de configuration spécifiques qui peuvent être modifiés.

Modifier une variable d'environnement avec docker plugin set

Dans cette étape, nous apprendrons à modifier une variable d'environnement pour un plugin Docker en utilisant la commande docker plugin set. La modification des paramètres des plugins vous permet de personnaliser leur comportement pour répondre à vos besoins spécifiques.

Avant de pouvoir modifier les paramètres d'un plugin, le plugin doit être désactivé. Vous ne pouvez pas modifier les paramètres d'un plugin activé. Nous continuerons à utiliser le plugin vieux/sshfs comme exemple.

Tout d'abord, désactivons le plugin vieux/sshfs.

docker plugin disable vieux/sshfs:latest

Cette commande désactive le plugin spécifié. Vous pouvez vérifier que le plugin est désactivé en exécutant à nouveau docker plugin ls. Le statut ENABLED pour vieux/sshfs:latest devrait maintenant être false.

Maintenant que le plugin est désactivé, nous pouvons modifier une variable d'environnement. Le plugin vieux/sshfs a une variable d'environnement appelée DEBUG qui contrôle la sortie de débogage. Par défaut, elle est probablement définie sur false. Modifions-la en true.

docker plugin set vieux/sshfs:latest DEBUG=true

Cette commande définit la variable d'environnement DEBUG pour le plugin vieux/sshfs:latest sur true. Le format pour définir les variables est NOM_PLUGIN NOM_VARIABLE=VALEUR.

Après avoir défini la variable d'environnement, vous pouvez inspecter à nouveau le plugin pour confirmer la modification.

docker plugin inspect vieux/sshfs:latest

Recherchez la section Settings dans la sortie JSON. Vous devriez voir une entrée pour Env qui est une liste de variables d'environnement. La variable DEBUG devrait maintenant être définie sur true.

Enfin, après avoir effectué les modifications souhaitées, vous pouvez réactiver le plugin.

docker plugin enable vieux/sshfs:latest

Vérifiez que le plugin est activé en utilisant docker plugin ls.

Modifier la source d'un montage avec docker plugin set

Dans cette étape, nous apprendrons à modifier la source d'un montage pour un plugin Docker en utilisant la commande docker plugin set. Certains plugins ont besoin d'accéder à des répertoires ou des fichiers spécifiques sur le système hôte. Ces éléments sont configurés en tant que montages.

De même que pour la modification des variables d'environnement, vous devez désactiver le plugin avant de pouvoir modifier ses paramètres de montage. Nous continuerons à utiliser le plugin vieux/sshfs.

Tout d'abord, assurez-vous que le plugin vieux/sshfs est désactivé. Si vous l'avez activé à l'étape précédente, désactivez-le maintenant.

docker plugin disable vieux/sshfs:latest

Vérifiez que le plugin est désactivé en utilisant docker plugin ls.

Le plugin vieux/sshfs a besoin d'accéder au fichier /etc/ssh/ssh_known_hosts sur le système hôte pour vérifier l'identité du serveur SSH auquel il se connecte. Ceci est configuré en tant que montage. Modifions le chemin source de ce montage.

Nous allons changer le chemin source de /etc/ssh/ssh_known_hosts à /root/.ssh/known_hosts. Remarque : Dans un scénario réel, vous vous assureriez que le fichier cible existe et a les bonnes autorisations. Pour ce laboratoire (lab), nous nous concentrons sur la syntaxe de la commande.

docker plugin set vieux/sshfs:latest Mounts[0].Source=/root/.ssh/known_hosts

Cette commande définit le champ Source du premier montage (Mounts[0]) pour le plugin vieux/sshfs:latest sur /root/.ssh/known_hosts. La syntaxe Mounts[0] fait référence au premier élément du tableau Mounts dans les paramètres du plugin. Vous pouvez trouver l'index du montage que vous souhaitez modifier en inspectant la configuration du plugin.

Après avoir modifié la source du montage, inspectez le plugin pour confirmer la modification.

docker plugin inspect vieux/sshfs:latest

Examinez la section Settings et trouvez le tableau Mounts. Le champ Source du premier montage devrait maintenant être /root/.ssh/known_hosts.

Enfin, réactivez le plugin.

docker plugin enable vieux/sshfs:latest

Vérifiez que le plugin est activé en utilisant docker plugin ls.

Modifier le chemin d'un périphérique avec docker plugin set

Dans cette étape, nous apprendrons à modifier le chemin d'un périphérique auquel un plugin Docker a accès en utilisant la commande docker plugin set. Certains plugins peuvent avoir besoin d'un accès direct aux périphériques hôtes, tels que des périphériques de stockage ou des interfaces réseau.

Comme pour la modification des autres paramètres des plugins, le plugin doit être désactivé avant de pouvoir modifier ses configurations de périphériques. Nous continuerons à utiliser le plugin vieux/sshfs comme exemple, bien que ce plugin spécifique n'ait généralement pas besoin d'accéder à des périphériques. Nous allons démontrer la syntaxe de la commande en utilisant un périphérique hypothétique.

Tout d'abord, assurez-vous que le plugin vieux/sshfs est désactivé.

docker plugin disable vieux/sshfs:latest

Vérifiez que le plugin est désactivé en utilisant docker plugin ls.

Maintenant, imaginons que le plugin vieux/sshfs ait besoin d'accéder à un périphérique situé à /dev/sda1. Nous voulons le changer en /dev/sdb1. Nous utiliserions la commande docker plugin set avec le tableau Devices.

Remarque : Le plugin vieux/sshfs n'a pas de configuration Devices par défaut. Il s'agit d'un exemple hypothétique pour démontrer la syntaxe de la commande pour modifier les chemins des périphériques. L'exécution de cette commande sur le plugin vieux/sshfs entraînera probablement une erreur car le champ Devices n'existe pas dans sa configuration. Cependant, la syntaxe présentée est correcte pour les plugins qui ont des configurations de périphériques.

En supposant que le plugin ait un tableau Devices et que nous voulions modifier le PathOnHost du premier périphérique (Devices[0]), la commande serait la suivante :

docker plugin set vieux/sshfs:latest Devices[0].PathOnHost=/dev/sdb1

Cette commande tente de définir le champ PathOnHost du premier périphérique (Devices[0]) pour le plugin vieux/sshfs:latest sur /dev/sdb1. La syntaxe Devices[0] fait référence au premier élément du tableau Devices dans les paramètres du plugin.

Étant donné que le plugin vieux/sshfs n'a pas de tableau Devices, la commande ci-dessus échouera. C'est normal pour ce plugin spécifique, mais cela illustre la bonne syntaxe pour modifier les chemins des périphériques pour les plugins qui prennent en charge cette configuration.

Pour voir les paramètres réels du plugin vieux/sshfs, vous pouvez l'inspecter à nouveau.

docker plugin inspect vieux/sshfs:latest

Vous ne verrez pas de section Devices dans la sortie pour ce plugin.

Enfin, réactivez le plugin.

docker plugin enable vieux/sshfs:latest

Vérifiez que le plugin est activé en utilisant docker plugin ls.

Modifier la source des arguments avec docker plugin set

Dans cette étape, nous apprendrons à modifier la source des arguments passés à un plugin Docker en utilisant la commande docker plugin set. Certains plugins acceptent des arguments de ligne de commande lors de leur initialisation ou de leur exécution.

Pour modifier les arguments d'un plugin, il doit être désactivé en premier. Nous continuerons à utiliser le plugin vieux/sshfs comme exemple.

Tout d'abord, assurez-vous que le plugin vieux/sshfs est désactivé.

docker plugin disable vieux/sshfs:latest

Vérifiez que le plugin est désactivé en utilisant docker plugin ls.

Le plugin vieux/sshfs accepte des arguments qui sont passés à la commande sshfs sous - jacente. Ces arguments sont configurés dans les paramètres du plugin. Modifions la source de ces arguments.

Nous allons changer la source des arguments pour inclure l'option -o allow_other, qui permet aux utilisateurs non - root de monter le système de fichiers.

docker plugin set vieux/sshfs:latest Args="-o allow_other"

Cette commande définit le champ Args pour le plugin vieux/sshfs:latest sur "-o allow_other". Le champ Args est généralement une chaîne de caractères ou un tableau de chaînes de caractères qui représentent les arguments de ligne de commande passés à l'exécutable du plugin.

Après avoir modifié les arguments, inspectez le plugin pour confirmer la modification.

docker plugin inspect vieux/sshfs:latest

Examinez la section Settings et trouvez le champ Args. Il devrait maintenant être défini sur "-o allow_other".

Enfin, réactivez le plugin.

docker plugin enable vieux/sshfs:latest

Vérifiez que le plugin est activé en utilisant docker plugin ls.

Résumé

Dans ce laboratoire, nous avons appris à gérer les paramètres des plugins Docker en utilisant la commande docker plugin set. Nous avons commencé par inspecter la configuration initiale d'un plugin à l'aide de docker plugin inspect pour comprendre son état actuel, en nous concentrant particulièrement sur la section Settings. Cette inspection initiale est essentielle avant de procéder à toute modification.

Ensuite, nous avons exploré comment modifier différents paramètres de plugin en utilisant docker plugin set. Nous avons vu comment changer une variable d'environnement, modifier la source d'un montage, modifier le chemin d'un périphérique et changer la source des arguments. Ces étapes ont démontré la flexibilité de docker plugin set pour personnaliser le comportement des plugins afin de répondre à des exigences spécifiques.