Hard-Drive

🐳 Docker Cheatsheet : gĂ©rer et transfĂ©rer des images (import / export)

Introduction

Dans certains contextes (environnements isolĂ©s, serveurs sans accĂšs Internet, migration d’infrastructure), il est nĂ©cessaire de transfĂ©rer des images Docker manuellement.

Cette cheatsheet regroupe les commandes essentielles pour :

  • tĂ©lĂ©charger une image
  • l’exporter en fichier
  • la transfĂ©rer
  • la recharger sur un autre serveur

Télécharger une image Docker

Récupérer une image depuis un registry

docker pull <image_name>:<tag>

Exemple :

docker pull nginx:latest

TĂ©lĂ©charge l’image depuis Docker Hub (ou un registry privĂ©)

Exporter une image Docker

Sauvegarder une image en fichier (.tar)

docker save -o <output_file>.tar <image_name>:<tag>

Exemple :

docker save -o nginx.tar nginx:latest

Permet de :

  • sauvegarder une image
  • la transfĂ©rer sur un autre serveur
  • archiver une version spĂ©cifique

Export avec compression (recommandé)

docker save nginx:latest | gzip > nginx.tar.gz

RĂ©duit la taille du fichier pour le transport

Importer une image Docker

Charger une image depuis un fichier

docker load -i <image_file>.tar

Exemple :

docker load -i nginx.tar

Import depuis un fichier compressé

gunzip -c nginx.tar.gz | docker load

Pratique pour les transferts via SCP / stockage externe

VĂ©rifier les images disponibles

docker images

Liste toutes les images présentes localement

Tagger une image (avant export)

docker tag <image_name>:<tag> <new_name>:<tag>

Exemple :

docker tag nginx:latest myrepo/nginx:v1

Utile pour :

  • renommer une image
  • prĂ©parer un push vers un registry privĂ©

Supprimer une image locale

docker rmi <image_name>:<tag>

Permet de libĂ©rer de l’espace disque

Cas d’usage concrets

Environnement sans Internet (air-gapped)

  1. TĂ©lĂ©charger l’image sur une machine connectĂ©e
  2. Exporter avec docker save
  3. Transférer via SCP / USB
  4. Importer avec docker load

Migration de serveur

  • Export des images existantes
  • Transfert vers le nouveau serveur
  • Rechargement sans dĂ©pendance externe

Backup / archivage

  • Sauvegarder des versions critiques d’images
  • Revenir rapidement Ă  un Ă©tat stable

Bonnes pratiques

  • Utiliser des tags explicites (v1.2, prod, etc.)
  • Compresser les images pour les transferts
  • Nettoyer rĂ©guliĂšrement les images inutilisĂ©es
  • VĂ©rifier l’intĂ©gritĂ© aprĂšs import (docker images)
  • Centraliser via un registry privĂ© si possible

Aller plus loin

Nettoyer les images inutilisées

docker image prune -a

Inspecter une image

docker inspect <image_name>

Historique d’une image

docker history <image_name>

Conclusion

La gestion des images Docker en local est une compétence essentielle pour tout environnement DevOps ou infrastructure maßtrisée.

Les commandes docker pull, docker save et docker load permettent de contrĂŽler entiĂšrement le cycle de vie des images, mĂȘme sans accĂšs Ă  un registry.