Comment modifier la configuration d'un contexte Docker avec la commande docker context update

Introduction

Dans ce labo, nous allons explorer comment modifier la configuration des contextes Docker existants en utilisant la commande docker context update. Nous commencerons par créer un nouveau contexte Docker pour travailler.

Après la création du contexte, nous démontrerons comment mettre à jour sa description et modifier le point de terminaison Docker auquel il se connecte. Enfin, nous vérifierons que la configuration du contexte a été mise à jour avec succès. Cet exercice pratique fournira une expérience concrète dans la gestion et la modification des contextes Docker pour se connecter à différents démons Docker.

Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL docker(("Docker")) -.-> docker/ContainerOperationsGroup(["Container Operations"]) docker(("Docker")) -.-> docker/SystemManagementGroup(["System Management"]) docker/ContainerOperationsGroup -.-> docker/ls("List Containers") docker/ContainerOperationsGroup -.-> docker/inspect("Inspect Container") docker/ContainerOperationsGroup -.-> docker/create("Create Container") docker/SystemManagementGroup -.-> docker/system("Manage Docker") subgraph Lab Skills docker/ls -.-> lab-555136{{"Comment utiliser la commande docker context update pour modifier la configuration d'un contexte"}} docker/inspect -.-> lab-555136{{"Comment utiliser la commande docker context update pour modifier la configuration d'un contexte"}} docker/create -.-> lab-555136{{"Comment utiliser la commande docker context update pour modifier la configuration d'un contexte"}} docker/system -.-> lab-555136{{"Comment utiliser la commande docker context update pour modifier la configuration d'un contexte"}} end

Créer un nouveau contexte Docker

Dans cette étape, nous allons apprendre à créer un nouveau contexte Docker. Un contexte Docker est un moyen de gérer les connexions à différents démons Docker. Par défaut, Docker utilise le contexte default, qui se connecte au démon Docker local. Cependant, vous pouvez créer de nouveaux contextes pour vous connecter à des démons Docker distants ou à d'autres plateformes d'orchestration de conteneurs.

Pour créer un nouveau contexte Docker, nous utilisons la commande docker context create. Cette commande nécessite un nom pour le nouveau contexte et le point de terminaison du démon Docker auquel il doit se connecter. Pour ce labo, nous allons créer un contexte nommé my-context qui se connecte au démon Docker local.

Ouvrez votre terminal et exécutez la commande suivante :

docker context create my-context --docker host=unix:///var/run/docker.sock

Cette commande crée un nouveau contexte nommé my-context. L'option --docker host=unix:///var/run/docker.sock spécifie que ce contexte doit se connecter au démon Docker via le socket Unix situé à /var/run/docker.sock. Il s'agit de l'emplacement par défaut du socket Docker sur la plupart des systèmes Linux.

Après avoir exécuté la commande, vous devriez voir une sortie similaire à ceci, indiquant que le contexte a été créé avec succès :

my-context
Successfully created context "my-context"

Maintenant que nous avons créé le contexte, nous pouvons vérifier son existence en listant les contextes disponibles. Utilisez la commande docker context ls :

docker context ls

Vous devriez voir une liste de contextes, y compris le contexte default et le nouveau contexte my-context. La sortie ressemblera à ceci :

NAME                DESCRIPTION                               DOCKER ENDPOINT                               KUBERNETES ENDPOINT   ORCHESTRATOR
default *           Current DOCKER_HOST                         unix:///var/run/docker.sock                                           swarm
my-context                                                    unix:///var/run/docker.sock

L'astérisque (*) à côté de default indique qu'il s'agit actuellement du contexte actif. Nous apprendrons comment changer de contexte dans une étape ultérieure.

Mettre à jour la description du contexte

Dans cette étape, nous allons mettre à jour la description du contexte Docker créé précédemment. Ajouter une description à un contexte peut s'avérer utile pour se souvenir de son usage, particulièrement lorsque vous utilisez plusieurs contextes.

Pour modifier un contexte Docker, nous utilisons la commande docker context update. Cette commande nécessite le nom du contexte à mettre à jour ainsi que les options à modifier. Nous allons mettre à jour le contexte my-context en lui ajoutant une description.

Ouvrez votre terminal et exécutez la commande suivante :

docker context update my-context --description "Mon contexte Docker local"

Cette commande met à jour le contexte my-context et définit sa description comme "Mon contexte Docker local".

Après exécution de la commande, vous devriez voir une sortie similaire à ceci, confirmant la mise à jour :

my-context
Successfully updated context "my-context"

Vérifions maintenant que la description a bien été mise à jour. Nous pouvons à nouveau utiliser la commande docker context ls pour lister les contextes et voir leurs descriptions :

