Comment vérifier l'état de connexion Docker avec la commande info

Introduction

Docker est une plateforme de conteneurisation puissante qui vous permet d'empaqueter et d'exécuter des applications dans des environnements isolés. Lorsque vous travaillez avec Docker, vous devez souvent interagir avec des registres de conteneurs, ce qui nécessite une authentification. Connaître votre statut de connexion actuel est essentiel pour gérer efficacement votre flux de travail Docker.

Dans ce lab, vous apprendrez comment vérifier votre statut de connexion Docker en utilisant la commande docker info. Cette compétence est fondamentale pour les utilisateurs de Docker car elle permet de s'assurer que vous avez l'accès approprié pour extraire (pull) et pousser (push) des images depuis des registres privés.

Vérifier l'installation de Docker

Avant de vérifier le statut de connexion, vérifions d'abord que Docker est correctement installé et en cours d'exécution sur notre système. Cette étape garantit que nous disposons d'un environnement Docker fonctionnel pour les opérations suivantes.

Vérification du statut de Docker

Ouvrez un terminal dans l'environnement LabEx. Vous pouvez le faire en cliquant sur l'icône du terminal dans l'environnement de bureau.

Une fois le terminal ouvert, exécutez la commande suivante pour vérifier si Docker est installé et en cours d'exécution :

docker --version

Cette commande doit afficher la version de Docker installée sur votre système. Vous devriez voir une sortie similaire à celle-ci :

Docker version 20.10.21, build 20.10.21-0ubuntu1~22.04.3

Ensuite, vérifions si le démon Docker (Docker daemon) fonctionne correctement. Exécutez la commande suivante :

docker run hello-world

Si Docker fonctionne correctement, il téléchargera une image de test et l'exécutera dans un conteneur. Vous devriez voir une sortie qui inclut :

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

Cela confirme que Docker est correctement installé et en cours d'exécution sur votre système. Si vous rencontrez des erreurs, veuillez vérifier si le service Docker est en cours d'exécution avec :

sudo systemctl status docker

