SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Docker Compose build vs image: Panduan VPS

Ketahui perbezaan antara kunci image dan build dalam Docker Compose. Fahami punca Docker Compose mengabaikan perubahan Dockerfile anda pada VPS serta cara membetulkannya.

Perbezaan Docker Compose build dan image: jawapan ringkas

Dalam fail Docker Compose, image: mengenal pasti imej yang akan digunakan, termasuk imej tempatan, tag atau rujukan digest, manakala build: memberitahu Compose cara untuk membina imej daripada sumber. Tetapkan image: sahaja dan Compose akan menggunakan atau menarik imej tersebut mengikut pull_policy. Tetapkan build: sahaja dan Compose akan membina imej dengan pembina yang dikonfigurasikan, memberikan nama yang diperoleh daripada nama projek dan nama servis. Tetapkan kedua-duanya dan pull_policy mengawal sama ada Compose menarik atau membina imej; apabila ia membina, ia akan meletakkan tag pada hasil tersebut dengan nama dalam image:, iaitu cara anda membina imej dan menolaknya (push) di bawah nama yang anda pilih. Pembina boleh dijalankan secara tempatan atau pada hos Docker jauh.

Itulah perbezaan keseluruhannya. Segala yang berikut adalah maksudnya semasa operasi pada pelayan. Ini mengandaikan Docker Engine dan pemalam Compose sudah dipasang; menjalankan Docker pada VPS meliputi bahagian tersebut.

Tiga bentuk penuh

Gunakan tag yang telah diterbitkan, dan muat turun imej tersebut jika ia tiada di bawah polisi muat turun lalai. Tiada Dockerfile terlibat dalam mana-mana peringkat.

services:
  web:
    image: nginx:1.27
    restart: unless-stopped
    ports:
      - "80:80"

Bina daripada Dockerfile dalam direktori projek. Proses binaan ini juga boleh memuat turun imej dan dependensi yang diperlukan oleh Dockerfile tersebut.

services:
  web:
    build: .
    restart: unless-stopped
    ports:
      - "80:80"

Bina dan tandakan hasil binaan dengan docker compose build; tanpa polisi muat turun yang eksplisit, up akan cuba memuat turun imej ini sebelum membinanya. docker compose push kemudiannya boleh menghantar tag tepat tersebut ke registry.

services:
  web:
    build:
      context: .
      dockerfile: Dockerfile
    image: registry.example.com/acme/web:1.4.2
    restart: unless-stopped
    ports:
      - "80:80"

context ialah direktori yang dihantar kepada pembina. dockerfile diselesaikan berdasarkan konteks tersebut, jadi context: . dengan dockerfile: docker/prod.Dockerfile adalah perkara biasa dan betul. Jalankan docker compose images untuk melihat nama imej dan ID imej di sebalik setiap kontena servis; semak fail Compose untuk mengesahkan sama ada servis tersebut menggunakan image:, build: atau kedua-duanya.

Mengapa docker compose up tidak membina semula imej selepas saya mengubah Dockerfile?

Kerana up biasa akan menggunakan semula imej sedia ada melainkan anda meminta binaan baharu atau menetapkan polisi yang memerlukannya.

Apabila Compose memulakan servis yang hanya mempunyai bahagian build:, ia akan menggunakan imej sedia ada jika ia tersedia. Ia tidak membaca Dockerfile anda, membandingkan fail sumber, atau melihat sebarang cap masa. Dengan kedua-dua image: dan build: serta tanpa pull_policy yang eksplisit, Compose akan cuba menarik (pull) imej terlebih dahulu dan hanya membina jika imej tersebut tidak tersedia dalam registry atau cache platform. Imej yang sedia ada dianggap sudah mencukupi.

Oleh itu, anda menyunting app.py, menjalankan docker compose up -d, melihat Compose melaporkan kontena sedang berjalan, dan ia menghidangkan kod yang lama. Tiada apa-apa yang gagal, jadi tiada amaran diberikan kepada anda. Petunjuknya ialah perkataan status yang dicetak oleh Compose di sebelah nama kontena: kontena yang diganti oleh Compose akan melaporkan sebagai recreated atau started, manakala kontena yang dibiarkan oleh Compose akan melaporkan sebagai running.

