# 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.

```bash
docker image ls
```

👉 Alias historique :

```bash
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).

```bash
docker image pull nginx:latest
```

👉 Alias historique :

```bash
docker pull nginx:latest
```

---

## `docker image build` / `docker build`
Construit une image à partir d’un Dockerfile.

```bash
docker image build -t monimage:1.0 .
```

👉 Alias historique :

```bash
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.

```bash
docker image tag monimage:1.0 monrepo/monimage:stable
```

👉 Alias historique :

```bash
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.).

```bash
docker image push monrepo/monimage:stable
```

👉 Alias historique :

```bash
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.

```bash
docker image rm monimage:1.0
```

Alias historique :

```bash
docker rmi monimage:1.0
```

Supprimer plusieurs images en une fois :  
```bash
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.

```bash
docker image inspect nginx:latest
```

Alias générique :

```bash
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.

```bash
docker image history nginx:latest
```

Alias historique :

```bash
docker history nginx:latest
```

---

## `docker image prune`
Supprime toutes les images inutilisées (dangling).

```bash
docker image prune
```

Supprimer toutes les images non utilisées par au moins un conteneur :  
```bash
docker image prune -a
```

⚠️ Attention : commande destructive.

---