Docker Compose build vs image: wat is het verschil?
Begrijp waarom Docker Compose uw Dockerfile wijzigingen negeert op een VPS. Leer het verschil tussen de image en build keys en hoe u uw containers correct bijwerkt.
Docker Compose build versus image: het korte antwoord
In een Docker Compose-bestand identificeert image: de te gebruiken image, inclusief een lokale image, een tag of een digest-referentie, en vertelt build: aan Compose hoe een image vanuit de broncode moet worden gebouwd. Stel alleen image: in en Compose gebruikt of downloadt de image volgens pull_policy. Stel alleen build: in en Compose bouwt de image met de geconfigureerde builder, waarbij het een naam krijgt die is afgeleid van de projectnaam en de servicenaam. Stel beide in en pull_policy bepaalt of Compose de image downloadt of bouwt; wanneer het bouwt, voorziet het het resultaat van de tag met de naam in image:. Dit is hoe u een image bouwt en pusht onder een door u gekozen naam. De builder kan lokaal of op een externe Docker-host draaien.
Dat is het volledige onderscheid. Alles hieronder beschrijft wat dit betekent in de praktijk op een server. Dit gaat ervan uit dat Docker Engine en de Compose-plugin al zijn geïnstalleerd; Docker draaien op een VPS behandelt dat onderdeel.
De drie vormen volledig
Gebruik een gepubliceerde tag en haal deze op als deze ontbreekt onder het standaard pull-beleid. Er komt op geen enkel moment een Dockerfile aan te pas.
services:
web:
image: nginx:1.27
restart: unless-stopped
ports:
- "80:80"Bouw vanuit een Dockerfile in de projectmap. De build kan ook images ophalen en afhankelijkheden downloaden die door de Dockerfile worden vereist.
services:
web:
build: .
restart: unless-stopped
ports:
- "80:80"Bouw en tag het resultaat met docker compose build; zonder expliciet pull-beleid probeert up dit image op te halen voordat het wordt gebouwd. docker compose push kan vervolgens die exacte tag naar een registry sturen.
services:
web:
build:
context: .
dockerfile: Dockerfile
image: registry.example.com/acme/web:1.4.2
restart: unless-stopped
ports:
- "80:80"context is de map die naar de builder wordt verzonden. dockerfile wordt relatief ten opzichte van die context opgelost, dus context: . met dockerfile: docker/prod.Dockerfile is normaal en correct. Voer docker compose images uit om de image-naam en het image ID achter elke servicecontainer te zien; controleer het Compose-bestand om te bevestigen of de service image:, build: of beide gebruikt.
Waarom voert docker compose up geen rebuild uit nadat ik het Dockerfile heb gewijzigd?
Omdat een standaard up een bestaande image hergebruikt, tenzij u expliciet om een build vraagt of een beleid configureert dat dit vereist.
Wanneer Compose een service start die alleen een build:-sectie bevat, gebruikt het de bestaande image als deze beschikbaar is. Het leest uw Dockerfile niet, vergelijkt uw bronbestanden niet en kijkt niet naar tijdstempels. Bij zowel image: als build: en zonder expliciete pull_policy, probeert Compose eerst te pullen en bouwt het alleen als de image niet beschikbaar is in de registry of de platform-cache. Aanwezigheid wordt als voldoende beschouwd.
U past dus app.py aan, voert docker compose up -d uit, ziet dat Compose meldt dat de container draait, en serveert de oude code. Er is niets mislukt, dus er is geen waarschuwing gegeven. De aanwijzing is het statuswoord dat Compose naast de containernaam print: een container die door Compose is vervangen, wordt gerapporteerd als recreated of started, terwijl een container die Compose ongemoeid laat, wordt gerapporteerd als running.
Twee controles bieden uitsluitsel. docker compose images toont het image-ID dat elke container gebruikt; noteer dit vóór de deploy en vergelijk het daarna. docker image ls heeft een CREATED-kolom, maar gecachte builds en reproduceerbare tijdstempels betekenen dat die datum alleen niet bewijst of uw nieuwste broncode daadwerkelijk is gebouwd.
Welke vlaggen forceren een rebuild
docker compose up -d --buildbouwt eerst en maakt vervolgens elke container opnieuw aan waarvan de image is gewijzigd. Dit is de vlag waar de meeste gebruikers naar op zoek zijn.docker compose build webbouwt één service en start niets op. Gebruik daarnadocker compose up --no-deps -d webom alleen die container te vervangen en de rest van de stack draaiende te houden.docker compose build --no-cache webomzeilt gecachte lagen en herbouwt de service.docker compose build --pullprobeert een nieuwere versie van de base image inFROMop te halen, zodat een bewegende tag zoalsnode:22de huidige inhoud ophaalt in plaats van de kopie die u in maart hebt gedownload.docker compose up -d --force-recreateforceert het opnieuw aanmaken van containers, zelfs als de configuratie en de image niet zijn gewijzigd. De vlag zelf verzoekt niet om een build, maarupkan nog steeds bouwen wanneer een image ontbreekt of het pull-beleid dit vereist. Deze vlag gebruiken terwijl u eigenlijk--buildbedoelde, is een veelvoorkomend doodlopend spoor.
U kunt de beslissing ook in het bestand verplaatsen. Volgens de Compose-specificatie betekent pull_policy: build dat Compose de image bouwt, en deze opnieuw bouwt als deze al aanwezig is. Elke up resulteert dan in een build, wat gewenst is op een laptop, maar zelden op een server.
services:
web:
build: .
image: registry.example.com/acme/web:dev
pull_policy: buildEén interactie is nog belangrijk om te weten. docker compose pull probeert ook images op te halen voor services die een build-sectie hebben; als die pull mislukt, krijgt u de melding dat de image in plaats daarvan moet worden gebouwd. Gebruik --ignore-buildable om die services geruisloos over te slaan.
Hoe de build-cache uw deploy-tijd bepaalt
De builder controleert elke Dockerfile-instructie op een herbruikbaar cache-resultaat wanneer die instructie en de bijbehorende inputs ongewijzigd zijn. Voor COPY omvatten de inputs de bestandsinhoud en metadata, met uitzondering van wijzigingstijden. Zodra één laag de cache mist, worden de daaropvolgende stappen die ervan afhankelijk zijn opnieuw gebouwd.
Die ene regel bepaalt of uw deploy seconden of minuten duurt. Orden de Dockerfile van wat zelden verandert naar wat bij elke commit verandert.
FROM node:22-slim
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
CMD ["node", "server.js"]npm ci staat boven COPY . ., waardoor het bewerken van een bronbestand de installatielaag in de cache laat staan en de build hervat bij de copy-stap. Wissel deze twee regels om en een wijziging van één teken zorgt ervoor dat elke afhankelijkheid opnieuw wordt geïnstalleerd, omdat COPY . . de laag ongeldig maakt waarop npm ci is gebouwd. Hetzelfde principe geldt voor pip install -r requirements.txt en voor go mod download.
--no-cache is het juiste hulpmiddel wanneer u vermoedt dat een verouderde laag uw correctie verbergt. Het is een slechte standaardinstelling, omdat het de herbruikbaarheid weggooit die de Dockerfile-volgorde juist moet opleveren.
Eén ding dat de image instelt en Compose kan overschrijven: de CMD van de Dockerfile is wat de image standaard uitvoert, en een command:-sleutel in de service vervangt dit. Hoe command en entrypoint op elkaar inwerken is hier van belang, omdat een Compose-overschrijving ervoor kan zorgen dat een vers gebouwde image zich exact hetzelfde gedraagt als de oude.
Build-context en .dockerignore
context: . stelt de projectmap beschikbaar aan de builder. Zonder uitsluitingen bevat dit ook .git en elke gegevensmap die u naast uw broncode bewaart, hoewel BuildKit ongebruikte bestanden overslaat en wijzigingen incrementeel overdraagt. Een build die pauzeert bij de stap transferring-context van een verder ongewijzigd project, geeft aan dat de context te groot is.
Een .dockerignore-bestand in de root van de context sluit paden uit van die overdracht. De syntaxis is vergelijkbaar met .gitignore.
.git
node_modules
*.log
data/
.envDit levert twee voordelen op. De overdracht wordt kleiner, waardoor er minder tijd wordt besteed aan het verzenden van die bestanden. Bovendien kan COPY . . niet langer .env naar de image kopiëren, waar iedereen die de image ophaalt deze weer kan uitlezen.
Het geval van een trage build die in de loop van de tijd groeit, is een bind mount. Een named volume bevindt zich buiten uw projectmap, maar een bind mount zoals ./data:/var/lib/postgresql/data bevindt zich binnen de build-context, waardoor uw builds elke week trager worden naarmate de database groeit. Eén regel in .dockerignore lost dit op. Bind mounts versus named volumes behandelt de bredere afweging.
Build-argumenten dragen een kleinere versie van hetzelfde risico met zich mee. Waarden die worden doorgegeven via args: kunnen in de image-geschiedenis of herkomst-metadata blijven staan, dus plaats daar een versienummer en nooit een token. Vooraf gedefinieerde proxy-argumenten worden standaard uitgesloten van de build-cache en docker history, tenzij ze expliciet worden vermeld in de Dockerfile. Env-bestanden en secrets in Compose behandelt waar inloggegevens in plaats daarvan thuishoren.
Moet u bouwen op de VPS of elders bouwen en pushen?
Bouwen op de server die uw verkeer afhandelt is de standaardmethode omdat dit de kortste route is: git pull, gevolgd door docker compose up -d --build. Dit is acceptabel op een kleine server waar nog niemand afhankelijk van is. Het wordt problematisch om twee redenen die u kunt meten en één reden die pas op een slecht moment aan het licht komt.
Geheugen. Een buildproces voert compilers en bundlers uit naast uw actieve applicatie; dit zijn de meest geheugenintensieve onderdelen van de meeste stacks. Een JavaScript-bundler of een Rust-compilatie kan het beschikbare geheugen op een 1 GB VPS volledig verbruiken. Bij geheugenuitputting selecteert de kernel een OOM-slachtoffer op basis van een 'badness score', die afhangt van het geheugengebruik, de allocatiecontext en oom_score_adj; het proces dat het meeste geheugen gebruikt wordt niet per se als eerste beëindigd. De build kan stoppen met Killed en exit-status 137, of uw database kan worden beëindigd, waardoor de site tijdens een deploy onbereikbaar wordt. dmesg -T | grep -i oom doorzoekt het kernellogboek op OOM-meldingen; voor toegang is toestemming vereist om dit logboek te lezen.
Schijfruimte. Builds laten image-layers en build-caches achter. docker system df toont het schijfgebruik hiervan; de periodieke garbage collection van BuildKit ruimt de cache op volgens de geconfigureerde regels. Gebruik docker image prune voor zwevende images en docker builder prune voor gecachte layers om ruimte vrij te maken. Een volle schijf stopt meer dan alleen de build. Ook de database kan niet meer schrijven, en die uitval kost aanzienlijk meer dan een trage deploy.
Reproduceerbaarheid. Zonder pushen of exporteren bestaat een image die op de server is gebouwd alleen op die server. Als de oude image niet meer beschikbaar is, betekent een rollback dat u de oude commit moet uitchecken en opnieuw moet bouwen. Er is geen garantie dat die build hetzelfde resultaat oplevert, omdat de base-tag en de package-mirrors in de tussentijd kunnen zijn gewijzigd. Elders bouwen en een tag pushen verandert een rollback in een eenvoudige aanpassing: wijs image: naar de vorige tag en voer docker compose up -d uit.
De meest robuuste opzet is duidelijk. Uw continuous integration voert de build uit en pusht naar registry.example.com/acme/web:<git-sha>, en het Compose-bestand op de VPS bevat image: zonder enige build:-sleutel. De implementatie bestaat dan uit twee commando's die nauwelijks geheugen vereisen.
docker compose pull
docker compose up -dVoer docker login registry.example.com uit op de server om inloggegevens op te slaan voor het ophalen van private tags.
Behoud de build-sectie voor ontwikkeling in plaats van deze te verwijderen, in een bestand dat u zelf een naam geeft.
# compose.dev.yaml
services:
web:
build:
context: .
pull_policy: builddocker compose -f compose.yaml -f compose.dev.yaml up -d --buildGeef dat bestand de naam compose.dev.yaml en niet compose.override.yaml. Compose laadt automatisch een override-bestand zodra dit aanwezig is. Een per ongeluk gekopieerd override-bestand op de server zou er ongemerkt voor zorgen dat er daar weer wordt gebouwd. Meerdere Compose-bestanden combineren legt uit hoe het samenvoegen van elk bestand de sleutels verwerkt.
De architectuurvalstrik bij het bouwen op een ander systeem
Een platform-image bevat de CPU-architectuur waarvoor deze is gebouwd. Bouw een ARM-image op een Apple Silicon-laptop, push deze, en gebruik de image vervolgens op een x86_64 VPS: Docker geeft een waarschuwing tijdens het aanmaken van de container als er een incompatibele gecachte image wordt gebruikt zonder expliciet platform. Zonder emulatie mislukt het proces met exec format error, wat eruitziet als een corrupt binair bestand, terwijl dat niet zo is. Bouw expliciet voor het doelplatform:
docker buildx build --platform linux/amd64 \
-t registry.example.com/acme/web:1.4.2 --push .Hetzelfde mismatch-probleem treedt in omgekeerde richting op als uw laptop x86 is en u een ARM VPS gebruikt in plaats van een x86-variant. Door CI te laten bouwen op de architectuur waarop u de software implementeert, vervalt dit probleem. Een multi-platform image lost dit eveneens op: Docker selecteert de bijbehorende variant bij het pullen.
Wat u moet controleren na een deploy
docker compose imagestoont de image en tag van elke actieve container. Een gewijzigde image-ID is het bewijs dat de nieuwe build in gebruik is genomen.docker compose configtoont het samengevoegde bestand na variabele-substitutie, zodat u de uiteindelijke image-naam kunt inzien die Compose gebruikt voordat u acties uitvoert.docker compose logs -f webgedurende de eerste halve minuut na de wissel. Een container die herhaaldelijk start en afsluit, herstart alleen als het restart-beleid dit voorschrijft; controleer de logs voor de oorzaak.docker image lstoont een CREATED-kolom. Controleer ook de build-output en de deployed image-ID, aangezien de aanmaaktijd alleen niet bewijst of er een rebuild heeft plaatsgevonden.
Als u het bestand waar deze controles op worden uitgevoerd nog aan het samenstellen bent, behandelt de basis van een Compose-bestand op een VPS de bijbehorende keys, en bevat de spiekbrief voor het Compose-commando de overige subcommando's.
FAQ
Kan ik build en image in dezelfde service gebruiken?
Ja, dit is de standaardconfiguratie voor een project dat u zelf bouwt. Wanneer Compose bouwt op basis van de build:-sectie, voorziet het het resultaat van een tag met de waarde van image:; zonder een expliciete pull_policy probeert up eerst een pull uit te voeren. Die tag is wat docker compose push naar een registry verstuurt en wat een andere machine ophaalt. Zonder een image:-sleutel bouwt Compose nog steeds, maar het vernoemt de image naar het project en de service, en geeft een waarschuwing dat het ontbreken van dit attribuut het pushen van de image verhindert.
Waarom verwerkt docker compose up mijn Dockerfile-wijziging niet?
Omdat een standaard up een bestaande image hergebruikt, tenzij u expliciet om een build vraagt of een beleid configureert dat dit vereist. Het vergelijkt de image niet met uw Dockerfile of bronbestanden om te bepalen of een herbouw nodig is. Voer docker compose up -d --build uit, of voer docker compose build web gevolgd door docker compose up --no-deps -d web uit om een enkele service te vervangen. Door pull_policy: build in te stellen op de service, dwingt u bij elke up een herbouw af, wat handig is voor een ontwikkelomgeving.
Wat is het verschil tussen --build en --force-recreate?
--build bouwt de image opnieuw en recreëert vervolgens de containers waarvan de image is gewijzigd. --force-recreate dwingt het recreëren van containers af, zelfs als de configuratie en de image niet zijn veranderd; het vraagt zelf niet om een build. Als uw wijziging in de broncode of in de Dockerfile zit, is --build de vlag die u nodig heeft. --force-recreate is bedoeld voor het resetten van de container zelf, bijvoorbeeld om de beschrijfbare laag te wissen terwijl de image behouden blijft.
Moet ik mijn Docker-images op de VPS bouwen of ergens anders?
Bouw elders en haal een tag op zodra de server verkeer bedient. Een build concurreert met uw applicatie om geheugen, en bij geheugentekort selecteert de kernel een slachtoffer op basis van een instelbare OOM-score, wat de build of uw database kan treffen. Builds laten ook cache achter op de schijf, hoewel BuildKit dit automatisch opruimt volgens de garbage collection-instellingen. Bouwen op de server is prima voor een klein project zonder gebruikers, en een latere migratie kost weinig moeite als u de build:-sectie in een Compose-bestand voor ontwikkeling houdt.
Hoe voorkom ik dat de Docker-buildcache mijn schijf vult?
Voer docker system df uit om te zien hoeveel ruimte uw images en uw buildcache in beslag nemen. docker builder prune verwijdert gecachte lagen en docker image prune verwijdert de zwevende images die zijn achtergebleven na eerdere builds. Het toevoegen van -a verwijdert respectievelijk alle ongebruikte buildcache of alle images waarnaar niet door containers wordt verwezen; dit garandeert geen volledig koude volgende build. Plan docker system prune -af --volumes niet in op een server, omdat dit gestopte containers en ongebruikte anonieme volumes verwijdert, waardoor databasedata in een anoniem volume tijdens onderhoud in gevaar komt.