Dua semakan dapat menentukan perkara ini. docker compose images mencetak ID imej yang digunakan oleh setiap kontena, jadi catatkan ID tersebut sebelum penggunaan (deploy) dan bandingkan selepasnya. docker image ls mempunyai lajur CREATED, tetapi binaan yang dicache dan cap masa yang boleh dihasilkan semula bermakna tarikh itu sahaja tidak membuktikan sama ada sumber terkini anda telah dibina.

Flag yang memaksa binaan semula

  • docker compose up -d --build membina servis terlebih dahulu, kemudian mencipta semula mana-mana kontena yang imejnya telah berubah. Ini adalah flag yang biasanya dicari oleh kebanyakan pengguna.
  • docker compose build web membina satu servis dan tidak memulakan apa-apa. Ikuti dengan docker compose up --no-deps -d web untuk menggantikan hanya kontena tersebut dan membiarkan selebihnya dalam stack terus berjalan.
  • docker compose build --no-cache web memintas lapisan cache dan membina semula servis tersebut.
  • docker compose build --pull mencuba untuk menarik versi yang lebih baharu bagi imej asas dalam FROM, supaya tag yang berubah-ubah seperti node:22 mengambil kandungan semasa dan bukannya salinan yang anda muat turun pada bulan Mac.
  • docker compose up -d --force-recreate memaksa penciptaan semula kontena walaupun konfigurasi dan imej tidak berubah. Flag ini sendiri tidak meminta binaan, tetapi up masih boleh membina apabila imej tiada atau polisi penarikan (pull policy) memerlukannya. Menggunakan flag ini apabila anda sebenarnya bermaksud --build adalah kesilapan yang biasa berlaku.

Anda juga boleh memindahkan keputusan tersebut ke dalam fail. Mengikut spesifikasi Compose, pull_policy: build bermaksud Compose membina imej tersebut, dan membina semula jika ia sudah wujud. Setiap up kemudiannya akan melakukan proses binaan, yang mungkin sesuai untuk komputer riba tetapi jarang diperlukan pada pelayan.

services:
  web:
    build: .
    image: registry.example.com/acme/web:dev
    pull_policy: build

Satu lagi interaksi yang perlu diketahui. docker compose pull cuba menarik imej untuk servis yang mempunyai bahagian build juga, dan jika penarikan itu gagal, ia memberitahu anda bahawa imej tersebut mesti dibina sebaliknya. Gunakan --ignore-buildable untuk melangkau servis tersebut secara senyap.

Bagaimana cache binaan menentukan masa deployment anda

Pembina (builder) menyemak setiap arahan Dockerfile untuk mendapatkan hasil cache yang boleh digunakan semula apabila arahan dan inputnya tidak berubah. Bagi COPY, input merangkumi kandungan fail dan metadata, tidak termasuk masa pengubahsuaian. Sebaik sahaja satu lapisan terlepas daripada cache, langkah seterusnya yang bergantung kepadanya akan dibina semula.

Satu peraturan itu menentukan sama ada deployment anda mengambil masa beberapa saat atau beberapa minit. Susun Dockerfile daripada perkara yang jarang berubah kepada perkara yang berubah pada setiap commit.

FROM node:22-slim
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
CMD ["node", "server.js"]

npm ci berada di atas COPY . ., jadi menyunting fail sumber membiarkan lapisan pemasangan (install layer) kekal dalam cache dan proses binaan bersambung pada langkah penyalinan (copy step). Jika anda menukar kedudukan kedua-dua baris tersebut, perubahan satu aksara akan menyebabkan pemasangan semula setiap dependency, kerana COPY . . membatalkan lapisan yang menjadi asas kepada npm ci. Bentuk yang sama terpakai kepada pip install -r requirements.txt dan go mod download.

--no-cache ialah alat yang tepat apabila anda mengesyaki lapisan lama (stale layer) menyembunyikan pembaikan anda. Ia adalah tetapan lalai yang tidak baik, kerana ia membuang kelebihan penggunaan semula yang sepatutnya diperoleh melalui penyusunan Dockerfile yang betul.

