Interactieve shell openen in Docker Compose container
Gebruik docker compose exec voor een draaiende service of docker compose run voor een nieuwe container. Leer hoe u de juiste shell kiest en waarom -it vaak optioneel is.
Een interactieve shell verkrijgen met docker compose exec
docker compose exec web bash opent een interactieve shell in de container die al draait als de web service. De naam na exec is de servicenaam uit uw compose.yaml, niet de containernaam. Als de image geen bash bevat, vraag dan in plaats daarvan om sh.
docker compose ps
docker compose exec web bashVoer eerst docker compose ps uit. Dit hoort web weer te geven met de status running. Daarna brengt het tweede commando u naar een prompt binnen de container, en exit of Ctrl-D brengt u terug naar de host. De service blijft draaien nadat u de sessie verlaat, omdat exec een tweede proces start naast het hoofdproces. Het sluiten van uw shell heeft geen invloed op PID 1 (process id 1), het proces waarvoor de container is gebouwd.
Dit is een van de twee manieren om toegang te krijgen. exec koppelt aan een container die al bestaat. docker compose run maakt een nieuwe container aan op basis van dezelfde servicedefinitie. Vrijwel alles in deze handleiding vloeit voort uit dat ene verschil.
Waarom -it optioneel is in Compose, maar vereist bij standaard docker
Twee vlaggen bepalen het interactieve karakter van een sessie. -i houdt stdin open, zodat uw invoer het proces bereikt. -t wijst een pseudo-terminal toe, een TTY genaamd, waardoor de shell een prompt toont en pijltoetsen verwerkt. Standaard laat docker exec beide opties uitgeschakeld, wat de reden is dat elk voorbeeld dat u heeft gezien docker exec -it gebruikt. docker compose exec schakelt beide voor u in, waardoor docker compose exec -it web bash en docker compose exec web bash hetzelfde resultaat geven. Compose accepteert nog steeds -it, zodat oude gewoontes blijven werken.
U merkt binnen enkele seconden dat een TTY ontbreekt. De shell draait wel, maar toont geen prompt en Ctrl-C bereikt het proces niet. Het tegenovergestelde scenario, waarbij u Compose moet verzoeken om geen TTY toe te wijzen, heeft een eigen vlag en wordt verderop in een eigen sectie behandeld.
Wat te doen als de image geen bash bevat
Wanneer u een op Alpine gebaseerde image om bash vraagt en de exec-opdracht faalt als volgt:
OCI runtime exec failed: exec failed: unable to start container process: exec: "bash": executable file not found in $PATH: unknownDat bericht is geen exec-probleem. Het geeft aan dat bash niet is aangetroffen in de mappen die in de PATH van de container staan vermeld. Voor een shell betekent dit bijna altijd dat de image er geen bevat. Alpine levert BusyBox, dat ash aanbiedt als /bin/sh en helemaal geen bash. Vraag daarom om sh:
docker compose exec web shOp Debian en Ubuntu gebaseerde images, inclusief de -slim-tags, bevatten wel bash. Bash biedt u opdrachtgeschiedenis en betere aanvullingsmogelijkheden. Probeer daarom eerst bash en val terug op sh. sh is in bijna elke algemene image aanwezig.
Sommige images bevatten helemaal geen shell. Distroless-images en images die FROM scratch zijn gebouwd, bevatten enkel het applicatie-binary en de bijbehorende bibliotheken. Dit is een bewuste keuze: een shell die niet aanwezig is, kan niet tegen u worden gebruikt. In die gevallen faalt sh met hetzelfde bericht en is er niets meer te proberen. Twee benaderingen werken dan. De distroless-images van Google publiceren :debug-tags die een BusyBox-shell toevoegen, dus door tijdelijk van tag te wisselen krijgt u toegang. Of start een aparte container binnen de namespaces van het doel:
CID=$(docker compose ps -q web)
docker run --rm -it --network "container:$CID" --pid "container:$CID" nicolaka/netshootU beschikt nu over de tools van netshoot gericht op het netwerk van de applicatie, waardoor curl localhost:8080 en ss -lntp zich gedragen alsof u zich erin bevindt. Het bestandssysteem dat u ziet, is van netshoot en niet van de app. Omdat de proces-namespace wordt gedeeld, wijst /proc/1/root/ naar het bestandssysteem van het doelproces, maar ls /proc/1/root/ moet de ptrace-toestemmingscontrole van de kernel doorstaan. Dat beide processen als root draaien is onvoldoende: de controle kijkt ook naar credentials, capabilities, het dumpable-attribuut van het doel en beveiligingsmodules. Een dumpable-waarde anders dan 1 blokkeert de toegang, tenzij de aanroeper over CAP_SYS_PTRACE beschikt in de user-namespace van het doel. Docker verleent SYS_PTRACE niet standaard. Het toevoegen van --cap-add SYS_PTRACE aan de docker run-regel lost de controle op credentials en dumpability op, maar beveiligingsmodules kunnen de toegang alsnog weigeren.
Wanneer de service niet draait, gebruikt u docker compose run --rm
exec vereist een draaiende container. Richt u dit op een gestopte service, dan weigert het commando dienst:
service "web" is not runningHet zal niets voor u opstarten. docker compose run doet dat wel:
docker compose run --rm web bashrun maakt een nieuwe container aan op basis van de web service-definitie, met dezelfde image, omgeving, volumes en netwerken, en vervangt het commando van de service door het commando dat u heeft ingevoerd. --rm verwijdert die container zodra u afsluit. Laat u --rm weg, dan hopen de restanten zich op onder namen zoals myproject-web-run-4f1c2b. docker compose ps -a toont deze, en docker compose rm verwijdert ze samen met de andere gestopte containers van de service.
Twee gedragingen van run verrassen gebruikers vaak. Het publiceert de poorten van de service niet, tenzij u --service-ports toevoegt of handmatig een poort koppelt met -p. Dit is een bewuste keuze: een tweede container die hostpoort 8080 probeert te binden terwijl de eerste deze nog bezet houdt, zou falen met bind: address already in use. Het start ook alles wat de service onder depends_on vermeldt voordat uw shell verschijnt; een snelle blik in de container kan dus een database en een cache opstarten. --no-deps slaat dit over.
run doorloopt de ENTRYPOINT van de image, terwijl exec dat niet doet. exec start uw commando direct in de bestaande container, waardoor het entrypoint-script het commando nooit ziet. Bij run komt uw bash aan als argumenten voor dat script. Veel officiële images eindigen hun entrypoint met exec "$@", waardoor het commando direct wordt doorgegeven en u uw shell krijgt. Een script dat zijn eigen argumenten interpreteert, zal er echter iets anders mee doen. In dat geval vervangt u het entrypoint voor die specifieke run:
docker compose run --rm --entrypoint sh webDit is de meest voorkomende reden waarom een commando dat werkt onder exec zich anders gedraagt onder run, en het onderscheid tussen command en entrypoint legt uit welk deel van de image-configuratie u telkens vervangt.
exec of run: hoe maakt u de keuze
- exec vereist een draaiende container. run doet dit niet en kan afhankelijkheden starten.
- exec ziet de actieve proceslijst en de bestanden zoals ze op dit moment zijn, inclusief alles wat de applicatie sinds de start heeft geschreven. run krijgt een schone beschrijfbare laag van de image, maar named volumes en bind mounts tonen nog steeds de bestaande data van de service.
- exec slaat de entrypoint over. run voert deze uit.
- run laat een container achter tenzij u
--rmmeegeeft.
Gebruik exec om te bekijken wat er daadwerkelijk gebeurt. Gebruik run --rm voor een tijdelijke kopie van dezelfde omgeving, voor een eenmalig migratiecommando, of wanneer de eigenlijke service niet lang genoeg actief blijft om er met exec in te loggen.
Handige exec-vlaggen: gebruiker, werkmap en replica's
De meeste images schakelen over naar een niet-rootgebruiker, waardoor het installeren van diagnostische tools binnen uw exec-shell hier stopt:
E: Could not open lock file /var/lib/dpkg/lock-frontend - open (13: Permission denied)-u root geeft u een root-shell in dezelfde container:
docker compose exec -u root web sh-w /srv/app stelt de werkmap in voor uitsluitend dat commando. -e KEY=value voegt een omgevingsvariabele toe aan uw sessie en niet aan de service. Wanneer een service meer dan één replica draait, bepaalt --index 2 in welke container u terechtkomt. Als u onderzoekt wie de eigenaar is van bestanden in een gemounte map, behandelt PUID en PGID in container images waarom de numerieke id's, en niet de gebruikersnamen, bepalen wie daar schrijfrechten heeft.
Een psql- of mysql-shell openen in de databasecontainer
De client bevindt zich al in de database-image, dus u heeft er geen nodig op de host en u hoeft de poort niet te publiceren:
docker compose exec db psql -U postgres -d app
docker compose exec db mariadb -u root -pPostgres-images bevatten psql, MySQL-images bevatten mysql en MariaDB-images bevatten mariadb. De verbinding wordt van binnenuit de container gemaakt, dus dit werkt zelfs als het compose-bestand helemaal geen databasepoort publiceert. Dat is de veiligere opstelling op het standaard bridge-netwerk van Docker: externe hosts kunnen een niet-gepubliceerde databasepoort niet rechtstreeks bereiken, hoewel de Docker-host en containers op hetzelfde netwerk dit wel kunnen.
Eén valkuil kost mensen vaak een hele middag. Uw shell breidt variabelen op de host uit voordat Docker het commando ziet, waardoor -U "$POSTGRES_USER" een lege string verstuurt wanneer die variabele alleen in de container bestaat. Enkele aanhalingstekens en een shell in de container breiden deze op de juiste plek uit:
docker compose exec db sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB"'Gebruik hier niet docker compose run --rm db zonder commando. Dat start een tweede Postgres-server op hetzelfde datavolume, en die weigert te starten:
FATAL: lock file "postmaster.pid" already existsHet lock-bestand doet zijn werk, omdat twee servers die naar dezelfde datamap schrijven deze zouden beschadigen. Terwijl de database actief is, voert u een exec uit in de draaiende container. Of de database überhaupt in Compose thuishoort is een aparte beslissing, en het draaien van de database in Docker of op de host zet de afwegingen uiteen.
Services die bij het opstarten een console vereisen: stdin_open en tty
exec en run zijn bedoeld voor shells die u handmatig opent. Een service waarvan het hoofdproces van nature interactief is, heeft twee keys in het compose-bestand nodig:
services:
console:
image: python:3.12-slim
command: python
stdin_open: true
tty: truestdin_open: true staat voor docker run -i en tty: true staat voor docker run -t. Zonder deze instellingen start de container en stopt deze direct met code 0, waarna docker compose ps -a de melding Exited (0) toont. Er is niets gecrasht. python leest zonder terminal op stdin direct het einde van het bestand (EOF) en sluit normaal af; dit is het correcte gedrag voor een programma waar niemand invoer aan levert.
Wanneer beide keys zijn ingesteld, kunt u aan het draaiende proces koppelen:
docker attach $(docker compose ps -q console)Ontkoppel met Ctrl-P gevolgd door Ctrl-Q; het proces blijft hierbij draaien. Deze reeks werkt alleen wanneer de container zowel een TTY als een open stdin heeft. Ctrl-C stuurt daarentegen een interrupt (SIGINT) naar PID 1. Dit stopt de service alleen als het programma is geschreven om af te sluiten bij SIGINT, aangezien Linux geen standaard signaalafhandeling biedt voor PID 1. Gebruik dit dus niet om te ontkoppelen.
Laat beide keys uitgeschakeld voor normale services. Een webserver leest nooit van stdin, en tty: true zorgt ervoor dat veel programma's overschakelen naar kleurenuitslag en line buffering omdat ze aannemen dat er een gebruiker meekijkt, wat docker compose logs vult met escape-codes.
Waarom scripted exec faalt in cron en CI: de -T flag
Een exec-commando dat werkt in uw terminal kan falen wanneer een script het uitvoert, in een cron-job, een continuous integration (CI) runner, of een pipe:
the input device is not a TTYCompose vraagt om een pseudo-terminal wanneer de eigen output naar een terminal gaat, en het verzoek faalt voordat uw commando wordt uitgevoerd als stdin ook geen terminal is. Recente Docker CLI-broncode verwoordt dezelfde fout als cannot attach stdin to a TTY-enabled container because stdin is not a terminal. Huidige Compose-versies slaan het verzoek zelf over wanneer output wordt omgeleid of gepiped, zoals meestal het geval is bij cron. Sommige eerdere releases vroegen hier altijd om, en cat dump.sql | docker compose exec db psql getypt in uw eigen prompt triggert dit vandaag nog steeds. -T schakelt het verzoek in elk geval uit, dus gebruik dit in scripts in plaats van te vertrouwen op de automatische detectie:
0 3 * * * docker compose -f /srv/app/compose.yaml exec -T db pg_dump -U postgres -Fc app > /srv/backups/app.dump-T is om een tweede reden van belang. Een TTY herschrijft de bytestream tijdens het verzenden, waardoor een gecomprimeerde dump die erdoorheen gaat beschadigd aankomt. Geef -T expliciet mee voor elke omgeleide of gepipete output.
Nog twee details voor cron. Gebruik -f met een absoluut pad, omdat cron de job uitvoert vanuit de home-directory waar geen compose-bestand staat, waarna Compose stopt met no configuration file provided: not found. En exec retourneert de exit-code van het uitgevoerde commando, dus een falende pg_dump laat uw script falen onder set -e in plaats van een lege backup te schrijven en succes te rapporteren. De overige alledaagse commando's zijn verzameld in een spiekbriefje voor Compose-commando's dat nuttig is om bij die scripts te bewaren.
Waarom wijzigingen in een container verdwijnen
U installeert een tool via exec, bewerkt een configuratiebestand, lost het probleem op, en een week later is de wijziging verdwenen. Dit is de beschrijfbare laag van de container die werkt zoals ontworpen. docker compose up -d na een wijziging aan de image-tag of de service-definitie vernietigt de oude container en bouwt een nieuwe op basis van de image; elke handmatige aanpassing gaat verloren met de oude container.
docker compose restart werkt anders. Het stopt en start dezelfde container, waardoor handmatige aanpassingen behouden blijven. Daarom kan een handmatige fix wekenlang standhouden en vervolgens verdwijnen tijdens een niet-gerelateerde update. Named volumes en bind mounts overleven beide operaties, omdat hun data buiten de container leeft, en bind mounts en named volumes behandelt welke optie u moet kiezen voor data die u wilt behouden.
Beschouw een exec-shell daarom als een plek om te lezen en te testen. Zodra u de oplossing kent, verwerkt u deze op een plek waar deze behouden blijft: een pakket in de Dockerfile, een instelling in het compose-bestand. Voer daarna docker compose up -d uit om de wijziging toe te passen en bevestig met een nieuwe exec dat de nieuwe container de wijziging daadwerkelijk bevat.
FAQ
Wat is het verschil tussen docker compose exec en docker compose run?
exec voert een commando uit in een container die al draait, naast het hoofdproces, en slaat de entrypoint van de image over. run maakt een nieuwe container aan op basis van dezelfde servicedefinitie met dezelfde image, omgeving, volumes en netwerken, voert uw commando uit via de entrypoint en start eerst alle depends_on services. run publiceert de poorten van de service ook niet, tenzij u --service-ports toevoegt of een -p mapping gebruikt. Gebruik exec om een actieve service te inspecteren. Gebruik run --rm wanneer de service is gestopt of u een aparte container nodig heeft, maar onthoud dat named volumes en bind mounts gedeeld worden.
Waarom meldt docker compose exec dat de service niet draait?
exec koppelt aan een bestaande container en kan er geen aanmaken, dus een gestopte of gecrashte service geeft service "web" is not running. Controleer docker compose ps -a, waarin afgesloten containers met een status zoals Exited (1) worden vermeld, en lees docker compose logs web voor de reden van de stopzetting. Om toch een shell te krijgen, voert u docker compose run --rm --entrypoint sh web uit. Dat bouwt een nieuwe container op basis van dezelfde servicedefinitie zonder het defecte startcommando uit te voeren.
Hoe open ik een shell als de image geen bash bevat?
docker compose exec web bash dat faalt met exec: "bash": executable file not found in $PATH betekent dat er geen bash werd gevonden in de mappen op de PATH van de container, wat bijna altijd betekent dat de image deze niet bevat. Dat is normaal voor alles wat gebaseerd is op Alpine. Gebruik docker compose exec web sh, omdat BusyBox /bin/sh levert. In een image zonder shell kan exec geen shell openen, maar het voert nog steeds uitvoerbare bestanden uit die de image bevat. Schakel over naar de :debug tag van de image als de uitgever deze aanbiedt, of start een debug-container in de namespaces van het doel met docker run --rm -it --network "container:$CID" --pid "container:$CID" nicolaka/netshoot, waarbij $CID afkomstig is van docker compose ps -q web.
Waarom faalt mijn exec-commando met "the input device is not a TTY" in cron?
docker compose exec vraagt om een pseudo-terminal wanneer de uitvoer naar een terminal gaat, en het verzoek faalt als stdin ook geen terminal is. De huidige versie van Compose slaat het verzoek zelf over wanneer de uitvoer wordt omgeleid, zoals meestal gebeurt in cron, maar sommige eerdere releases vroegen er toch om, en het pipen van invoer naar exec vanuit een interactieve shell triggert dit ook. Voeg -T toe om dit uit te schakelen: docker compose exec -T db pg_dump -U postgres app. Gebruik -T ook voor elke omgeleide of gepipte uitvoer, aangezien een TTY de bytestroom wijzigt en een binaire dump beschadigt. Geef in cron ook -f mee met het absolute pad naar uw compose-bestand, anders sluit Compose af met no configuration file provided: not found.
Blijven wijzigingen die ik met exec in een container aanbreng behouden na een herstart?
Ze blijven behouden bij docker compose restart, waarbij dezelfde container wordt hergebruikt. Ze gaan verloren bij docker compose up -d na een wijziging in de image of configuratie, omdat de container dan opnieuw wordt aangemaakt op basis van de image en de beschrijfbare laag wordt verwijderd. Gegevens die naar named volumes of bind mounts zijn geschreven, overleven beide, aangezien deze buiten de container leven. Breng diagnostische wijzigingen aan met exec en verwerk de permanente versie vervolgens in de Dockerfile of het compose-bestand.