docker exec -it ouvre un shell interactif dans un conteneur déjà en cours d'exécution : -i garde l'entrée standard ouverte et -t alloue un terminal. En production, commencez par sh si vous ne savez pas ce que contient l'image, définissez l'utilisateur avec -u et le répertoire avec --workdir, et ne modifiez rien qui ne survivrait pas à une recréation.
docker exec -it : syntaxe minimale et rôle de chaque option
La forme de base est docker exec [options] CONTAINER COMMAND, et la commande s'exécute dans le conteneur existant au lieu d'en créer un nouveau. Trouvez d'abord le nom exact, puis entrez :
docker ps
docker exec -it api sh
# With Docker Compose, by service name
docker compose exec api sh-i relie votre entrée standard au processus et -t lui fournit un pseudo-terminal ; sans -t, vous n'avez ni invite ni édition de ligne. docker compose exec alloue un terminal par défaut et -T le désactive, ce qui convient aux scripts. Si le conteneur est coincé dans une boucle de redémarrage, exec échouera : consultez d'abord docker logs --tail 100 api.
sh ou bash dans docker exec : comment savoir quel shell l'image contient
Beaucoup d'images minimales, comme celles basées sur Alpine, contiennent sh mais pas bash, et les images distroless ne contiennent aucun shell. Demandez bash là où il n'existe pas et Docker renvoie une erreur d'exécutable introuvable dans le $PATH. Vérifiez au lieu de deviner :
docker exec api sh -c 'command -v bash || echo no-bash'
# Use bash if present, otherwise stay in sh
docker exec -it api bash
docker exec -it api shsh est le choix sûr par défaut : il fonctionne presque toujours, et lire des logs ou vérifier une configuration ne nécessite pas d'autocomplétion sophistiquée. N'installez pas bash avec le gestionnaire de paquets dans le conteneur par confort ; cette installation disparaît au prochain déploiement. Si l'image n'a pas de shell, docker cp fonctionne toujours, vous pouvez donc extraire les fichiers et les lire sur l'hôte.
Utilisateur dans docker exec : -u, root et fichiers au mauvais propriétaire
docker exec s'exécute par défaut avec le même utilisateur que le processus principal du conteneur, c'est-à-dire le USER de l'image ou le --user avec lequel il a été créé. Vérifiez qui vous êtes avant de toucher à quoi que ce soit :
docker inspect --format '{{.Config.User}}' api
docker exec api id
# Root only for what strictly needs it
docker exec -it -u 0 api sh
# Same UID:GID as the application
docker exec -it -u 1000:1000 api shUne chaîne vide renvoyée par docker inspect signifie que le conteneur tourne en root. Le vrai risque de -u 0 n'est pas seulement la sécurité : un fichier créé en root dans un volume partagé peut empêcher l'application, qui tourne sous un autre UID, d'y écrire plus tard. Règle de travail : lisez avec l'utilisateur de l'application, passez en root pour une action précise, et ressortez aussitôt.
--workdir dans docker exec : ouvrir le shell dans le répertoire qui compte
-w ou --workdir définit le répertoire de travail de la commande ; sans cette option, docker exec démarre dans le WORKDIR de l'image. Combiné à -u, il élimine l'erreur classique du mauvais cd :
docker exec -it -w /var/log/nginx web sh
# One-off command, no interactive shell
docker exec -w /app api ls -la
# User and directory together
docker exec -it -u www-data -w /var/www/html web shLes vérifications en une ligne n'ont pas besoin de -it : un docker exec sans terminal affiche la sortie et se termine, ce qui permet de le relancer facilement et de le coller dans un rapport d'incident.
Modifications faites avec docker exec qui ne survivent pas à la recréation du conteneur
Tout ce qui est écrit hors d'un volume atterrit dans la couche inscriptible du conteneur, et docker compose up -d --force-recreate ou tout nouveau déploiement supprime cette couche. Un simple docker restart la conserve, ce qui donne à un correctif à chaud l'apparence d'une solution permanente alors qu'il ne l'est pas. Avant de partir, passez en revue ce que vous avez touché :
# A = added, C = changed, D = deleted
docker diff api
# Paths that do persist (volumes and bind mounts)
docker inspect --format '{{range .Mounts}}{{.Destination}} {{end}}' api
# Take a copy before you start poking
docker cp api:/app/config/settings.yml ./settings.yml- N'installez pas de paquets pour déboguer ; ils disparaissent et modifient l'image que vous croyez exécuter.
- Ne modifiez pas la configuration dans le conteneur ; corrigez-la dans l'image, le fichier compose ou le volume.
- N'exécutez pas chmod ou chown hors d'un volume ; la prochaine recréation les annule sans prévenir.
- Ne tuez pas le PID 1 ; quand le processus principal meurt, tout le conteneur s'arrête.
docker exec -it depuis un téléphone ou un ordinateur : ce qui change
Entrer dans un conteneur depuis un téléphone exige deux choses qu'un ordinateur tient pour acquises : des touches comme Ctrl et Tab, et une session qui résiste aux déplacements. Voici la comparaison :
| Besoin pendant docker exec | Ordinateur | Téléphone avec termi1 |
|---|---|---|
| Ctrl+C, Ctrl+D, Tab et flèches | Clavier physique | Clavier dédié avec Esc, Ctrl, Tab et flèches |
| Changement de réseau | En SSH, le shell ouvert est perdu | Mosh conserve la session lors du passage du wifi aux données mobiles |
| Tâches longues sur l'hôte | tmux, configuré à la main | tmux : ce que vous laissez tourner est toujours là |
| Télécharger un fichier extrait avec docker cp | scp ou sftp dans une autre fenêtre | SFTP intégré sans quitter la session |
| Saisir la commande | À la main ou depuis l'historique | L'IA la tape à l'invite sans appuyer sur Entrée |
Sur une connexion marquée comme production, le Production Guard de termi1, le terminal SSH mobile n'envoie jamais Entrée automatiquement et retient tout ce qui supprime, arrête ou modifie quelque chose avant que cela n'atteigne l'invite, si bien qu'un docker exec avec -u 0 ne part jamais tout seul. L'IA n'ouvre pas la session et ne reçoit pas les clés, et la clé privée SSH ne quitte jamais le téléphone. Vous pouvez l'obtenir via l'application termi1 sur Google Play ; d'autres guides serveur sont disponibles sur le blog technique de termi1.
Questions fréquentes
Pourquoi docker exec -it ne trouve-t-il pas bash dans le conteneur ?
docker exec -it ne trouve pas bash parce que de nombreuses images minimales, comme celles basées sur Alpine, n'incluent que sh, et que les images distroless n'incluent aucun shell. Lancez plutôt docker exec -it conteneur sh et, en l'absence de shell, extrayez les fichiers avec docker cp pour les inspecter sur l'hôte.
Comment obtenir un shell root dans un conteneur avec docker exec ?
Un shell root avec docker exec s'obtient avec -u 0, par exemple docker exec -it -u 0 api sh. Limitez-le à une action précise : les fichiers que vous créez en root dans un volume peuvent devenir impossibles à modifier pour l'application, qui tourne généralement sous un autre UID.
Les modifications faites avec docker exec sont-elles perdues au redémarrage du conteneur ?
Les modifications faites avec docker exec hors d'un volume survivent à docker restart, mais elles sont perdues quand le conteneur est recréé avec docker compose up -d --force-recreate ou par un nouveau déploiement. docker diff liste les fichiers que vous avez ajoutés, modifiés ou supprimés dans la couche inscriptible.
Quelle est la différence entre docker exec et docker attach ?
docker exec lance un nouveau processus dans le conteneur, tandis que docker attach se connecte à l'entrée et à la sortie du processus principal. Avec attach, un Ctrl+C peut atteindre le processus principal et arrêter le conteneur ; docker exec est donc le choix prudent pour inspecter la production.