Satu perkara yang ditetapkan oleh imej dan boleh diatasi (override) oleh Compose: CMD dalam Dockerfile ialah perkara yang dijalankan oleh imej secara lalai, dan kunci command: dalam servis akan menggantikannya. Bagaimana command dan entrypoint berinteraksi adalah penting di sini, kerana override dalam Compose boleh menyebabkan imej yang baru dibina berkelakuan sama seperti imej lama.

Konteks binaan dan .dockerignore

context: . menjadikan direktori projek tersedia kepada pembina. Tanpa pengecualian, ini termasuk .git dan mana-mana direktori data yang anda simpan di sebelah kod sumber anda, walaupun BuildKit melangkau fail yang tidak digunakan dan memindahkan perubahan secara berperingkat. Binaan yang terhenti pada langkah memindahkan konteks bagi projek yang tidak berubah menunjukkan bahawa konteks tersebut terlalu besar.

Fail .dockerignore pada akar konteks mengecualikan laluan daripada pemindahan tersebut. Sintaksnya hampir sama dengan .gitignore.

.git
node_modules
*.log
data/
.env

Terdapat dua manfaat. Pemindahan menjadi lebih kecil, sekali gus mengurangkan masa yang dihabiskan untuk menghantar fail tersebut. Selain itu, COPY . . tidak lagi boleh menyalin .env ke dalam imej, yang mana sesiapa sahaja yang menarik (pull) imej tersebut boleh membacanya semula.

Kes binaan perlahan yang semakin bertambah dari semasa ke semasa berpunca daripada bind mount. Named volume berada di luar direktori projek anda, tetapi bind mount seperti ./data:/var/lib/postgresql/data terletak di dalam konteks binaan, jadi binaan anda menjadi semakin perlahan setiap minggu apabila pangkalan data membesar. Satu baris dalam .dockerignore menyelesaikan masalah ini. Bind mount berbanding named volume membincangkan pertukaran yang lebih luas.

Argumen binaan membawa risiko yang sama dalam versi yang lebih kecil. Nilai yang dihantar melalui args: boleh kekal dalam sejarah imej atau metadata asal, jadi letakkan nombor versi di sana dan jangan sekali-kali meletakkan token. Argumen proksi yang dipratentukan dikecualikan daripada cache binaan dan docker history secara lalai melainkan dirujuk secara eksplisit dalam Dockerfile. Fail Env dan rahsia dalam Compose membincangkan tempat yang sepatutnya bagi kelayakan (credentials).

Patutkah anda membina aplikasi pada VPS atau membina di tempat lain dan menariknya masuk?

Membina aplikasi pada pelayan yang melayani trafik anda adalah pilihan lalai kerana ia merupakan laluan paling singkat: git pull, kemudian docker compose up -d --build. Ini memadai untuk pelayan kecil yang belum mempunyai pengguna. Ia menjadi masalah atas dua sebab yang boleh diukur dan satu sebab yang hanya muncul pada waktu kritikal.

Memori. Proses binaan menjalankan pengkompil dan pengikat (bundler) bersama aplikasi yang sedang berjalan, dan proses ini biasanya sangat menggunakan memori dalam kebanyakan tindanan teknologi. Pengikat JavaScript atau pengkompil Rust boleh menghabiskan memori yang tersedia pada VPS 1 GB. Apabila memori habis, kernel akan memilih mangsa OOM (Out of Memory) menggunakan skor keburukan berdasarkan penggunaan memori, konteks peruntukan dan oom_score_adj; ia tidak semestinya mematikan proses yang paling besar. Proses binaan boleh terhenti dengan Killed dan status keluar 137, atau pangkalan data anda mungkin dimatikan dan tapak web boleh tergendala semasa proses penempatan (deploy). dmesg -T | grep -i oom mencari mesej OOM dalam log kernel; akses memerlukan kebenaran untuk membaca log tersebut.

