VPS-এ Docker Compose: build বনাম image বুঝুন
Docker Compose-এ image শুধু image বেছে নেয়, build image তৈরি করে। Dockerfile বদলালেও compose up কেন তা উপেক্ষা করে এবং VPS-এ সমাধান কী, তা জানুন।
Docker Compose-এ build বনাম image: সংক্ষিপ্ত উত্তর
একটি Docker Compose ফাইলে image: ব্যবহার করার জন্য image নির্ধারণ করে। এতে local image, tag অথবা digest reference থাকতে পারে। build: source থেকে image কীভাবে build করতে হবে, তা Compose-কে জানায়। শুধু image: সেট করলে Compose pull_policy অনুযায়ী image ব্যবহার করে অথবা pull করে। শুধু build: সেট করলে Compose কনফিগার করা builder ব্যবহার করে image build করে। তখন project name এবং service name থেকে তৈরি একটি নাম image-কে দেওয়া হয়। দুটিই সেট করলে Compose pull করবে নাকি build করবে, তা pull_policy নিয়ন্ত্রণ করে। build করার সময় ফলাফলকে image:-এ দেওয়া নাম দিয়ে tag করা হয়। এভাবেই নিজের পছন্দের নামে একটি image build করে push করা যায়। Builder local পরিবেশে অথবা remote Docker host-এ চলতে পারে।
এটাই মূল পার্থক্য। নিচের অংশে সার্ভারে এর কার্যপ্রণালীর বিস্তারিত ব্যাখ্যা করা হয়েছে। এখানে ধরে নেওয়া হয়েছে যে Docker Engine এবং Compose plugin আগে থেকেই ইনস্টল করা আছে; VPS-এ Docker চালানো অংশে সেই বিষয়টি ব্যাখ্যা করা হয়েছে।
সম্পূর্ণ তিনটি রূপ
ডিফল্ট pull policy অনুযায়ী একটি প্রকাশিত tag ব্যবহার করুন। tag অনুপস্থিত থাকলে এটি pull করা হবে। কোনো পর্যায়েই Dockerfile ব্যবহৃত হয় না।
services:
web:
image: nginx:1.27
restart: unless-stopped
ports:
- "80:80"প্রকল্পের directory-তে থাকা Dockerfile থেকে build করুন। Dockerfile-এর জন্য প্রয়োজনীয় image pull করা এবং dependency download করাও build-এর সময় হতে পারে।
services:
web:
build: .
restart: unless-stopped
ports:
- "80:80"ফলাফলটি docker compose build দিয়ে build ও tag করুন; explicit pull policy না থাকলে, build করার আগে up এই image pull করার চেষ্টা করে। এরপর docker compose push ওই exact tag-টি registry-তে পাঠাতে পারে।
services:
web:
build:
context: .
dockerfile: Dockerfile
image: registry.example.com/acme/web:1.4.2
restart: unless-stopped
ports:
- "80:80"context হলো builder-এর কাছে পাঠানো directory। dockerfile এই context-এর relative path হিসেবে resolve হয়, তাই dockerfile: docker/prod.Dockerfile সহ context: . ব্যবহার করা স্বাভাবিক ও সঠিক। প্রতিটি service container-এর পেছনে থাকা image name ও image ID দেখতে docker compose images চালান; service-টি image:, build: অথবা উভয়ই ব্যবহার করছে কি না নিশ্চিত করতে Compose file পরীক্ষা করুন।
docker compose up চালানোর পর Dockerfile পরিবর্তন করলেও কেন পুনর্নির্মাণ হয় না?
কারণ সাধারণ up একটি বিদ্যমান image পুনরায় ব্যবহার করে, যদি না আপনি build করার অনুরোধ জানান বা এমন policy configure করেন, যাতে build আবশ্যক হয়।
যে service-এ শুধু build: section থাকে, Compose চালু হওয়ার সময় বিদ্যমান image থাকলে সেটিই ব্যবহার করে। এটি আপনার Dockerfile পড়ে না, source file-এর তুলনা করে না এবং কোনো timestamp-ও পরীক্ষা করে না। image: ও build: দুটিই থাকলে এবং স্পষ্টভাবে pull_policy নির্ধারণ না করলে, Compose প্রথমে image pull করার চেষ্টা করে। Registry বা platform cache-এ image না থাকলে এটি build করে। Image উপস্থিত থাকলেই তা যথেষ্ট বলে বিবেচিত হয়।
তাই আপনি app.py সম্পাদনা করে docker compose up -d চালান, Compose container-কে running হিসেবে দেখায়, কিন্তু পুরোনো code serve হয়। কোনো কাজ ব্যর্থ হয়নি, তাই কোনো সতর্কতাও দেখানো হয়নি। Compose container-এর নামের পাশে যে status word দেখায়, সেটিই মূল ইঙ্গিত। Compose কোনো container প্রতিস্থাপন করলে সেটি recreated বা started হিসেবে দেখায়। আর Compose কোনো container অপরিবর্তিত রাখলে সেটি running হিসেবে দেখায়।
দুটি পরীক্ষা করলেই বিষয়টি নিশ্চিত হবে। docker compose images প্রতিটি container যে image ব্যবহার করছে তার ID দেখায়। তাই deploy-এর আগে ID লিখে রাখুন এবং পরে সেটির সঙ্গে তুলনা করুন। docker image ls-এ CREATED column থাকে। তবে cached build এবং reproducible timestamp ব্যবহৃত হলে শুধু ওই তারিখ দেখে আপনার সর্বশেষ source build হয়েছে কি না নিশ্চিত হওয়া যায় না।
কোন flags rebuild বাধ্যতামূলক করে
docker compose up -d --buildপ্রথমে build করে, তারপর যেসব container-এর image পরিবর্তিত হয়েছে সেগুলো পুনরায় তৈরি করে। বেশিরভাগ ক্ষেত্রে এটিই প্রত্যাশিত flag।docker compose build webএকটি service build করে, কিন্তু কোনো কিছু start করে না। এর পরেdocker compose up --no-deps -d webব্যবহার করলে শুধু ওই container প্রতিস্থাপিত হয় এবং stack-এর বাকি অংশ চলতে থাকে।docker compose build --no-cache webcached layer ব্যবহার না করে service rebuild করে।docker compose build --pullFROM-এ ব্যবহৃত base image-এর নতুন সংস্করণ pull করার চেষ্টা করে। তাইnode:22-এর মতো moving tag March-এ download করা copy-এর বদলে তার বর্তমান contents সংগ্রহ করে।docker compose up -d --force-recreateconfiguration এবং image অপরিবর্তিত থাকলেও container পুনরায় তৈরি করতে বাধ্য করে। এই flag নিজে build-এর অনুরোধ করে না। তবে image অনুপস্থিত হলে বা pull policy তা প্রয়োজন করলেupতবুও build করতে পারে। আপনার উদ্দেশ্য--buildহলেও এটি ব্যবহার করা সাধারণত সমস্যার সমাধান করে না।
আপনি এই সিদ্ধান্ত file-এর মধ্যেও নির্ধারণ করতে পারেন। Compose specification-এর ভাষায়, pull_policy: build অর্থ Compose image build করবে এবং image আগে থেকেই থাকলে সেটি rebuild করবে। ফলে প্রতিটি up-এ build-এর খরচ হয়। Laptop-এ এটি প্রয়োজনীয় হতে পারে, কিন্তু server-এ সাধারণত নয়।
services:
web:
build: .
image: registry.example.com/acme/web:dev
pull_policy: buildআরেকটি পারস্পরিক প্রভাব জানা দরকার। docker compose pull যেসব service-এ build section রয়েছে, সেগুলোর জন্যও image pull করার চেষ্টা করে। Pull ব্যর্থ হলে এটি জানায় যে image-টি build করতে হবে। ওই service-গুলো নীরবে বাদ দিতে --ignore-buildable দিন।
বিল্ড cache কীভাবে আপনার deploy-এর সময় নির্ধারণ করে
builder Dockerfile-এর প্রতিটি instruction পরীক্ষা করে দেখে, সেই instruction এবং তার input অপরিবর্তিত থাকলে পুনর্ব্যবহারযোগ্য cached result আছে কি না। COPY-এর ক্ষেত্রে input-এর মধ্যে file content এবং metadata থাকে, তবে modification time বাদ থাকে। কোনো layer একবার cache-এ না মিললে, তার ওপর নির্ভরশীল পরবর্তী ধাপগুলোও পুনরায় build হয়।
এই একটি নিয়মই নির্ধারণ করে আপনার 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 file সম্পাদনা করলে install layer cache-এ থাকে এবং build copy ধাপ থেকে আবার শুরু হয়। এই দুই line-এর ক্রম বদলালে একটি মাত্র character পরিবর্তনের জন্যও প্রতিটি dependency আবার install হয়, কারণ COPY . . যে layer-এর ওপর npm ci তৈরি হয়েছে সেটিকে invalid করে। একই কাঠামো pip install -r requirements.txt এবং go mod download-এর ক্ষেত্রেও প্রযোজ্য।
কোনো stale layer আপনার fix আড়াল করছে বলে সন্দেহ হলে --no-cache ব্যবহার করাই সঠিক। তবে এটিকে default হিসেবে ব্যবহার করা ঠিক নয়, কারণ এতে Dockerfile-এর সঠিক ক্রম থেকে পাওয়ার কথা থাকা cache reuse নষ্ট হয়ে যায়।
Image-এর সেট করা একটি বিষয় Compose override করতে পারে: Dockerfile-এর CMD নির্ধারণ করে image ডিফল্টভাবে কী চালাবে, আর service-এর command: key সেটিকে প্রতিস্থাপন করে। command এবং entrypoint কীভাবে একসঙ্গে কাজ করে এখানে গুরুত্বপূর্ণ, কারণ Compose override করলে সদ্য build করা image-ও পুরোনো image-এর মতোই আচরণ করতে পারে।
Build context এবং .dockerignore
context: . project directory-কে builder-এর কাছে উপলভ্য করে। কোনো exclusion না থাকলে এতে .git এবং source-এর পাশে রাখা যেকোনো data directory-ও অন্তর্ভুক্ত হয়। তবে BuildKit অব্যবহৃত file বাদ দেয় এবং পরিবর্তনগুলো incrementalভাবে transfer করে। অপরিবর্তিত project-এর build যদি transferring-context ধাপে থেমে থাকে, তাহলে বুঝতে হবে context-এর আকার অতিরিক্ত বড়।
Context-এর root-এ থাকা একটি .dockerignore file transfer থেকে path বাদ দেয়। এর syntax .gitignore-এর কাছাকাছি।
.git
node_modules
*.log
data/
.envএতে দুটি সুবিধা হয়। প্রথমত, transfer-এর আকার কমে এবং ওই file পাঠাতে কম সময় লাগে। দ্বিতীয়ত, COPY . . আর .env image-এর মধ্যে copy করতে পারে না। ফলে যে কেউ image pull করলেও সেখান থেকে এগুলো পড়ে নিতে পারে না।
সময়ের সঙ্গে বড় হতে থাকা slow-build-এর একটি সাধারণ কারণ হলো bind mount। Named volume আপনার project directory-এর বাইরে থাকে। কিন্তু ./data:/var/lib/postgresql/data-এর মতো bind mount build context-এর ভেতরে থাকে। তাই database বড় হওয়ার সঙ্গে সঙ্গে প্রতি সপ্তাহে build ধীর হয়। .dockerignore-এ একটি line যোগ করলেই এটি ঠিক হয়। Named volume-এর বিপরীতে bind mount-এ এই trade-off সম্পর্কে বিস্তারিত আলোচনা করা হয়েছে।
Build argument-এ একই ঝুঁকির ছোট একটি রূপ থাকে। args:-এর মাধ্যমে দেওয়া value image history বা provenance metadata-তে থেকে যেতে পারে। তাই সেখানে version number দিন, token কখনো নয়। Predefined proxy argument-গুলো Dockerfile-এ স্পষ্টভাবে reference না করা হলে defaultভাবে build cache এবং docker history থেকে বাদ থাকে। Credentials কোথায় রাখা উচিত, তা Compose-এ Env file এবং secret-এ আলোচনা করা হয়েছে।
VPS-এ build করবেন, নাকি অন্যত্র build করে pull করবেন?
আপনার traffic পরিবেশনকারী box-এই build করা সাধারণত default, কারণ এটিই সবচেয়ে সংক্ষিপ্ত পথ: git pull, তারপর docker compose up -d --build। এমন ছোট server-এ এটি যথেষ্ট, যার ওপর এখনো কেউ নির্ভর করছে না। তবে পরিমাপ করা যায় এমন দুটি কারণে এবং খারাপ দিনে প্রকাশ পায় এমন আরও একটি কারণে এটি আর উপযুক্ত থাকে না।
Memory। একটি build আপনার live application-এর পাশে compiler ও bundler চালায়, আর অধিকাংশ stack-এ এগুলোই সবচেয়ে বেশি memory ব্যবহার করে। 1 GB VPS-এ JavaScript bundler বা Rust compile উপলভ্য memory শেষ করে ফেলতে পারে। Memory শেষ হয়ে গেলে kernel memory use, allocation context এবং oom_score_adj-এর ওপর ভিত্তি করে একটি badness score ব্যবহার করে OOM victim নির্বাচন করে; এটি শুধু সবচেয়ে বড় process-কে বন্ধ করে না। Build Killed এবং exit status 137 দিয়ে থেমে যেতে পারে, অথবা database-ই বন্ধ হয়ে যেতে পারে এবং deploy চলাকালীন site বন্ধ হয়ে যেতে পারে। dmesg -T | grep -i oom kernel log-এ OOM message খোঁজে; এই log পড়তে permission প্রয়োজন।
Disk। Build-এর পরে image layer ও build cache থেকে যায়। docker system df এগুলোর disk use দেখায়; BuildKit-এর periodic garbage collection configured policy অনুযায়ী cache পুনরুদ্ধার করে। Dangling image-এর জন্য docker image prune এবং cached layer-এর জন্য docker builder prune ব্যবহার করে স্থান পুনরুদ্ধার করুন। Disk পুরোপুরি ভরে গেলে শুধু build বন্ধ হয় না। Database-ও লেখা বন্ধ করে, এবং এই ব্যর্থতার খরচ ধীর deploy-এর চেয়ে অনেক বেশি।
Reproducibility। Image push বা export না করলে server-এ build করা image শুধু সেই server-এই থাকে। পুরোনো image আর না থাকলে rollback করতে পুরোনো commit checkout করে আবার build করতে হয়। সেই build আগের ফল দেবে, এমন নিশ্চয়তা নেই, কারণ base tag পরিবর্তিত হয়েছে এবং package mirror-ও এর সঙ্গে পরিবর্তিত হয়েছে। অন্যত্র build করে tag push করলে rollback একটি edit-এ পরিণত হয়: image:-কে আগের tag-এ নির্দেশ করুন এবং docker compose up -d চালান।
যে arrangement দীর্ঘমেয়াদে নির্ভরযোগ্য, তা সরল। আপনার continuous integration build চালিয়ে registry.example.com/acme/web:<git-sha> push করবে, আর VPS-এর Compose file-এ image: থাকবে, কোনো build: key ছাড়াই। এরপর deployment করতে প্রায় কোনো memory লাগে না এবং মাত্র দুটি command প্রয়োজন।
docker compose pull
docker compose up -dPrivate tag pull করার credentials সংরক্ষণ করতে server-এ docker login registry.example.com চালান।
Build section মুছে না ফেলে development-এর জন্য রাখুন, এবং নিজের পছন্দের একটি file-এ সংরক্ষণ করুন।
# compose.dev.yaml
services:
web:
build:
context: .
pull_policy: builddocker compose -f compose.yaml -f compose.dev.yaml up -d --buildFileটির নাম compose.dev.yaml দিন, compose.override.yaml নয়। Compose কোনো override file উপস্থিত থাকলে সেটি স্বয়ংক্রিয়ভাবে load করে। তাই server-এ ভুল করে copy করা একটি override নীরবে সেখানে আবার build শুরু করতে পারে। একাধিক Compose file স্তরায়ন প্রতিটি key কীভাবে merge হয় তা ব্যাখ্যা করে।
অন্য পরিবেশে build করার সময় architecture-সংক্রান্ত ফাঁদ
একটি platform image যে CPU architecture-এর জন্য build করা হয়েছে, সেটি সেই architecture বহন করে। Apple Silicon laptop-এ একটি ARM image build করে push করার পর সেই image x86_64 VPS-এ ব্যবহার করলে, explicit platform না থাকলে Docker container তৈরির সময় incompatible cached image ব্যবহারের বিষয়ে সতর্ক করে। Emulation না থাকলে process exec format error দিয়ে ব্যর্থ হয়। এই বার্তাটি corrupt binary-এর মতো মনে হলেও আসলে তা নয়। Target architecture স্পষ্টভাবে নির্ধারণ করে build করুন:
docker buildx build --platform linux/amd64 \
-t registry.example.com/acme/web:1.4.2 --push .আপনার laptop x86 হলে এবং x86 VPS-এর পরিবর্তে ARM VPS চালালে বিপরীত দিকেও একই mismatch ঘটে। যে architecture-এ deploy করবেন, CI-কে সেই architecture-এ build করতে দিলে এই সমস্যা থাকে না। Multi-platform image ব্যবহার করলেও সমস্যাটি সমাধান হয়। Image pull করার সময় Docker উপযুক্ত variant নির্বাচন করে।
ডিপ্লয়ের পরে যা পরীক্ষা করবেন
docker compose imagesচলমান প্রতিটি container-এর পেছনে ব্যবহৃত image এবং tag দেখায়। image ID পরিবর্তিত হলে সেটিই প্রমাণ করে যে নতুন build কার্যকর হয়েছে।docker compose configvariable substitution-এর পরে একত্রিত file দেখায়। ফলে কিছু চালানোর আগে Compose যে চূড়ান্ত image name ব্যবহার করবে, তা পড়ে যাচাই করতে পারবেন।- swap-এর পর প্রথম আধা মিনিট
docker compose logs -f webকরুন। কোনো container শুরু হয়ে বারবার বন্ধ হলে সেটি কেবল তার restart policy অনুযায়ী পুনরায় চালু হবে; কারণ জানতে logs পরীক্ষা করুন। docker image lsএকটি CREATED column দেখায়। build output এবং deployed image ID-ও পরীক্ষা করুন, কারণ শুধু creation timestamp দেখে rebuild হয়েছে কি না নিশ্চিত হওয়া যায় না।
আপনি যদি এখনও যে file-এর বিরুদ্ধে এই checks চালাবেন সেটি তৈরি করে থাকেন, VPS-এ Compose file-এর মৌলিক বিষয়গুলো-তে সংশ্লিষ্ট keys সম্পর্কে ব্যাখ্যা আছে, এবং Compose command cheat sheet-এ বাকি subcommands-এর তালিকা আছে।
FAQ
আমি কি একই service-এ build এবং image ব্যবহার করতে পারি?
হ্যাঁ, এবং নিজে build করা project-এর জন্য এটিই স্বাভাবিক setup। Compose যখন build: section থেকে build করে, তখন এটি ফলাফলকে image:-এর value দিয়ে tag করে; নির্দিষ্ট pull_policy না থাকলে up প্রথমে pull করার চেষ্টা করে। এই tag-ই docker compose push registry-তে পাঠায় এবং অন্য machine pull করে। image: key না থাকলেও Compose build করে, তবে image-এর নাম project ও service-এর নাম অনুযায়ী দেয় এবং সতর্ক করে যে অনুপস্থিত attribute-এর কারণে image push করা যাবে না।
docker compose up আমার Dockerfile-এর পরিবর্তন কেন গ্রহণ করে না?
কারণ সাধারণ up কোনো build অনুরোধ না থাকলে বা build আবশ্যক এমন policy configure না করলে বিদ্যমান image পুনরায় ব্যবহার করে। rebuild দরকার কি না নির্ধারণ করতে এটি সেই image-এর সঙ্গে আপনার Dockerfile বা source file তুলনা করে না। docker compose up -d --build চালান, অথবা একটি service প্রতিস্থাপন করতে docker compose build web-এর পরে docker compose up --no-deps -d web চালান। service-এ pull_policy: build সেট করলে প্রতিবার up rebuild হয়, যা development machine-এর জন্য উপযোগী।
--build এবং --force-recreate-এর মধ্যে পার্থক্য কী?
--build image আবার build করে, তারপর যেসব container-এর image পরিবর্তিত হয়েছে সেগুলো recreate করে। Configuration এবং image অপরিবর্তিত থাকলেও --force-recreate container recreation বাধ্যতামূলক করে; এটি নিজে থেকে build অনুরোধ করে না। আপনার পরিবর্তন source বা Dockerfile-এ হলে --build হলো প্রয়োজনীয় flag। Container নিজেই reset করতে --force-recreate ব্যবহার করা হয়, যেমন একই image রেখে তার writable layer পরিষ্কার করতে।
আমার Docker image কি VPS-এ build করা উচিত, নাকি অন্য কোথাও?
অন্যত্র build করুন এবং machine-টি network traffic পরিবেশন শুরু করলে একবার একটি tag pull করুন। Build আপনার application-এর সঙ্গে memory-এর জন্য প্রতিযোগিতা করে। Memory শেষ হলে kernel একটি adjustable OOM score ব্যবহার করে একটি process নির্বাচন করে বন্ধ করতে পারে, যা build অথবা আপনার database-কে লক্ষ্য করতে পারে। Build disk-এ cache-ও রেখে যায়, যদিও BuildKit তার garbage collection policy অনুযায়ী স্বয়ংক্রিয়ভাবে তা reclaim করে। কোনো user না থাকা ছোট project-এর জন্য server-এ build করা ঠিক আছে। পরে সরিয়ে নেওয়াও সহজ, যদি build: section-টি development-only Compose file-এ রাখেন।
Docker build cache যাতে disk পূর্ণ না করে, তার জন্য কী করব?
আপনার image এবং build cache প্রত্যেকে কতটা space ব্যবহার করছে তা দেখতে docker system df চালান। docker builder prune cached layer সরায় এবং docker image prune আগের build-এর ফলে তৈরি dangling image সরায়। যথাক্রমে সব unused build cache অথবা container দ্বারা unreferenced সব image সরাতে -a যোগ করুন; এতে পরবর্তী build সম্পূর্ণ cold হবে—এমন নিশ্চয়তা নেই। Server-এ docker system prune -af --volumes schedule করবেন না, কারণ এটি stopped container এবং unused anonymous volume সরায়। Maintenance-এর সময় এতে anonymous volume-এ থাকা database data ঝুঁকিতে পড়ে।