La sortie doit indiquer que le service Docker est actif (en cours d'exécution).

Maintenant que nous avons confirmé que Docker fonctionne correctement, nous pouvons passer à l'apprentissage de la commande docker info à l'étape suivante.

Comprendre la commande Docker Info

Dans cette étape, nous allons explorer la commande docker info et comprendre comment elle fournit des informations précieuses sur votre environnement Docker.

Exécution de la commande Docker Info

La commande docker info fournit une vue d'ensemble complète de votre installation Docker. Elle affiche des informations à l'échelle du système, telles que le nombre de conteneurs et d'images, la version du serveur, le pilote de stockage, et bien plus encore.

Exécutons la commande docker info dans le terminal :

docker info

Vous devriez voir une sortie détaillée avec diverses sections. La sortie sera similaire à ceci :

Client:
 Context:    default
 Debug Mode: false
 Plugins:
  buildx: Docker Buildx (Docker Inc.)
    Version:  v0.9.1
    Path:     /usr/libexec/docker/cli-plugins/docker-buildx
  ...

Server:
 Containers: 1
  Running: 0
  Paused: 0
  Stopped: 1
 Images: 1
 Server Version: 20.10.21
 Storage Driver: overlay2
  Backing Filesystem: extfs
  Supports d_type: true
  Native Overlay Diff: true
  userxattr: false
 ...

 Registry: https://index.docker.io/v1/
 ...

La sortie contient plusieurs sections avec des informations sur le client Docker et le serveur Docker.

Sections clés dans la sortie de Docker Info

Comprenons quelques sections clés de la sortie de docker info :

1. Client : Informations sur la configuration du client Docker.
2. Server : Informations sur le serveur Docker (démon).
3. Containers : Le nombre de conteneurs sur votre système, y compris les conteneurs en cours d'exécution, en pause et arrêtés.
4. Images : Le nombre d'images Docker sur votre système.
5. Server Version : La version du serveur Docker.
6. Storage Driver : Le pilote de stockage utilisé par Docker.
7. Registry : Informations sur les registres Docker configurés.

Pour vérifier le statut de connexion, nous sommes particulièrement intéressés par la section Registry, que nous explorerons à l'étape suivante.

Vérification du statut de connexion Docker

Maintenant que nous comprenons la commande docker info, concentrons-nous sur la façon de l'utiliser pour vérifier notre statut de connexion Docker.

Interprétation du statut de connexion dans Docker Info

Lorsque vous exécutez la commande docker info, la sortie contient des informations sur votre statut de connexion à Docker Hub. Plus précisément, vous devez rechercher la section Registry.

Exécutez à nouveau la commande :

docker info

Maintenant, recherchez la section Registry dans la sortie.

Si vous n'êtes connecté à aucun registre Docker, la sortie affichera simplement l'URL du registre par défaut :

Registry: https://index.docker.io/v1/

Si vous êtes connecté, vous verrez des informations supplémentaires, notamment votre nom d'utilisateur :

Registry: https://index.docker.io/v1/
Username: yourusername

Actuellement, vous n'êtes très probablement pas connecté à Docker Hub ou à un autre registre.

Connexion à Docker Hub

Essayons de nous connecter à Docker Hub pour voir comment les informations de statut de connexion changent. Pour vous connecter à Docker Hub, utilisez la commande docker login :

docker login

Cette commande vous demandera votre nom d'utilisateur et votre mot de passe Docker Hub :

Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, head over to https://hub.docker.com to create one.
Username:
Password:

Aux fins de ce laboratoire, vous n'avez pas besoin de saisir d'informations d'identification réelles. Au lieu de cela, appuyez sur Ctrl+C pour annuler le processus de connexion.

Méthode alternative pour vérifier le statut de connexion

Outre l'utilisation de la commande docker info, vous pouvez également vérifier si vous êtes connecté à Docker Hub en examinant le fichier de configuration Docker :

ls -la ~/.docker/

Si vous êtes connecté, vous devriez voir un fichier nommé config.json dans ce répertoire. Ce fichier contient vos informations d'authentification. Vous pouvez afficher son contenu avec :

cat ~/.docker/config.json

Si vous n'êtes pas connecté, le fichier peut ne pas exister ou peut ne pas contenir d'informations d'authentification.

Déconnexion d'un registre Docker

Maintenant que nous comprenons comment vérifier le statut de connexion et tenter de se connecter, apprenons à se déconnecter d'un registre Docker.

Utilisation de la commande Docker Logout

Pour vous déconnecter d'un registre Docker, vous pouvez utiliser la commande docker logout. Cette commande supprime les informations d'identification stockées pour le registre spécifié, ou le registre par défaut si aucun n'est spécifié.

Exécutez la commande suivante :

docker logout

Si vous n'étiez pas connecté, vous verrez un message comme :

Not logged in to https://index.docker.io/v1/

Si vous étiez connecté et que la déconnexion a réussi, vous verrez :

Removing login credentials for https://index.docker.io/v1/

Vérification du statut de déconnexion

Après la déconnexion, vérifions notre statut de connexion à l'aide de la commande docker info :

docker info

Recherchez à nouveau la section Registry. Elle ne devrait maintenant afficher que l'URL du registre sans aucune information de nom d'utilisateur :

Registry: https://index.docker.io/v1/

Vous pouvez également vérifier à nouveau le fichier de configuration Docker :

cat ~/.docker/config.json

Si vous étiez précédemment connecté, le fichier aurait été mis à jour pour supprimer les informations d'authentification pour le registre dont vous vous êtes déconnecté.

Comprendre l'authentification du registre Docker

Docker utilise l'authentification basée sur des jetons (token-based authentication) pour gérer l'accès aux registres. Lorsque vous vous connectez à un registre, Docker stocke le jeton d'authentification dans le fichier de configuration (~/.docker/config.json). Ce jeton est utilisé pour les interactions ultérieures avec le registre jusqu'à ce que vous vous déconnectiez ou que le jeton expire.

Comprendre comment vérifier votre statut de connexion et gérer votre authentification est essentiel pour des opérations Docker sécurisées, en particulier lorsque vous travaillez avec des registres privés.

Résumé

Dans ce laboratoire, vous avez acquis des compétences essentielles pour la gestion de l'authentification du registre Docker :

1. Vérification que Docker est correctement installé et en cours d'exécution
2. Utilisation de la commande docker info pour afficher des informations détaillées sur votre environnement Docker
3. Vérification de votre statut de connexion Docker à l'aide de la commande docker info
4. Compréhension du processus de connexion à Docker Hub
5. Déconnexion d'un registre Docker et vérification de la réussite de la déconnexion

Ces compétences sont fondamentales pour travailler avec Docker, en particulier lorsque vous devez interagir avec des registres privés ou protéger vos informations d'identification d'authentification.

Vous avez maintenant les connaissances nécessaires pour gérer en toute confiance votre statut de connexion Docker, garantissant des opérations Docker sécurisées et efficaces dans vos futurs projets.