Cakera. Proses binaan meninggalkan lapisan imej dan cache binaan. docker system df menunjukkan penggunaan cakera tersebut; pengumpulan sampah berkala BuildKit menuntut semula cache mengikut polisi yang dikonfigurasikan. Tuntut semula dengan docker image prune untuk imej yang tergantung dan docker builder prune untuk lapisan yang dicache. Cakera yang penuh akan menghentikan lebih daripada sekadar proses binaan. Pangkalan data juga akan berhenti menulis, dan kegagalan itu menelan kos yang jauh lebih tinggi daripada proses penempatan yang perlahan.

Kebolehulangan. Tanpa menolak (push) atau mengeksportnya, imej yang dibina pada pelayan hanya wujud pada pelayan tersebut. Jika imej lama tidak lagi tersedia, proses rollback bermakna anda perlu menyemak komit lama dan membina semula, dan binaan itu tidak dijamin menghasilkan hasil yang sama seperti sebelumnya, kerana tag asas telah berubah dan cermin pakej juga telah berubah. Membina di tempat lain dan menolak tag menjadikan proses rollback sebagai satu suntingan: halakan image: kepada tag sebelumnya dan jalankan docker compose up -d.

Susunan yang paling stabil adalah jelas. Integrasi berterusan (CI) anda menjalankan binaan dan menolak registry.example.com/acme/web:<git-sha>, dan fail Compose pada VPS membawa image: tanpa sebarang kunci build:. Penempatan kemudiannya hanya memerlukan dua arahan yang hampir tidak menggunakan memori.

docker compose pull
docker compose up -d

Jalankan docker login registry.example.com pada pelayan untuk menyimpan kelayakan bagi menarik tag peribadi.

Simpan bahagian binaan untuk pembangunan dan bukannya memadamnya, dalam fail yang anda namakan sendiri.

# compose.dev.yaml
services:
  web:
    build:
      context: .
    pull_policy: build
docker compose -f compose.yaml -f compose.dev.yaml up -d --build

Namakan fail tersebut compose.dev.yaml dan bukannya compose.override.yaml. Compose memuatkan fail override secara automatik apabila ia wujud, jadi fail override yang tersilap salin ke pelayan akan mula membina aplikasi di sana secara senyap. Melapiskan beberapa fail Compose menjelaskan cara penggabungan menyelesaikan setiap kunci.

Perangkap seni bina apabila membina di tempat lain

Imej platform tunggal membawa seni bina CPU yang ia dibina untuknya. Jika anda membina imej ARM pada komputer riba Apple Silicon, menolaknya (push), kemudian menggunakan imej tersebut pada VPS x86_64: Docker akan memberi amaran semasa penciptaan kontena jika ia menggunakan imej cache yang tidak serasi tanpa platform yang eksplisit. Tanpa emulasi, proses tersebut gagal dengan exec format error, yang kelihatan seperti binari rosak sedangkan ia bukan. Bina untuk sasaran secara eksplisit:

docker buildx build --platform linux/amd64 \
  -t registry.example.com/acme/web:1.4.2 --push .

Ketidakpadanan yang sama berlaku secara terbalik jika komputer riba anda adalah x86 dan anda menjalankan VPS ARM dan bukannya VPS x86. Membiarkan CI membina pada seni bina yang anda gunakan untuk penempatan (deploy) akan menyelesaikan masalah ini. Imej berbilang platform juga menyelesaikan perkara ini: Docker memilih varian yang sepadan apabila menarik (pull) imej tersebut.

Perkara yang perlu disemak selepas proses deploy

  • docker compose images mencetak imej dan tag di sebalik setiap kontena yang sedang berjalan. ID imej yang berubah adalah bukti bahawa binaan baharu sedang beroperasi.
  • docker compose config mencetak fail yang telah digabungkan selepas penggantian pemboleh ubah, supaya anda boleh membaca nama imej akhir yang akan digunakan oleh Compose sebelum anda menjalankan apa-apa.
  • docker compose logs -f web untuk separuh minit pertama selepas pertukaran. Kontena yang bermula dan keluar berulang kali hanya akan dimulakan semula jika polisi restart memerlukannya; semak log untuk mengetahui puncanya.
  • docker image ls menunjukkan lajur CREATED. Semak juga output binaan dan ID imej yang di-deploy, kerana cap masa penciptaan sahaja tidak membuktikan sama ada proses binaan semula telah dijalankan.

