Docker Compose build vs image ต่างกันอย่างไรบน VPS
สรุปความแตกต่างระหว่างคีย์ build และ image ใน Docker Compose บน VPS พร้อมวิธีแก้ไขปัญหา Docker ไม่ยอมอัปเดตโค้ดใหม่หลังจากแก้ไข Dockerfile เพราะใช้ image เดิมค้างอยู่
ความแตกต่างระหว่าง build กับ image ใน Docker Compose: สรุปสั้นๆ
ในไฟล์ Docker Compose นั้น image: จะระบุ image ที่ต้องการใช้งาน ซึ่งรวมถึง image ในเครื่อง, tag หรือการอ้างอิงแบบ digest ส่วน build: จะบอกให้ Compose ทราบถึงวิธีการ build image จากซอร์สโค้ด หากกำหนดเฉพาะ image: ตัว Compose จะใช้งานหรือดึง image ตามที่ระบุไว้ใน pull_policy หากกำหนดเฉพาะ build: ตัว Compose จะทำการ build image ด้วย builder ที่ตั้งค่าไว้ โดยตั้งชื่อตามชื่อโปรเจกต์และชื่อ service หากกำหนดทั้งสองอย่าง pull_policy จะเป็นตัวควบคุมว่า Compose จะดึงหรือ build image ในกรณีที่ทำการ build ระบบจะติด tag ผลลัพธ์ด้วยชื่อที่ระบุใน image: ซึ่งเป็นวิธีการ build และ push image ภายใต้ชื่อที่คุณกำหนดเอง โดยตัว builder สามารถทำงานได้ทั้งในเครื่องหรือบน Docker host ระยะไกล
นี่คือความแตกต่างทั้งหมด ส่วนเนื้อหาด้านล่างนี้คือสิ่งที่เกิดขึ้นจริงเมื่อใช้งานบนเซิร์ฟเวอร์ โดยสมมติว่ามีการติดตั้ง Docker Engine และปลั๊กอิน Compose ไว้เรียบร้อยแล้ว ซึ่งสามารถดูรายละเอียดได้ที่ การรัน Docker บน VPS
รูปแบบการใช้งานทั้ง 3 รูปแบบ
ใช้แท็กที่เผยแพร่ไว้แล้ว โดยระบบจะดึงอิมเมจมาหากยังไม่มีในเครื่องภายใต้นโยบายการดึงข้อมูลเริ่มต้น (default pull policy) โดยไม่มีการใช้ Dockerfile ในขั้นตอนนี้
services:
web:
image: nginx:1.27
restart: unless-stopped
ports:
- "80:80"สร้างอิมเมจจาก Dockerfile ในไดเรกทอรีของโปรเจกต์ กระบวนการสร้างนี้สามารถดึงอิมเมจและดาวน์โหลด dependency ที่จำเป็นตามที่ระบุไว้ใน Dockerfile ได้
services:
web:
build: .
restart: unless-stopped
ports:
- "80:80"สร้างและติดแท็กผลลัพธ์ด้วย docker compose build หากไม่มีการระบุนโยบายการดึงข้อมูลที่ชัดเจน up จะพยายามดึงอิมเมจนี้ก่อนเริ่มการสร้าง จากนั้น docker compose push จะสามารถส่งแท็กดังกล่าวไปยัง registry ได้
services:
web:
build:
context: .
dockerfile: Dockerfile
image: registry.example.com/acme/web:1.4.2
restart: unless-stopped
ports:
- "80:80"context คือไดเรกทอรีที่ถูกส่งไปยังตัวสร้าง (builder) โดย dockerfile จะถูกอ้างอิงจากบริบท (context) นั้น ดังนั้นการใช้ context: . ร่วมกับ dockerfile: docker/prod.Dockerfile จึงเป็นเรื่องปกติและถูกต้อง ให้รันคำสั่ง docker compose images เพื่อดูชื่ออิมเมจและ image ID ของคอนเทนเนอร์แต่ละบริการ และตรวจสอบไฟล์ Compose เพื่อยืนยันว่าบริการนั้นใช้ image:, build: หรือใช้ทั้งสองอย่างร่วมกัน
เหตุใดคำสั่ง docker compose up จึงไม่สร้างอิมเมจใหม่หลังจากที่ฉันแก้ไข Dockerfile?
เนื่องจาก up ตามปกติจะนำอิมเมจเดิมที่มีอยู่กลับมาใช้ใหม่ เว้นแต่คุณจะสั่งให้สร้างใหม่หรือกำหนดนโยบายที่บังคับให้ต้องสร้าง
เมื่อ Compose เริ่มการทำงานของเซอร์วิสที่มีเพียงส่วน build: มันจะใช้อิมเมจที่มีอยู่หากพบในระบบ มันไม่ได้อ่านไฟล์ Dockerfile ของคุณ ไม่ได้เปรียบเทียบไฟล์ซอร์สโค้ด และไม่ได้ตรวจสอบการประทับเวลาใดๆ ทั้งสิ้น ในกรณีที่มีทั้ง image: และ build: โดยไม่มีการระบุ pull_policy อย่างชัดเจน Compose จะพยายามดึงอิมเมจ (pull) ก่อน และจะสร้างใหม่ก็ต่อเมื่อไม่มีอิมเมจนั้นใน registry หรือแคชของแพลตฟอร์ม หากมีอิมเมจอยู่แล้วจะถือว่าใช้ได้
ดังนั้น เมื่อคุณแก้ไข app.py แล้วรัน docker compose up -d คุณจะเห็น Compose รายงานว่าคอนเทนเนอร์กำลังทำงานอยู่ แต่ยังคงให้บริการโค้ดเวอร์ชันเก่า ไม่มีขั้นตอนใดล้มเหลว จึงไม่มีการแจ้งเตือนใดๆ จุดสังเกตคือสถานะที่ Compose แสดงถัดจากชื่อคอนเทนเนอร์: คอนเทนเนอร์ที่ถูกแทนที่โดย Compose จะรายงานว่า recreated หรือ started ส่วนคอนเทนเนอร์ที่ Compose ตัดสินใจไม่ยุ่งจะรายงานว่า running
การตรวจสอบสองวิธีจะช่วยยืนยันเรื่องนี้ได้ docker compose images จะแสดง ID ของอิมเมจที่แต่ละคอนเทนเนอร์กำลังใช้งานอยู่ ดังนั้นให้จดค่าไว้ก่อนการ deploy แล้วนำมาเปรียบเทียบหลังจากนั้น ส่วน docker image ls จะมีคอลัมน์ CREATED แต่เนื่องจากการสร้างแบบใช้แคชและการประทับเวลาที่ทำซ้ำได้ (reproducible timestamps) ทำให้วันที่เพียงอย่างเดียวไม่สามารถพิสูจน์ได้ว่าซอร์สโค้ดล่าสุดของคุณถูกนำไปสร้างจริงหรือไม่
แฟล็กใดบ้างที่บังคับให้สร้างใหม่ (rebuild)
docker compose up -d --buildจะทำการ build ก่อน แล้วจึงสร้าง container ใหม่หาก image มีการเปลี่ยนแปลง นี่คือแฟล็กที่ผู้ใช้ส่วนใหญ่ต้องการdocker compose build webจะทำการ build เฉพาะ service เดียวและไม่เริ่มการทำงานใดๆ ให้ใช้ตามด้วยdocker compose up --no-deps -d webเพื่อแทนที่เฉพาะ container นั้นโดยปล่อยให้ stack ส่วนที่เหลือทำงานต่อไปdocker compose build --no-cache webจะข้ามการใช้ cached layers และทำการ build service ใหม่ทั้งหมดdocker compose build --pullจะพยายามดึง base image เวอร์ชันใหม่ในFROMเพื่อให้ tag ที่มีการเปลี่ยนแปลงได้ เช่นnode:22ได้รับเนื้อหาล่าสุดแทนที่จะเป็นสำเนาที่คุณดาวน์โหลดมาเมื่อเดือนมีนาคมdocker compose up -d --force-recreateจะบังคับให้สร้าง container ใหม่แม้ว่าการตั้งค่าและ image จะไม่มีการเปลี่ยนแปลงก็ตาม แฟล็กนี้ไม่ได้ร้องขอให้มีการ build โดยตรง แต่upอาจยังคงทำการ build หาก image หายไปหรือนโยบายการดึงข้อมูล (pull policy) กำหนดไว้ การเลือกใช้แฟล็กนี้ในขณะที่คุณต้องการ--buildมักนำไปสู่ทางตัน
คุณยังสามารถย้ายการตัดสินใจนี้ไปไว้ในไฟล์ได้ ตามข้อกำหนดของ Compose นั้น pull_policy: build หมายความว่า Compose จะทำการ build image และสร้างใหม่หากมีอยู่แล้ว ทุกๆ up จะต้องเสียเวลาในการ build ซึ่งเป็นสิ่งที่คุณต้องการบนแล็ปท็อป แต่แทบจะไม่ใช่สิ่งที่คุณต้องการบนเซิร์ฟเวอร์
services:
web:
build: .
image: registry.example.com/acme/web:dev
pull_policy: buildมีการโต้ตอบอีกหนึ่งอย่างที่ควรทราบ docker compose pull จะพยายามดึง image สำหรับ service ที่มีส่วน build ด้วย และหากการดึงข้อมูลล้มเหลว ระบบจะแจ้งว่าต้องทำการ build image แทน ให้ส่งแฟล็ก --ignore-buildable เพื่อข้าม service เหล่านั้นไปอย่างเงียบๆ
วิธีที่ build cache ตัดสินระยะเวลาในการ deploy
ตัว builder จะตรวจสอบคำสั่งใน Dockerfile แต่ละบรรทัดเพื่อหาผลลัพธ์ที่สามารถนำกลับมาใช้ใหม่ได้จาก cache หากคำสั่งและข้อมูลนำเข้านั้นไม่มีการเปลี่ยนแปลง สำหรับ COPY ข้อมูลนำเข้าจะรวมถึงเนื้อหาของไฟล์และ metadata โดยไม่นับรวมเวลาที่แก้ไขไฟล์ (modification times) เมื่อมี layer ใด layer หนึ่งไม่พบข้อมูลใน cache ขั้นตอนถัดไปทั้งหมดที่ขึ้นอยู่กับ layer นั้นจะต้องถูกสร้างใหม่ (rebuild)
กฎข้อเดียวนี้นี่เองที่เป็นตัวตัดสินว่าการ deploy ของคุณจะใช้เวลาเพียงไม่กี่วินาทีหรือหลายนาที คุณควรเรียงลำดับ Dockerfile จากส่วนที่เปลี่ยนแปลงน้อยที่สุดไปจนถึงส่วนที่เปลี่ยนแปลงทุกครั้งที่มีการ commit
FROM node:22-slim
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
CMD ["node", "server.js"]npm ci ถูกวางไว้เหนือ COPY . . ดังนั้นการแก้ไขไฟล์ source code จึงทำให้ layer ของการติดตั้ง (install layer) ยังคงอยู่ใน cache และกระบวนการ build จะไปเริ่มใหม่ที่ขั้นตอนการ copy หากคุณสลับสองบรรทัดนี้ การแก้ไขเพียงตัวอักษรเดียวจะทำให้ต้องติดตั้ง dependency ใหม่ทั้งหมด เพราะ COPY . . จะทำให้ layer ที่ npm ci สร้างอยู่บนนั้นกลายเป็นโมฆะ รูปแบบเดียวกันนี้ยังใช้ได้กับ pip install -r requirements.txt และ go mod download
--no-cache เป็นเครื่องมือที่เหมาะสมเมื่อคุณสงสัยว่ามี layer เก่าที่ค้างอยู่กำลังบดบังการแก้ไขของคุณ แต่มันไม่ใช่ค่าเริ่มต้นที่ดี เพราะมันจะทิ้งประโยชน์จากการนำ cache กลับมาใช้ใหม่ ซึ่งเป็นเหตุผลหลักในการจัดลำดับ Dockerfile
สิ่งหนึ่งที่ image กำหนดไว้และ Compose สามารถเขียนทับได้คือ CMD ของ Dockerfile ซึ่งเป็นสิ่งที่ image จะรันโดยค่าเริ่มต้น และคีย์ command: ใน service จะเข้ามาแทนที่ค่าดังกล่าว วิธีที่ command และ entrypoint ทำงานร่วมกัน มีความสำคัญในจุดนี้ เพราะการเขียนทับผ่าน Compose อาจทำให้ image ที่เพิ่ง build ใหม่มีพฤติกรรมเหมือนกับ image ตัวเก่าทุกประการ
Build context และ .dockerignore
context: . จะทำให้ไดเรกทอรีของโปรเจกต์พร้อมใช้งานสำหรับตัวสร้าง (builder) หากไม่มีการยกเว้น ไฟล์ทั้งหมดจะรวมถึง .git และไดเรกทอรีข้อมูลใดๆ ที่คุณเก็บไว้ข้างซอร์สโค้ด แม้ว่า BuildKit จะข้ามไฟล์ที่ไม่ได้ใช้งานและโอนถ่ายเฉพาะส่วนที่มีการเปลี่ยนแปลงก็ตาม หากการ build หยุดชะงักในขั้นตอน transferring-context ทั้งที่โปรเจกต์ไม่มีการเปลี่ยนแปลง แสดงว่า context ของคุณมีขนาดใหญ่เกินไป
ไฟล์ .dockerignore ที่อยู่ใน root ของ context จะทำหน้าที่ยกเว้น path ต่างๆ ออกจากการโอนถ่าย โดยมีไวยากรณ์ใกล้เคียงกับ .gitignore
.git
node_modules
*.log
data/
.envคุณจะได้รับประโยชน์ 2 ประการ ประการแรกคือการโอนถ่ายข้อมูลลดลง ช่วยลดเวลาที่ใช้ในการส่งไฟล์เหล่านั้น ประการที่สองคือ COPY . . จะไม่สามารถคัดลอก .env ลงใน image ได้อีกต่อไป ซึ่งช่วยป้องกันไม่ให้ผู้ที่ดึง (pull) image นั้นไปสามารถอ่านข้อมูลดังกล่าวได้
กรณีที่การ build ช้าลงเรื่อยๆ ตามกาลเวลามักเกิดจาก bind mount โดยที่ named volume จะอยู่นอกไดเรกทอรีโปรเจกต์ แต่ bind mount เช่น ./data:/var/lib/postgresql/data จะอยู่ภายใน build context ดังนั้นการ build ของคุณจะช้าลงทุกสัปดาห์ตามขนาดของฐานข้อมูลที่เพิ่มขึ้น ซึ่งสามารถแก้ไขได้ด้วยการเพิ่มหนึ่งบรรทัดใน .dockerignore คุณสามารถอ่านรายละเอียดเพิ่มเติมเกี่ยวกับข้อดีข้อเสียได้ที่ Bind mounts เทียบกับ named volumes
Build arguments มีความเสี่ยงในลักษณะเดียวกันแต่ในระดับที่เล็กกว่า ค่าที่ส่งผ่าน args: อาจคงอยู่ในประวัติของ image หรือ metadata ของ provenance ดังนั้นควรใส่เพียงเลขเวอร์ชันเท่านั้นและห้ามใส่ token โดยเด็ดขาด สำหรับ proxy arguments ที่กำหนดไว้ล่วงหน้าจะถูกยกเว้นจาก build cache และ docker history โดยค่าเริ่มต้น เว้นแต่จะมีการอ้างอิงอย่างชัดเจนใน Dockerfile คุณสามารถดูข้อมูลเพิ่มเติมเกี่ยวกับตำแหน่งที่ควรเก็บ credential ได้ที่ Env files และ secrets ใน Compose
ควร build บน VPS หรือ build ที่อื่นแล้วค่อยดึงมา?
การ build บนเซิร์ฟเวอร์ที่ให้บริการ traffic เป็นวิธีเริ่มต้นเพราะเป็นเส้นทางที่สั้นที่สุด: git pull แล้วตามด้วย docker compose up -d --build วิธีนี้ใช้ได้ดีกับเซิร์ฟเวอร์ขนาดเล็กที่ยังไม่มีใครใช้งาน แต่จะเริ่มมีปัญหาด้วยเหตุผล 2 ประการที่คุณวัดผลได้ และอีก 1 ประการที่จะปรากฏให้เห็นในวันที่ระบบมีปัญหา
หน่วยความจำ (Memory): กระบวนการ build จะรัน compiler และ bundler ควบคู่ไปกับแอปพลิเคชันที่กำลังทำงานอยู่ ซึ่งเครื่องมือเหล่านี้เป็นส่วนที่กินหน่วยความจำมากที่สุดในเกือบทุก stack การทำ JavaScript bundler หรือการ compile ภาษา Rust อาจทำให้หน่วยความจำบน VPS ขนาด 1 GB หมดลงได้ เมื่อเกิดภาวะหน่วยความจำไม่พอ (OOM) เคอร์เนลจะเลือกกระบวนการที่จะถูกสั่งยุติ (OOM victim) โดยใช้คะแนนความเสียหายที่คำนวณจากปริมาณการใช้หน่วยความจำ, บริบทการจัดสรรหน่วยความจำ และ oom_score_adj โดยไม่ได้เลือกฆ่าแค่กระบวนการที่ใช้หน่วยความจำมากที่สุดเท่านั้น การ build อาจหยุดลงด้วย Killed และ exit status 137 หรือฐานข้อมูลของคุณอาจถูกสั่งยุติแทน ส่งผลให้เว็บไซต์ล่มกลางคันระหว่างการ deploy คุณสามารถใช้ dmesg -T | grep -i oom เพื่อค้นหาข้อความ OOM ใน log ของเคอร์เนล ซึ่งการเข้าถึงต้องใช้สิทธิ์ในการอ่าน log ดังกล่าว
ดิสก์ (Disk): การ build จะทิ้ง image layers และ build cache ไว้เบื้องหลัง docker system df จะแสดงการใช้งานดิสก์ของส่วนประกอบเหล่านี้ โดยระบบ garbage collection ของ BuildKit จะคืนพื้นที่ cache ตามนโยบายที่กำหนดไว้ คุณสามารถคืนพื้นที่ด้วย docker image prune สำหรับ image ที่ไม่ได้ใช้งาน (dangling) และ docker builder prune สำหรับ cached layers หากดิสก์เต็มจะส่งผลกระทบมากกว่าแค่การ build ล้มเหลว เพราะฐานข้อมูลจะหยุดเขียนข้อมูลด้วย ซึ่งความเสียหายนั้นมีมูลค่าสูงกว่าการ deploy ที่ล่าช้ามากนัก
ความสามารถในการทำซ้ำ (Reproducibility): หากไม่มีการ push หรือ export ออกไป image ที่ build บนเซิร์ฟเวอร์จะคงอยู่แค่บนเซิร์ฟเวอร์นั้นเท่านั้น หาก image เดิมไม่สามารถใช้งานได้ การย้อนกลับ (rollback) จะหมายถึงการต้อง checkout commit เก่าแล้ว build ใหม่ ซึ่งการ build นั้นไม่รับประกันว่าจะได้ผลลัพธ์เหมือนเดิม เนื่องจาก base tag อาจมีการเปลี่ยนแปลงและ package mirrors ก็อาจเปลี่ยนไปตามกาลเวลา การ build ที่อื่นแล้ว push tag ขึ้นไปจะเปลี่ยนการ rollback ให้กลายเป็นเพียงการแก้ไข: เพียงชี้ image: ไปที่ tag ก่อนหน้าแล้วรัน docker compose up -d
รูปแบบที่ยั่งยืนนั้นชัดเจน คือให้ระบบ continuous integration ทำการ build และ push registry.example.com/acme/web:<git-sha> จากนั้นไฟล์ Compose บน VPS ให้ระบุ image: โดยไม่ต้องมีคีย์ build: เลย การ deploy จะเหลือเพียงสองคำสั่งที่แทบไม่ใช้หน่วยความจำ
docker compose pull
docker compose up -dรัน docker login registry.example.com บนเซิร์ฟเวอร์เพื่อบันทึกข้อมูลรับรอง (credentials) สำหรับการดึง private tags
ให้คงส่วนการ build ไว้สำหรับการพัฒนาแทนที่จะลบออก โดยเก็บไว้ในไฟล์ที่คุณตั้งชื่อเอง
# compose.dev.yaml
services:
web:
build:
context: .
pull_policy: builddocker compose -f compose.yaml -f compose.dev.yaml up -d --buildตั้งชื่อไฟล์นั้นว่า compose.dev.yaml และอย่าใช้ชื่อ compose.override.yaml เพราะ Compose จะโหลดไฟล์ override โดยอัตโนมัติหากพบไฟล์ดังกล่าว ดังนั้นหากมีไฟล์ override ตกค้างอยู่บนเซิร์ฟเวอร์ มันจะเริ่มทำการ build บนเซิร์ฟเวอร์นั้นโดยที่คุณไม่รู้ตัว การซ้อนทับไฟล์ Compose หลายไฟล์ อธิบายวิธีที่ระบบรวมคีย์แต่ละตัวเข้าด้วยกัน
กับดักทางสถาปัตยกรรมเมื่อสร้างงานจากที่อื่น
อิมเมจของแพลตฟอร์มหนึ่งจะมีสถาปัตยกรรม CPU ที่ถูกสร้างมาเพื่อแพลตฟอร์มนั้นโดยเฉพาะ หากคุณสร้างอิมเมจ ARM บนแล็ปท็อป Apple Silicon แล้ว push ขึ้นไป จากนั้นนำอิมเมจนั้นไปใช้บน VPS ที่เป็น x86_64 ตัว Docker จะแจ้งเตือนระหว่างการสร้างคอนเทนเนอร์หากมีการใช้อิมเมจที่แคชไว้ซึ่งไม่รองรับโดยไม่มีการระบุแพลตฟอร์มที่ชัดเจน หากไม่มีการจำลองการทำงาน (emulation) กระบวนการจะล้มเหลวด้วยข้อผิดพลาด exec format error ซึ่งอ่านดูแล้วเหมือนไฟล์ไบนารีเสียหาย แต่จริงๆ แล้วไม่ใช่ ให้สร้างอิมเมจสำหรับเป้าหมายโดยระบุให้ชัดเจน:
docker buildx build --platform linux/amd64 \
-t registry.example.com/acme/web:1.4.2 --push .ความไม่เข้ากันแบบเดียวกันนี้จะเกิดขึ้นในทางกลับกันหากแล็ปท็อปของคุณเป็น x86 และคุณใช้งาน VPS แบบ ARM แทนที่จะเป็น x86 การปล่อยให้ระบบ CI สร้างอิมเมจบนสถาปัตยกรรมเดียวกับที่คุณใช้งานจริงจะช่วยขจัดปัญหานี้ได้ นอกจากนี้ อิมเมจแบบหลายแพลตฟอร์ม (multi-platform image) ก็ช่วยแก้ปัญหานี้ได้เช่นกัน โดย Docker จะเลือกเวอร์ชันที่ตรงกันให้โดยอัตโนมัติเมื่อทำการ pull อิมเมจนั้นมาใช้งาน
สิ่งที่ควรตรวจสอบหลังการ deploy
docker compose imagesแสดง image และ tag ของ container ที่กำลังทำงานอยู่ทุกตัว หาก image ID เปลี่ยนไป นั่นคือหลักฐานว่า build ใหม่ถูกนำมาใช้งานแล้วdocker compose configแสดงไฟล์ที่รวมค่าตัวแปรเรียบร้อยแล้ว คุณจึงสามารถอ่านชื่อ image สุดท้ายที่ Compose จะใช้ก่อนที่จะรันคำสั่งใดๆdocker compose logs -f webสำหรับช่วงเวลา 30 วินาทีแรกหลังการสลับ container หาก container เริ่มทำงานแล้วหยุดซ้ำๆ จะมีการ restart ก็ต่อเมื่อ restart policy กำหนดไว้เท่านั้น ให้ตรวจสอบ log เพื่อหาสาเหตุdocker image lsแสดงคอลัมน์ CREATED ให้ตรวจสอบผลลัพธ์การ build และ image ID ที่ deploy ด้วย เพราะ timestamp ของการสร้างเพียงอย่างเดียวไม่สามารถยืนยันได้ว่ามีการสั่ง rebuild จริงหรือไม่
หากคุณยังอยู่ในขั้นตอนการเขียนไฟล์ที่ใช้ตรวจสอบเหล่านี้ พื้นฐานของไฟล์ Compose บน VPS จะครอบคลุมถึง key ต่างๆ ที่เกี่ยวข้อง และ ตารางสรุปคำสั่ง Compose จะแสดงรายการคำสั่งย่อยที่เหลือทั้งหมด
FAQ
ฉันสามารถใช้ build และ image ใน service เดียวกันได้หรือไม่?
ได้ และนี่คือการตั้งค่าปกติสำหรับโปรเจกต์ที่คุณสร้างขึ้นเอง เมื่อ Compose ทำการ build จากส่วน build: มันจะแท็กผลลัพธ์ด้วยค่าของ image: หากไม่มีการระบุ pull_policy ไว้โดยเฉพาะ up จะพยายามดึง (pull) ภาพมาก่อน แท็กนั้นคือสิ่งที่ docker compose push จะส่งไปยัง registry และเป็นสิ่งที่เครื่องอื่นจะดึงไปใช้งาน หากไม่มีคีย์ image: ตัว Compose ก็ยังคง build ได้ แต่จะตั้งชื่อ image ตามชื่อโปรเจกต์และชื่อ service พร้อมกับแจ้งเตือนว่าการขาดแอตทริบิวต์นี้จะทำให้ไม่สามารถ push image ได้
ทำไม docker compose up ถึงไม่ตรวจพบการเปลี่ยนแปลงใน Dockerfile ของฉัน?
เพราะโดยปกติ up จะนำ image เดิมที่มีอยู่มาใช้ซ้ำ เว้นแต่คุณจะสั่งให้ build หรือตั้งค่า policy ที่บังคับให้ต้อง build ใหม่ มันไม่ได้เปรียบเทียบ image นั้นกับ Dockerfile หรือไฟล์ซอร์สโค้ดของคุณเพื่อตัดสินใจว่าจำเป็นต้อง build ใหม่หรือไม่ ให้รันคำสั่ง docker compose up -d --build หรือรัน docker compose build web ตามด้วย docker compose up --no-deps -d web เพื่อแทนที่ service เฉพาะตัวนั้น การตั้งค่า pull_policy: build ไว้ที่ service จะทำให้ทุกครั้งที่รัน up จะเกิดการ build ใหม่เสมอ ซึ่งเหมาะสำหรับเครื่องที่ใช้พัฒนา
ความแตกต่างระหว่าง --build และ --force-recreate คืออะไร?
--build จะทำการ build image ใหม่อีกครั้ง จากนั้นจึงสร้าง container ขึ้นมาใหม่ในกรณีที่ image มีการเปลี่ยนแปลง ส่วน --force-recreate จะบังคับให้สร้าง container ใหม่แม้ว่าการตั้งค่าและ image จะไม่ได้เปลี่ยนแปลงไปก็ตาม โดยตัวมันเองไม่ได้สั่งให้มีการ build ใหม่ หากการเปลี่ยนแปลงของคุณอยู่ในซอร์สโค้ดหรือใน Dockerfile ตัว --build คือแฟล็กที่คุณต้องการ ส่วน --force-recreate มีไว้เพื่อรีเซ็ตตัว container เอง เช่น เพื่อล้างเลเยอร์ที่เขียนได้ (writable layer) ออกไปในขณะที่ยังคงใช้ image เดิมอยู่
ฉันควร build Docker image บน VPS หรือที่อื่น?
ควร build ที่อื่นแล้วค่อยดึง (pull) tag มาใช้เมื่อเซิร์ฟเวอร์เริ่มให้บริการจริง การ build จะแย่งทรัพยากรหน่วยความจำกับแอปพลิเคชันของคุณ และเมื่อหน่วยความจำไม่เพียงพอ เคอร์เนลจะเลือกกระบวนการหนึ่งมาปิด (OOM killer) ซึ่งอาจเป็นตัวการ build หรือฐานข้อมูลของคุณก็ได้ นอกจากนี้การ build ยังทิ้งไฟล์แคชไว้บนดิสก์ แม้ว่า BuildKit จะจัดการคืนพื้นที่ให้โดยอัตโนมัติตามนโยบายการเก็บขยะ (garbage collection) ก็ตาม การ build บนเซิร์ฟเวอร์ยังคงทำได้สำหรับโปรเจกต์ขนาดเล็กที่ยังไม่มีผู้ใช้งาน และการย้ายไปทำที่อื่นในภายหลังก็ทำได้ง่ายหากคุณแยกส่วน build: ไว้ในไฟล์ Compose สำหรับการพัฒนาโดยเฉพาะ
ฉันจะหยุดไม่ให้ Docker build cache เต็มดิสก์ได้อย่างไร?
รัน docker system df เพื่อดูว่า image และ build cache ของคุณใช้พื้นที่ไปเท่าใด docker builder prune จะลบเลเยอร์ที่แคชไว้ และ docker image prune จะลบ image ที่ค้างอยู่ (dangling images) จากการ build ครั้งก่อนหน้า การเพิ่ม -a จะลบ build cache ที่ไม่ได้ใช้งานทั้งหมด หรือลบ image ทั้งหมดที่ไม่มี container ใดอ้างอิงถึงตามลำดับ อย่างไรก็ตามวิธีนี้ไม่ได้รับประกันว่าการ build ครั้งถัดไปจะเป็นการ build แบบเริ่มต้นใหม่ทั้งหมด (cold build) ห้ามตั้งเวลาทำงาน docker system prune -af --volumes บนเซิร์ฟเวอร์เด็ดขาด เพราะมันจะลบ container ที่หยุดทำงานและ anonymous volume ที่ไม่ได้ใช้งานทิ้ง ซึ่งอาจทำให้ข้อมูลในฐานข้อมูลที่เก็บไว้ใน anonymous volume สูญหายระหว่างการบำรุงรักษาได้