Commandes sur les images

Description et scope

Les commandes liées aux images permettent de télécharger, construire, gérer, inspecter et supprimer des images.
Une image est le modèle (template) à partir duquel un ou plusieurs conteneurs peuvent être créés.


docker image ls / docker images

Liste toutes les images disponibles localement.

docker image ls

👉 Alias historique :

docker images

💡 Note historique
La forme hiérarchisée (docker image ls) est la syntaxe officielle.
L’alias (docker images) est encore largement utilisé dans la communauté.


docker image pull / docker pull

Télécharge une image depuis un registre (par défaut : Docker Hub).

docker image pull nginx:latest

👉 Alias historique :

docker pull nginx:latest

docker image build / docker build

Construit une image à partir d’un Dockerfile.

docker image build -t monimage:1.0 .

👉 Alias historique :

docker build -t monimage:1.0 .

💡 Note historique
La syntaxe hiérarchisée (docker image build) met en évidence qu’il s’agit d’une opération sur des images.
L’alias (docker build) est de loin le plus répandu dans la pratique.


docker image tag / docker tag

Assigne un nouveau tag à une image existante.

docker image tag monimage:1.0 monrepo/monimage:stable

👉 Alias historique :

docker tag monimage:1.0 monrepo/monimage:stable

docker image push / docker push

Envoie une image vers un registre (Docker Hub, GitHub Container Registry, etc.).

docker image push monrepo/monimage:stable

👉 Alias historique :

docker push monrepo/monimage:stable

Note pratique
Avant de pousser une image, il faut être authentifié (docker login).


docker image rm / docker rmi

Supprime une image locale.

docker image rm monimage:1.0

Alias historique :

docker rmi monimage:1.0

Supprimer plusieurs images en une fois :

docker image rm $(docker image ls -q)

⚠️ Une image ne peut être supprimée que si aucun conteneur ne l’utilise.


docker image inspect / docker inspect

Affiche les informations détaillées d’une image au format JSON.

docker image inspect nginx:latest

Alias générique :

docker inspect nginx:latest

Note historique
docker inspect est une commande générique qui fonctionne aussi pour les conteneurs, volumes et réseaux.
La syntaxe hiérarchisée (docker image inspect) est plus explicite et recommandée.


docker image history / docker history

Affiche l’historique des couches (layers) d’une image.

docker image history nginx:latest

Alias historique :

docker history nginx:latest

docker image prune

Supprime toutes les images inutilisées (dangling).

docker image prune

Supprimer toutes les images non utilisées par au moins un conteneur :

docker image prune -a

⚠️ Attention : commande destructive.