docker context ls

Vous devriez maintenant voir la description "Mon contexte Docker local" associée au contexte my-context. La sortie ressemblera à ceci :

NAME                DESCRIPTION                 DOCKER ENDPOINT                               KUBERNETES ENDPOINT   ORCHESTRATOR
default *           Current DOCKER_HOST         unix:///var/run/docker.sock                                           swarm
my-context          Mon contexte Docker local   unix:///var/run/docker.sock

L'ajout de descriptions constitue une bonne pratique pour organiser vos contextes Docker.

Mettre à jour l'endpoint Docker du contexte

Dans cette étape, nous allons mettre à jour l'endpoint Docker associé à notre contexte my-context. Bien que dans un scénario réel vous pourriez mettre à jour l'endpoint pour pointer vers un démon Docker distant, pour ce labo, nous allons démontrer le processus en changeant l'endpoint vers un format légèrement différent qui pointe toujours vers le démon local. Cela montre comment vous pourriez modifier les détails de connexion si nécessaire.

Pour mettre à jour l'endpoint Docker, nous utilisons à nouveau la commande docker context update, mais cette fois en spécifiant l'option --docker host avec le nouvel endpoint. Nous allons changer l'endpoint de unix:///var/run/docker.sock vers unix://var/run/docker.sock (en supprimant le slash supplémentaire après unix:).

Ouvrez votre terminal et exécutez la commande suivante :

docker context update my-context --docker host=unix://var/run/docker.sock

Cette commande met à jour le contexte my-context et modifie son endpoint Docker.

Après exécution de la commande, vous devriez voir une sortie similaire à ceci, confirmant la mise à jour :

my-context
Successfully updated context "my-context"

Maintenant, vérifions que l'endpoint Docker a bien été mis à jour. Nous pouvons à nouveau utiliser la commande docker context ls pour lister les contextes et voir leurs endpoints :

docker context ls

Vous devriez maintenant voir le nouvel endpoint Docker unix://var/run/docker.sock associé au contexte my-context. La sortie ressemblera à ceci :

NAME                DESCRIPTION                 DOCKER ENDPOINT             KUBERNETES ENDPOINT   ORCHESTRATOR
default *           Current DOCKER_HOST         unix:///var/run/docker.sock                                           swarm
my-context          Mon contexte Docker local   unix://var/run/docker.sock

La mise à jour de l'endpoint est cruciale lorsque vous avez besoin de modifier la façon dont votre contexte Docker se connecte au démon Docker, comme pour passer d'une connexion locale à une connexion distante.

Vérifier la configuration mise à jour du contexte

Dans cette dernière étape, nous allons effectuer une vérification complète du contexte my-context pour nous assurer que la description et l'endpoint Docker ont bien été mis à jour. Nous utiliserons la commande docker context inspect, qui fournit des informations détaillées sur un contexte spécifique.

Ouvrez votre terminal et exécutez la commande suivante :

docker context inspect my-context

Cette commande affichera un document JSON contenant les détails de configuration du contexte my-context. Nous recherchons les champs Description et Docker.Endpoint dans cette sortie.

La sortie devrait ressembler à ceci (le résultat exact peut varier légèrement selon votre version de Docker et votre environnement) :

[
  {
    "Name": "my-context",
    "Metadata": {
      "Description": "My local Docker context"
    },
    "Endpoints": {
      "docker": {
        "Host": "unix://var/run/docker.sock"
      }
    },
    "TLSMaterial": {},
    "Storage": "my-context"
  }
]

Vérifiez la sortie pour confirmer que le champ Description est bien "My local Docker context" et que le champ Docker.Endpoint est "unix://var/run/docker.sock". Cela confirme que les mises à jour effectuées dans les étapes précédentes ont réussi.

Cette étape conclut notre labo sur la création et la mise à jour de contextes Docker. Vous avez appris à créer un nouveau contexte, ajouter une description et modifier son endpoint Docker. Comprendre les contextes Docker est essentiel pour gérer les connexions à différents environnements Docker.

Résumé

Dans ce labo, nous avons appris à créer un nouveau contexte Docker en utilisant la commande docker context create, en spécifiant un nom et l'endpoint Docker. Nous avons ensuite vérifié la création du nouveau contexte en listant tous les contextes disponibles avec la commande docker context ls.

Après la création, nous avons exploré comment modifier la configuration d'un contexte existant en utilisant la commande docker context update. Plus précisément, nous avons mis à jour la description et l'endpoint Docker du contexte nouvellement créé. Enfin, nous avons confirmé que ces mises à jour ont bien été appliquées en listant à nouveau les contextes et en observant les modifications dans la sortie.