# Commandes sur les réseaux

## Description et scope
Les commandes liées aux réseaux permettent de créer, gérer, inspecter et supprimer des réseaux Docker.  
Les réseaux servent à connecter des conteneurs entre eux ou avec l’extérieur.

---

## `docker network ls`
Liste les réseaux disponibles sur le moteur Docker.

```bash
docker network ls
```

---

## `docker network create`
Crée un nouveau réseau utilisateur.

```bash
docker network create monreseau
```

Options utiles :  
- `--driver bridge` : réseau par défaut (bridge local)  
- `--driver overlay` : réseau distribué (Swarm/Kubernetes)  
- `--subnet x.x.x.x/size` : le sous-réseau alloué
- `--gateway x.x.x.x` : l'adresse de la passerelle
- `--internal` : restreint l'accès en local uniquement



Exemple :  
```bash
docker network create --driver bridge reseau_local
```

---

## `docker network connect`
Connecte un conteneur à un réseau existant.

```bash
docker network connect monreseau web
```

---

## `docker network disconnect`
Déconnecte un conteneur d’un réseau.

```bash
docker network disconnect monreseau web
```

---

## `docker network inspect`
Affiche les détails d’un réseau au format JSON.

```bash
docker network inspect monreseau
```

Exemple : afficher uniquement les conteneurs connectés à un réseau :  
```bash
docker network inspect -f '{{json .Containers}}' monreseau
```

---

## `docker network rm`
Supprime un réseau existant.

```bash
docker network rm monreseau
```

⚠️ Le réseau ne peut être supprimé que si aucun conteneur n’y est connecté.

---

## `docker network prune`
Supprime tous les réseaux inutilisés (non connectés à un conteneur).

```bash
docker network prune
```

⚠️ Commande destructive : supprime tous les réseaux non utilisés en une fois.

---

**Note historique**  
La syntaxe hiérarchisée (`docker network …`) est la seule disponible : il n’existe pas d’alias historiques comme pour les conteneurs et les images.