Jika anda masih menyusun fail yang digunakan untuk semakan ini, asas fail Compose pada VPS merangkumi kunci-kunci yang berkaitan, dan lembaran rujukan arahan Compose menyenaraikan sub-arahan yang lain.

FAQ

Bolehkah saya menggunakan build dan image dalam servis yang sama?

Ya, dan ini adalah tetapan biasa untuk projek yang anda bina sendiri. Apabila Compose membina daripada bahagian build:, ia melabelkan hasil tersebut dengan nilai image:; tanpa pull_policy yang eksplisit, up akan cuba menarik (pull) imej terlebih dahulu. Label tersebut adalah apa yang dihantar oleh docker compose push ke registry dan apa yang ditarik oleh mesin lain. Tanpa kunci image:, Compose masih akan membina imej, tetapi ia menamakan imej tersebut berdasarkan projek dan servis, serta memberi amaran bahawa atribut yang hilang menghalang imej tersebut daripada ditolak (push).

Mengapa docker compose up tidak mengesan perubahan Dockerfile saya?

Kerana up biasa menggunakan semula imej sedia ada melainkan anda meminta binaan (build) atau mengkonfigurasi polisi yang memerlukannya. Ia tidak membandingkan imej tersebut dengan Dockerfile atau fail sumber anda untuk menentukan sama ada binaan semula diperlukan. Jalankan docker compose up -d --build, atau jalankan docker compose build web diikuti dengan docker compose up --no-deps -d web untuk menggantikan satu servis sahaja. Menetapkan pull_policy: build pada servis akan menyebabkan setiap up membina semula imej, yang sesuai untuk mesin pembangunan.

Apakah perbezaan antara --build dan --force-recreate?

--build membina semula imej, kemudian mencipta semula kontena yang imejnya telah berubah. --force-recreate memaksa penciptaan semula kontena walaupun konfigurasi dan imej tidak berubah; ia sendiri tidak meminta binaan. Jika perubahan anda adalah pada sumber atau dalam Dockerfile, --build adalah flag yang anda perlukan. --force-recreate adalah untuk menetapkan semula kontena itu sendiri, contohnya untuk membersihkan lapisan boleh tulis (writable layer) sambil mengekalkan imej yang sama.

Patutkah saya membina imej Docker saya pada VPS atau di tempat lain?

Bina di tempat lain dan tarik (pull) label imej sebaik sahaja pelayan mula melayani trafik. Proses binaan bersaing dengan aplikasi anda untuk mendapatkan memori, dan di bawah keadaan kehabisan memori, kernel akan memilih mangsa menggunakan skor OOM yang boleh dilaraskan, yang mungkin menyasarkan proses binaan atau pangkalan data anda. Binaan juga meninggalkan cache pada cakera, walaupun BuildKit menuntutnya semula secara automatik mengikut polisi pengumpulan sampah (garbage collection). Membina pada pelayan adalah memadai untuk projek kecil tanpa pengguna, dan berpindah kemudian tidak menelan kos yang besar jika anda mengekalkan bahagian build: dalam fail Compose khusus pembangunan.

Bagaimanakah cara untuk menghentikan cache binaan Docker daripada memenuhi cakera saya?

Jalankan docker system df untuk melihat berapa banyak ruang yang digunakan oleh imej dan cache binaan anda. docker builder prune membuang lapisan cache dan docker image prune membuang imej tergantung (dangling images) yang ditinggalkan oleh binaan terdahulu. Menambah -a akan membuang semua cache binaan yang tidak digunakan atau semua imej yang tidak dirujuk oleh kontena; ia tidak menjamin binaan seterusnya akan bermula dari kosong sepenuhnya. Jangan jadualkan docker system prune -af --volumes pada pelayan, kerana ia membuang kontena yang dihentikan dan volum tanpa nama (anonymous volumes) yang tidak digunakan, yang boleh meletakkan data pangkalan data dalam volum tanpa nama pada risiko semasa penyelenggaraan.

Adakah artikel ini berguna?