Vérifier l'installation : la commande `docker run hello-world`

Confirmer que Docker est prêt à l'emploi

Avoir terminé le processus d'installation de Docker Desktop ou Docker Engine est une étape majeure, mais comment être certain que tout fonctionne correctement ? Simplement voir une icône ou un service démarré ne garantit pas que Docker peut réellement exécuter sa fonction principale : télécharger des images et lancer des conteneurs. Il est donc crucial d'effectuer une vérification active.

Heureusement, Docker fournit une méthode standard et très simple pour tester les fonctionnalités de base de votre installation. Cette méthode utilise une image spécialement conçue, nommée `hello-world`, dont le seul but est d'afficher un message confirmant que votre environnement Docker est opérationnel. L'exécution de cette image teste plusieurs composants clés de la chaîne Docker en une seule commande.

Exécuter votre premier conteneur : hello-world

Pour effectuer cette vérification, vous aurez besoin d'accéder à votre interface de ligne de commande. Ouvrez le Terminal sur macOS ou Linux. Sur Windows, ouvrez PowerShell ou l'Invite de commandes (cmd). Si vous avez installé Docker Desktop, celui-ci doit être en cours d'exécution (l'icône de baleine doit être visible et stable). Sur Linux, le service Docker (daemon) doit être actif.

Une fois votre terminal ouvert, tapez la commande suivante et appuyez sur Entrée :

docker run hello-world

Lorsque vous exécutez cette commande, plusieurs actions se produisent en arrière-plan, orchestrées par le moteur Docker :

1. Le client Docker (la commande `docker` que vous avez tapée) contacte le démon Docker (le service en arrière-plan).
2. Le démon recherche l'image `hello-world` sur votre machine locale.
3. Comme c'est probablement la première fois que vous l'utilisez, l'image ne sera pas trouvée localement.
4. Le démon contacte alors le registre d'images par défaut, Docker Hub, et télécharge (pull) l'image `hello-world`. Vous verrez probablement des lignes indiquant le téléchargement.
5. Une fois l'image téléchargée, le démon crée un nouveau conteneur à partir de cette image.
6. Le démon exécute la commande spécifiée dans l'image `hello-world`, qui consiste simplement à afficher un message informatif dans votre terminal.
7. Une fois le message affiché, le conteneur a terminé sa tâche et s'arrête.

Comprendre la sortie de la commande

Si votre installation Docker fonctionne correctement, vous devriez voir un message apparaître dans votre terminal, commençant par quelque chose comme :

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

Le message continue ensuite en expliquant brièvement les étapes que Docker a suivies pour l'afficher (connexion au démon, téléchargement de l'image, exécution dans un conteneur). Voir ce message est la confirmation que votre installation Docker est fonctionnelle. Cela signifie que le client peut communiquer avec le démon, que le démon peut télécharger des images depuis Docker Hub et qu'il peut créer et exécuter des conteneurs.

Si vous ne voyez pas ce message et obtenez une erreur à la place, cela indique un problème dans votre installation. Les erreurs courantes incluent :

• Le démon Docker n'est pas démarré (vérifiez l'état de Docker Desktop ou du service `docker` sur Linux).
• Des problèmes de connexion réseau empêchent le téléchargement de l'image depuis Docker Hub (vérifiez votre connexion internet et les éventuels pare-feux ou proxys).
• Sur Linux, des problèmes de permissions si vous n'avez pas ajouté votre utilisateur au groupe `docker` et n'utilisez pas `sudo`.

Félicitations ! Si vous avez vu le message "Hello from Docker!", votre environnement est prêt. Cette simple commande valide que les mécanismes fondamentaux sont en place, vous permettant de passer à des opérations plus complexes avec confiance.