====== Mémo commandes Docker & Docker Compose ======

**Documentation rédigée par :** GADONNAUD Ewen

**Formation :** BTS SIO 1ère année - Option SISR

**Établissement :** Lycée Paul-Louis Courier, Tours

**Date :** Mars 2026

{{ :wiki:logo.png?150 |Logo PLC-SIO}}

===== 1. Docker — Conteneurs =====

**Lister les conteneurs**
<code bash>
docker ps          # Conteneurs en cours d'exécution
docker ps -a       # Tous les conteneurs (y compris arrêtés)
</code>

**Démarrer / arrêter / redémarrer**
<code bash>
docker start searxng
docker stop searxng
docker restart searxng
</code>

**Supprimer un conteneur**
<code bash>
docker rm searxng           # Conteneur arrêté
docker rm -f searxng        # Force la suppression même si actif
</code>

**Exécuter une commande dans un conteneur actif**
<code bash>
docker exec -it searxng bash        # Ouvre un shell interactif
docker exec searxng ls /etc/searxng # Commande one-shot
</code>

**Consulter les logs**
<code bash>
docker logs searxng
docker logs searxng --tail 50       # 50 dernières lignes
docker logs searxng -f              # Suivi en temps réel
</code>

**Inspecter un conteneur**
<code bash>
docker inspect searxng              # Détails complets (réseau, volumes, config...)
docker stats                        # Consommation CPU/RAM en temps réel
</code>

===== 2. Docker — Images =====

**Lister les images locales**
<code bash>
docker images
</code>

**Télécharger une image**
<code bash>
docker pull searxng/searxng:latest
</code>

**Supprimer une image**
<code bash>
docker rmi searxng/searxng:latest
</code>

**Mettre à jour une image**
<code bash>
docker pull searxng/searxng:latest   # Récupère la nouvelle version
docker compose up -d                 # Recrée le conteneur avec la nouvelle image
</code>

===== 3. Docker — Volumes =====

**Lister les volumes**
<code bash>
docker volume ls
</code>

**Inspecter un volume (chemin réel sur l'hôte)**
<code bash>
docker volume inspect searxng_searxng-cache
</code>

**Supprimer les volumes orphelins**
<code bash>
docker volume prune
</code>

===== 4. Docker — Nettoyage =====

**Supprimer toutes les ressources inutilisées (conteneurs arrêtés, images sans tag, volumes orphelins)**
<code bash>
docker system prune           # Avec confirmation
docker system prune -a        # Inclut aussi les images non utilisées
docker system prune --volumes # Inclut les volumes (attention, irréversible)
</code>

**Voir l'espace disque utilisé par Docker**
<code bash>
docker system df
</code>

===== 5. Docker Compose — Gestion des services =====

Les commandes suivantes s'exécutent depuis le dossier contenant le ''docker-compose.yml''.

**Démarrer les services**
<code bash>
docker compose up -d          # Démarre en arrière-plan
docker compose up             # Démarre avec logs dans le terminal
</code>

**Arrêter les services**
<code bash>
docker compose down           # Arrête et supprime les conteneurs
docker compose down -v        # Idem + supprime les volumes associés
docker compose stop           # Arrête sans supprimer les conteneurs
</code>

**Redémarrer**
<code bash>
docker compose restart
docker compose restart searxng   # Redémarre un service spécifique
</code>

**Voir l'état des services**
<code bash>
docker compose ps
</code>

**Consulter les logs**
<code bash>
docker compose logs
docker compose logs -f           # Suivi en temps réel
docker compose logs searxng      # Logs d'un service spécifique
</code>

**Forcer la recréation des conteneurs (après modif du docker-compose.yml)**
<code bash>
docker compose up -d --force-recreate
</code>

**Mettre à jour les images et recréer les conteneurs**
<code bash>
docker compose pull              # Télécharge les nouvelles versions des images
docker compose up -d             # Recrée les conteneurs avec les nouvelles images
</code>

===== 6. Structure d'un docker-compose.yml =====

Un fichier ''docker-compose.yml'' se compose de plusieurs sections de niveau racine. Voici la structure complète avec les options les plus courantes :

<code yaml>
version: '3'              # Version du format Compose

services:                 # Définition des conteneurs
  nom_du_service:
    image: image:tag      # Image Docker à utiliser
    container_name: nom   # Nom explicite du conteneur (optionnel)
    build: ./dossier      # Alternative à image : build depuis un Dockerfile
    
    ports:
      - "port_hote:port_conteneur"   # Ex: "8085:8080"
    
    volumes:
      - ./dossier_local:/chemin/conteneur        # Volume lié (bind mount)
      - ./fichier.yml:/etc/service/fichier.yml   # Fichier spécifique
      - nom_volume:/chemin/conteneur             # Volume nommé
    
    environment:          # Variables d'environnement
      - MA_VARIABLE=valeur
      - AUTRE_VAR=valeur
    
    env_file:             # Alternative : charger depuis un fichier .env
      - .env
    
    networks:             # Réseaux auxquels le service est connecté
      - mon_reseau
    
    depends_on:           # Ordre de démarrage
      - autre_service
    
    restart: unless-stopped   # Politique de redémarrage
    # always              → redémarre toujours
    # on-failure          → redémarre uniquement en cas d'erreur
    # unless-stopped      → redémarre sauf si arrêté manuellement
    # no                  → ne redémarre jamais
    
    dns:                  # Serveurs DNS explicites
      - 1.1.1.1
      - 8.8.8.8

volumes:                  # Déclaration des volumes nommés
  nom_volume:             # Docker gère le stockage automatiquement
  autre_volume:
    external: true        # Volume créé manuellement en dehors de Compose

networks:                 # Déclaration des réseaux personnalisés
  mon_reseau:
    driver: bridge        # bridge = réseau local entre conteneurs (défaut)
</code>

**Les politiques de redémarrage en pratique**

^ Valeur ^ Comportement ^ Cas d'usage ^
| ''no'' | Ne redémarre jamais | Conteneurs de test |
| ''always'' | Redémarre toujours, même après un ''docker stop'' | Services critiques |
| ''unless-stopped'' | Redémarre sauf si arrêté manuellement | Homelab (recommandé) |
| ''on-failure'' | Redémarre uniquement si code d'erreur non nul | Jobs ponctuels |

**Bind mount vs Volume nommé**

^ Type ^ Syntaxe ^ Quand l'utiliser ^
| Bind mount | ''./local:/conteneur'' | Fichiers de config à éditer directement sur l'hôte |
| Volume nommé | ''nom:/conteneur'' | Données persistantes gérées par Docker (BDD, cache) |

===== 7. Cas pratiques homelab =====

**Redémarrer SearXNG après modification de settings.yml**
<code bash>
cd /opt/searxng
docker compose restart
</code>

**Vérifier que le cache favicons a bien été créé**
<code bash>
docker exec searxng ls -la /var/cache/searxng
</code>

**Voir les logs de SearXNG en temps réel**
<code bash>
cd /opt/searxng
docker compose logs -f
</code>

**Accéder au shell d'un conteneur pour déboguer**
<code bash>
docker exec -it searxng sh    # SearXNG utilise sh et non bash (image Alpine)
</code>

**Vérifier la résolution DNS depuis l'intérieur d'un conteneur**
<code bash>
docker exec searxng nslookup google.com
</code>