SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor · আপডেট করা হয়েছে 2026-10-23

Docker Compose stack backup ও upgrade করার নিয়ম

Compose stack-এর backup-এ compose file, .env, volume contents এবং database dump রাখুন। restore প্রমাণ ও upgrade-এর আগে নিরাপদে যাচাই করার কমান্ডসহ পূর্ণ গাইড।

Docker Compose stack-এর backup-এ যা থাকতে হবে

একটি Docker Compose stack-এর backup-এ 4টি পৃথক জিনিস থাকতে হবে। এর যেকোনো একটি হারালে app আর চালু হবে না: compose file, তার পাশে থাকা .env, প্রতিটি volume-এর সম্পূর্ণ contents এবং database-এর নিজস্ব client দিয়ে লেখা database dump। Container চলার সময় database-এর file copy করা backup নয়। Upgrade-এর ক্ষেত্রেও একই তালিকা প্রযোজ্য, সঙ্গে একটি নিয়ম আছে: pull করার আগে backup নিন, কারণ schema migration সাধারণত সামনের দিকে চালানোর জন্য লেখা হয় এবং অধিকাংশ project-এ আগের অবস্থায় ফেরার কোনো ব্যবস্থা থাকে না।

নিচের সবকিছু ধরে নেওয়া হয়েছে যে stack ইতিমধ্যে deployed এবং docker compose ps-এ সেটি running দেখাচ্ছে। উদাহরণগুলোতে /srv/myapp-এ একটি project directory এবং app ও db নামে service ব্যবহার করা হয়েছে। আপনার নিজস্ব নাম বসান। Commands ইচ্ছাকৃতভাবে generic রাখা হয়েছে, কারণ গুরুত্বপূর্ণ অংশগুলো—volume এবং database—app যাই হোক একইভাবে কাজ করে।

আপনার stack আসলে কী সংরক্ষণ করে তা নির্ধারণ করুন

cd /srv/myapp
docker compose ps
docker compose config --volumes
docker volume ls --filter label=com.docker.compose.project=myapp

docker compose config --volumes আপনার file-এ ঘোষিত named volume-গুলোর সংক্ষিপ্ত নাম দেখায়। docker volume ls disk-এ ওই volume-গুলোর প্রকৃত নাম দেখায়। দুটি তালিকা আলাদা, কারণ Compose-এর আগে project name যুক্ত হয়: file-এ db_data হিসেবে লেখা volume disk-এ myapp_db_data নামে থাকে। Project name ডিফল্টভাবে directory name হয়। তাই directory-এর নাম পরিবর্তন করলে stack নতুন, খালি volume-গুলোর দিকে নির্দেশ করে এবং পুরোনোগুলো আপনার সব data-সহ disk-এ পড়ে থাকে। নিচের প্রতিটি command-এ docker volume ls থেকে পাওয়া প্রকৃত নাম ব্যবহার করতে হবে।

Bind mount কোনো তালিকাতেই দেখা যায় না। Compose file-এ colon-এর বাম পাশে host path থাকা entry-গুলোই bind mount, যেমন ./config:/app/config। এগুলো host-এর সাধারণ directory, তাই সাধারণ tool দিয়েই এগুলোতে পৌঁছানো যায়। Named volume /var/lib/docker/volumes/-এর অধীনে থাকে, এবং docker volume inspect --format '{{.Mountpoint}}' myapp_db_data একটি volume-এর সঠিক path দেখায়। আপনার stack কোন ধরনের volume ব্যবহার করে, তার ওপর copy করার পদ্ধতি বদলে যায়। bind mount এবং named volume-এর তুলনা অংশে এই trade-off বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে।

এখন পাওয়া তথ্য দুটি দলে ভাগ করুন। কিছু volume এমন state সংরক্ষণ করে যা কোনো কিছুই পুনরায় তৈরি করতে পারে না: uploaded file, generated key, database নিজে এবং user app-এ যা typed করেছে। অন্য volume-এ thumbnail ও search index-এর মতো derived data থাকে, যা app নিজেই পুনর্নির্মাণ করতে পারে। দ্বিতীয় দলটির backup রাখতে disk space ও restore time লাগে, কিন্তু এতে কোনো বাস্তব সুবিধা নেই। Redis cache volume এর সবচেয়ে স্পষ্ট উদাহরণ: এটি হারালে প্রথম request ধীর হওয়ার খরচ বহন করতে হবে।

compose file এবং .env file-এর backup নিন

দুটি file host-এ পাশাপাশি থাকে, এবং কোনোটিই কোনো volume-এর ভিতরে থাকে না। .env-এ database password, application secret এবং API token থাকে। তাই একগুচ্ছ volume-কে আবার সচল app-এ পরিণত করার জন্য এই file-টিই সবচেয়ে গুরুত্বপূর্ণ। সাধারণত এটিকে .gitignore-এও তালিকাভুক্ত করা থাকে। ফলে “আমার configuration git-এ আছে” ধরনের পরিকল্পনা সবচেয়ে গুরুত্বপূর্ণ একক file-টিকে বাদ দেয়। env file-এ secret রাখা সঠিক পদ্ধতি। তাই backup-এও এই file অন্তর্ভুক্ত করা আবশ্যক।

sudo install -d -m 700 -o "$USER" -g "$(id -gn)" /srv/backups/myapp
cp -a compose.yaml .env /srv/backups/myapp/
chmod 600 /srv/backups/myapp/.env

Stack যে সব compose file ব্যবহার করে, সেগুলোর প্রতিটি কপি করুন। শুধু প্রথম file কপি করবেন না। -f compose.yaml -f compose.prod.yaml দিয়ে চালু করা stack একইভাবে ফিরিয়ে আনতে দুটি file-ই প্রয়োজন। একাধিক compose file কীভাবে merge হয় তা নির্ধারণ করে কোন value শেষ পর্যন্ত container-এ পৌঁছাবে।

একটি সতর্কতা .env-কে volume-এর সঙ্গে যুক্ত করে। Official Postgres image খালি data directory initialize করার সময়ই শুধু POSTGRES_PASSWORD পড়ে। পরে ওই value পরিবর্তন করলে database-এর ভিতরের password পরিবর্তিত হয় না। গত মাসের volume আজকের .env-এর পাশে restore করলে app FATAL: password authentication failed for user "appuser" দিয়ে connect করতে ব্যর্থ হয়, যদিও পরীক্ষা করে দুটি file-ই সঠিক মনে হয়। একই সময়ের .env এবং volume একই backup-এ একসঙ্গে রাখুন।

নিজস্ব ক্লায়েন্ট ব্যবহার করে ডাটাবেস ডাম্প করা

একটি ডাটাবেস সার্ভার ক্রমাগত তার ফাইলগুলোতে লিখতে থাকে। সার্ভার চলাকালীন কোনো tar বা /var/lib/postgresql/data নিলে তা কিছু পেজ লেখার আগের এবং কিছু পরের কপি করে, ফলে আর্কাইভটি এমন বিভিন্ন মুহূর্তের সংমিশ্রণ হয়ে থাকে যা হয়তো পুনরায় কার্যকর (replay) করা সম্ভব নয়। একটি ডাম্প টুল একটি একক ট্রানজ্যাকশনের ভেতর থেকে তথ্য পড়ে, তাই ফাইলটি একটি সুসংগত মুহূর্তের চিত্র ধারণ করে। এই পার্থক্যটিই একটি ব্যাকআপ এবং একটি সাধারণ কপির মধ্যে মূল ব্যবধান।

docker compose exec -T db sh -c \
  'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
  > /srv/backups/myapp/db-$(date +%F).dump

-T বজায় রাখুন। এটি TTY অ্যালোকেশন বন্ধ করে দেয়; TTY সংযুক্ত থাকলে Docker আউটপুট স্ট্রিমটিকে আপনার শেলের কাছে পাঠানোর সময় রূপান্তর করে, যা একটি বাইনারি ডাম্পকে নষ্ট করে ফেলে। রিস্টোর ব্যর্থ না হওয়া পর্যন্ত আপনি এটি বুঝতে পারবেন না। সিঙ্গেল কোটগুলোও গুরুত্বপূর্ণ: এগুলো আপনার হোস্ট শেলকে $POSTGRES_USER এক্সপ্যান্ড করা থেকে বিরত রাখে, ফলে কন্টেইনারের ভেতরের শেল এটি এক্সপ্যান্ড করে এবং compose ফাইলে সেট করা মানগুলো ব্যবহার করে। -Fc কাস্টম ফরম্যাটে লেখে, যা চলার সময় কম্প্রেস হয় এবং পরবর্তীতে pg_restore কে এর ভেতর থেকে নির্দিষ্ট অবজেক্ট বেছে নেওয়ার সুযোগ দেয়।

রোল এবং সেগুলোর পাসওয়ার্ড কোনো একক ডাটাবেসের বাইরে থাকে, তাই সেগুলোও ব্যাকআপ নিন:

docker compose exec -T db sh -c 'pg_dumpall -U "$POSTGRES_USER" --globals-only' \
  > /srv/backups/myapp/globals.sql

এরপর ফাইলটি একটি ডাম্প কি না বা কোনো এরর মেসেজ কি না তা যাচাই করুন:

ls -lh /srv/backups/myapp/
head -c 5 /srv/backups/myapp/db-$(date +%F).dump

একটি কাস্টম-ফরম্যাট ডাম্প পাঁচটি বাইট PGDMP দিয়ে শুরু হয়। শূন্য বাইটের ফাইল বা pg_dump: দিয়ে শুরু হওয়া ফাইলের অর্থ হলো কমান্ডটি ব্যর্থ হয়েছে। কমান্ড চলার আগেই শেল আউটপুট ফাইলটি তৈরি করে, তাই একটি ব্যর্থ ডাম্পও একটি সঠিক নাম ও টাইমস্ট্যাম্পসহ ফাইল রেখে যায়। এটিই সবচেয়ে সাধারণ নীরব ব্যাকআপ ব্যর্থতার কারণ।

MariaDB বা MySQL-এর ক্ষেত্রে ক্লায়েন্ট পরিবর্তিত হয় কিন্তু কাজের ধরন একই থাকে:

docker compose exec -T db sh -c \
  'mariadb-dump -u root -p"$MARIADB_ROOT_PASSWORD" --single-transaction --databases "$MARIADB_DATABASE"' \
  > /srv/backups/myapp/db-$(date +%F).sql

--single-transaction রাইটারদের ব্লক না করেই InnoDB টেবিলের একটি সুসংগত ডাম্প প্রদান করে। MySQL ইমেজে কমান্ডটি হলো mysqldump এবং ভেরিয়েবলগুলো হলো MYSQL_ROOT_PASSWORD ও MYSQL_DATABASE। MariaDB ইমেজে 11.0 ভার্সন থেকে mysqldump কম্প্যাটিবিলিটি নামটি সরিয়ে ফেলা হয়েছে, তাই পুরনো স্ক্রিপ্টগুলো সেখানে ব্যর্থ হয় এবং সেগুলোর পরিবর্তে mariadb-dump প্রয়োজন হয়। মনে রাখবেন, কমান্ড লাইনে দেওয়া পাসওয়ার্ড ডাম্প চলাকালীন কন্টেইনারের প্রসেস লিস্টে দৃশ্যমান থাকে।

SQLite-এর ক্ষেত্রে বিশেষ সতর্কতা প্রয়োজন। ডাটাবেসটি একটি ফাইল হলেও সাম্প্রতিক ট্রানজ্যাকশনগুলো এর পাশে একটি আলাদা -wal ফাইলে থাকতে পারে, তাই শুধুমাত্র .db কপি করলে আপনি ডাটাবেসটিতে নতুন লেখা তথ্যগুলো পাবেন না। যদি ইমেজে ক্লায়েন্ট থাকে, তবে অ্যাপ চলাকালীন sqlite3 /data/app.db ".backup '/data/app-backup.db'" একটি সুসংগত কপি তৈরি করে। যদি ক্লায়েন্ট না থাকে, তবে কন্টেইনারটি থামিয়ে .db ফাইলটি তার -wal এবং -shm সঙ্গী ফাইলগুলোর সাথে কপি করুন।

যদি আপনার ডাটাবেস স্ট্যাকের ভেতরে না চলে হোস্ট মেশিনে চলে, তবে docker compose exec প্রিফিক্স ছাড়াই একই কমান্ডগুলো প্রযোজ্য হবে এবং আপনার পরবর্তী রিবিল্ডের আগে Docker বা হোস্ট মেশিনে ডাটাবেস চালানো বিষয়টি পড়ে নেওয়া ভালো।

ভলিউম ক্যাপচার করুন

Named volume-এর এমন কোনো host path নেই, যা হাতে সম্পাদনা করা উচিত। তাই এটি একটি সাময়িক container-এ mount করে সেখান থেকেই archive তৈরি করুন।

docker run --rm \
  -v myapp_uploads:/data:ro \
  -v /srv/backups/myapp:/backup \
  alpine:3 tar czf /backup/uploads.tar.gz -C /data .

Helper container-টি volume-কে read-only অবস্থায় /data-এ এবং আপনার backup directory-কে /backup-এ mount করে। এরপর এটি host-এর দিকে archive লিখে দেয়। --rm, tar শেষ হওয়ার সঙ্গে সঙ্গে helper-টিকে সরিয়ে দেয়। :ro গুরুত্বপূর্ণ, কারণ ভুল করে লেখা tar command তখন source-এর ক্ষতি করতে পারে না। -C /data . restore সঠিক জায়গায় হওয়ার কারণ। এটি প্রতিটি path volume root-এর সাপেক্ষে সংরক্ষণ করে। এর বদলে tar czf /backup/uploads.tar.gz /data লিখলে প্রতিটি path-এর শুরুতে data/ যুক্ত হয়। ফলে restore-এর সময় volume-এর ভিতরে /data/data তৈরি হয় এবং app একটি খালি directory দেখতে পায়। Archive-এর মালিক root হবে, কারণ container-এর ভিতরে tar root হিসেবে চলেছে। এতে সমস্যা হলে sudo chown "$USER" /srv/backups/myapp/uploads.tar.gz চালান। Restored file app পড়তে না পারলে PUID এবং PGID কীভাবে file ownership নির্ধারণ করে তা পড়ুন।

প্রতিটি named volume-এর জন্য এটি একবার চালান। Bind mount-এর জন্য কোনো container দরকার নেই: host-এ tar czf /srv/backups/myapp/config.tar.gz -C /srv/myapp/config . একই কাজ করে।

প্রতিটি volume-এর ক্ষেত্রে app বন্ধ করা প্রয়োজন কি না, তা নির্ধারণ করুন। App যদি volume-এর file সরাসরি পরিবর্তন করে, তাহলে চলমান অবস্থায় tar নিলে কোনো file লেখার মাঝপথে ধরা পড়তে পারে। Uploads directory-তে file একবার লেখা হয় এবং পরে শুধু পড়া হয়, তাই সেখানে এই ঝুঁকি কম। অন্য সব ক্ষেত্রে copy চলাকালীন সেই service-টি docker compose stop app দিয়ে বন্ধ করুন, তারপর docker compose start app চালান। stop container এবং volume রেখে দেয়, যা এই কাজের জন্য ঠিক প্রয়োজন। তাই যেকোনো একটি চালানোর আগে down এবং stop-এর পার্থক্য নিশ্চিতভাবে বুঝে নিন।

Database volume-এর tar-কে database backup হিসেবে বিবেচনা করবেন না। Dump-ই backup। বন্ধ করা database-এর volume archive দ্রুত rebuild করার জন্য উপযোগী, এর বেশি নয়।

কাজের ধাপগুলোর ক্রম

  1. Compose ফাইলগুলো এবং .env backup directory-তে কপি করুন।
  2. Database চালু থাকা অবস্থায় dump নিন।
  3. App container-এর volume সরাসরি পরিবর্তিত হলে container-টি বন্ধ করুন।
  4. প্রতিটি named volume এবং প্রতিটি bind-mount directory archive করুন।
  5. যেগুলো বন্ধ করেছিলেন সেগুলো আবার চালু করুন, তারপর docker compose ps দিয়ে নিশ্চিত করুন।
  6. Stack যে image tag এবং digest দিয়ে চলছে, সেগুলো লিখে রাখুন।
  7. পুরো backup directory এই server-এর বাইরে কপি করুন।

Step 7-ই সাধারণত পরে করার জন্য রেখে দেওয়া হয়।

সার্ভারের বাইরে কপি রাখুন

Stack-এর একই disk-এ রাখা backup আপনাকে শুধু নিজের ভুল থেকে সুরক্ষা দেয়। অন্য কোনো সমস্যা থেকে এটি সুরক্ষা দেয় না। একটি volume নষ্ট হওয়া, একটি server মুছে যাওয়া বা একটি account হারিয়ে যাওয়ার ফলে একই সময়ে উভয় কপিই নষ্ট হতে পারে। নির্ধারিত সময়সূচি অনুযায়ী directory-টি এই VPS নয় এমন storage-এ পাঠান এবং retention policy ব্যবহার করুন। VPS থেকে restic backup repository setup, retention flag এবং check command ব্যাখ্যা করে। তাই এখানে সেগুলো পুনরাবৃত্তি করার প্রয়োজন নেই।

restic pipe থেকে সরাসরি dump পড়তেও পারে। এতে plaintext database পুরোপুরি disk-এর বাইরে রাখা যায়:

docker compose exec -T db sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
  | restic backup --stdin --stdin-filename db.dump

আপনি যে tool-ই ব্যবহার করুন, schedule-টি একটি systemd timer বা cron job-এ রাখুন। Job ব্যর্থ হলে এমন কোথাও report করার ব্যবস্থা করুন, যেখানে আপনি তা দেখতে পাবেন। যে backup script-এর output কোথাও যায় না, সেটি ছয় মাস কাজ বন্ধ রেখেও কারও নজরে না পড়তে পারে।

রিস্টোর ড্রিলের মাধ্যমে ব্যাকআপ যাচাই করুন

যে ব্যাকআপ কখনো রিস্টোর করে দেখা হয়নি, তা কেবল একটি অনুমান মাত্র। নিচের ড্রিলটি মূল স্ট্যাকের পাশাপাশি একটি দ্বিতীয় স্ট্যাকে রিস্টোর করবে, যাতে প্রোডাকশন সার্ভার সচল থাকে এবং আপনার কোনো কমান্ড মূল সার্ভারে প্রভাব না ফেলে।

এর মূল কৌশল হলো প্রজেক্টের নাম। Compose ডিরেক্টরির নাম থেকে প্রজেক্টের নাম নেয় এবং প্রতিটি কন্টেইনার ও ভলিউমের সাথে তা যুক্ত করে দেয়। ব্যাকআপ ফাইলটি একটি নতুন ডিরেক্টরিতে কপি করুন, এতে রিস্টোর করা স্ট্যাকের জন্য স্বয়ংক্রিয়ভাবে আলাদা ভলিউম তৈরি হবে।

sudo install -d -m 700 -o "$USER" -g "$(id -gn)" /srv/myapp-restore
cd /srv/myapp-restore
cp /srv/backups/myapp/compose.yaml /srv/backups/myapp/.env .

কপি করা compose ফাইলটি এডিট করুন যাতে হোস্ট পোর্ট মূল স্ট্যাকের সাথে সংঘর্ষ না ঘটায়। 18080:8080-এর জায়গায় 8080:8080 ব্যবহার করুন অথবা কপি করা .env ফাইলে পোর্ট নির্ধারণকারী ভেরিয়েবলটি পরিবর্তন করুন। এরপর কোনো কিছু চালু না করেই কন্টেইনার এবং খালি ভলিউমগুলো তৈরি করুন:

docker compose create
docker volume ls --filter label=com.docker.compose.project=myapp-restore

দ্বিতীয় কমান্ডটি প্রোডাকশনের মতো একই ভলিউমের নাম দেখাবে, তবে তার আগে myapp-restore_ যুক্ত থাকবে। ভলিউমগুলো পূর্ণ করুন, ডাটাবেস আলাদাভাবে চালু করুন এবং ডাম্প ফাইলটি লোড করুন:

docker run --rm -v myapp-restore_uploads:/data -v /srv/backups/myapp:/backup \
  alpine:3 tar xzf /backup/uploads.tar.gz -C /data
docker compose up -d db
docker compose exec -T db sh -c \
  'pg_restore -U "$POSTGRES_USER" -d "$POSTGRES_DB" --clean --if-exists' \
  < /srv/backups/myapp/db-2026-08-16.dump

--clean --if-exists প্রতিটি অবজেক্ট রিক্রিয়েট করার আগে ড্রপ করে, যা রিস্টোর প্রক্রিয়াকে বারবার চালানোর উপযোগী করে। এটি ছাড়া, যেসব টেবিলে আগে থেকেই ডাটা আছে এমন ডাটাবেসে পুনরায় রিস্টোর করতে গেলে pg_restore: error: could not execute query: ERROR: relation "users" already exists এর কারণে তা বন্ধ হয়ে যাবে।

এরপর বাকি সার্ভিসগুলো চালু করুন এবং একজন ব্যবহারকারীর মতো পরীক্ষা করুন:

docker compose up -d --wait
docker compose exec -T db sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -c "\\dt"'
docker compose logs --tail=50

docker compose up -d --wait কমান্ডটি প্রতিটি সার্ভিস চালু বা হেলদি না হওয়া পর্যন্ত অপেক্ষা করে। কোনো সার্ভিস চালু হতে ব্যর্থ হলে এটি নন-জিরো এক্সিট কোড দেয়, যা এই ধাপটিকে স্ক্রিপ্টযোগ্য করে তোলে। কোনো সার্ভিস হেলদি না হলে, docker compose ps যা দেখায় না, সেই এক্সিট হওয়া সার্ভিসসহ বর্তমান অবস্থা দেখার জন্য docker compose ps -a ব্যবহার করুন। Compose healthchecks-এ এই কলামটি কী নির্দেশ করে তা ব্যাখ্যা করা হয়েছে। এরপর বিকল্প পোর্টে অ্যাপটি খুলুন এবং একটি আসল অ্যাকাউন্ট দিয়ে লগইন করুন। একটি রেকর্ড লিখুন এবং ভলিউমে থাকা একটি ফাইল খুলুন। এই দুটি বিষয়ই প্রমাণ করে যে: ডাম্প রিস্টোর হয়েছে, ভলিউম রিস্টোর হয়েছে এবং তারা একে অপরের সাথে সামঞ্জস্যপূর্ণ। যে ড্রিল শুধুমাত্র লগইন পেজ লোড হওয়া নিশ্চিত করে, তা আপনার ডাটা সম্পর্কে কোনো প্রমাণ দেয় না।

পরীক্ষা সফল হলে ড্রিলটি মুছে ফেলুন:

docker compose down -v

এটিই একমাত্র জায়গা যেখানে -v ফ্ল্যাগটি ব্যবহার করা সঠিক। প্রোডাকশন ডিরেক্টরিতে এই একই কমান্ড চালালে আপনার সংরক্ষিত ভলিউমগুলো মুছে যাবে।

কিভাবে একটি Compose stack আপগ্রেড করবেন

আপনার বর্তমান ভার্সন এবং যে ভার্সনে যেতে চান, তার মধ্যবর্তী প্রতিটি ভার্সনের রিলিজ নোট পড়ুন। সেখানে breaking এবং migration শব্দগুলো খুঁজুন। যেসব প্রজেক্ট সরাসরি অনেকগুলো মেজর ভার্সন জাম্প করা সমর্থন করে না, সেখানে তা উল্লেখ থাকে। আর কোনো মাইগ্রেশন যদি রান করতে ব্যর্থ হয়, তবে তা স্কিমার কিছু অংশ পরিবর্তনের পরেই আপনাকে জানাবে।

কোনো কিছু পরিবর্তন করার আগে আপনি বর্তমানে কী চালাচ্ছেন তা রেকর্ড করে রাখুন:

docker compose images
docker image inspect --format '{{index .RepoDigests 0}}' postgres:16.4

docker compose images প্রতিটি সার্ভিস বর্তমানে কোন ইমেজ এবং ট্যাগ ব্যবহার করছে তার তালিকা দেয়। ডাইজেস্ট (digest) হলো একমাত্র মান যা একটি ইমেজকে সুনির্দিষ্টভাবে চিহ্নিত করে, কারণ একটি ট্যাগ যেকোনো সময় অন্য কোথাও পয়েন্ট করার জন্য পরিবর্তন করা যেতে পারে।

উপরের সেকশনগুলো থেকে ব্যাকআপ নিন এবং তা সার্ভারের বাইরে কোথাও কপি করে রাখুন। এমনকি ছোটখাটো প্যাচ রিলিজের ক্ষেত্রেও এটি করুন। যেসব আপগ্রেডকে সহজ মনে করা হয়, সেগুলোর জন্যই মানুষ প্রস্তুতি নেওয়া বন্ধ করে দেয়।

এরপর compose ফাইলে ভার্সন পিন (pin) করুন, কারণ latest কোনো নির্দিষ্ট ভার্সন নয়:

services:
  db:
    image: postgres:16.4

image: postgres:latest ব্যবহার করলে, docker compose pull আজ সেই ট্যাগটি যেখানে পয়েন্ট করছে তা-ই নিয়ে আসবে এবং গতকাল আপনি কী চালাচ্ছিলেন তা জানার কোনো উপায় থাকবে না। একটি পিন করা ট্যাগ আপগ্রেডকে এমন একটি এক লাইনের এডিটে পরিণত করে যা আপনি git diff-এ পড়তে পারবেন এবং আরও একটি এডিটের মাধ্যমে আগের অবস্থায় ফিরিয়ে নিতে পারবেন। প্রজেক্টের রিলিজ পেজ থেকে সঠিক ভার্সন নিয়ে একইভাবে অ্যাপ্লিকেশনের ইমেজটিও পিন করুন।

ইমেজ পুল করুন এবং পুনরায় তৈরি করুন:

docker compose pull
docker compose up -d --wait

docker compose up -d ফাইলটিকে চলমান কন্টেইনারগুলোর সাথে তুলনা করে এবং শুধুমাত্র সেই সার্ভিসগুলোকে পুনরায় তৈরি করে যেগুলোর ইমেজ বা কনফিগারেশন পরিবর্তিত হয়েছে। এটি named volume-গুলোকে স্পর্শ করে না, তাই নতুন কন্টেইনারটি বিদ্যমান ডেটা নিয়েই শুরু হয়। এটিই এই প্রক্রিয়ার মূল উদ্দেশ্য এবং ঝুঁকিও, কারণ নতুন ভার্সনটি প্রথমবার চালু হওয়ার সময়ই সাধারণত এর স্কিমা মাইগ্রেশন সম্পন্ন হয়।

প্রক্রিয়াটি পর্যবেক্ষণ করুন:

docker compose ps -a
docker compose logs -f --tail=100 app

একটি সাধারণ docker compose ps শুধুমাত্র চলমান কন্টেইনারগুলোর তালিকা দেখায়, তাই কোনো কন্টেইনার ব্যর্থ হলে তা তালিকা থেকে হারিয়ে যায়। -a ব্যবহার করলে সেটি তালিকায় থেকে যায়, যেখানে STATUS কলামে exited (1) বা অন্য কোনো নন-জিরো কোড দেখা যায় এবং এর কারণ লগ ফাইলের শেষ লাইনগুলোতে থাকে। মাইগ্রেশন ত্রুটিগুলো সেখানে স্পষ্টভাবে দেখা যায়, যা অন্য কোথাও অদৃশ্য থাকে। লগ স্থিতিশীল হলে, লগ ইন করুন এবং এক মিনিট অ্যাপটি ব্যবহার করে দেখুন।

যদি docker compose pull কমান্ডটি no space left on device দিয়ে থেমে যায়, তবে সাধারণত পুরনো ইমেজের লেয়ারগুলোই এর কারণ। অব্যবহৃত Docker ইমেজ মুছে ফেলা (pruning) করলে জায়গা খালি হবে। আপগ্রেড সফল হওয়ার পরেই এই প্রুনিং করুন, আগে নয়; কারণ সেই পুরনো লেয়ারগুলোই দ্রুত রোলব্যাক করার জন্য প্রয়োজন হয়।

আপগ্রেড ব্যর্থ হলে যেভাবে রোলব্যাক করবেন

এখানে দুটি পরিস্থিতি রয়েছে এবং এদের খরচ ভিন্ন। যদি নতুন ভার্সনে কোনো স্কিমা পরিবর্তন না হয়, তবে রোলব্যাক করা সহজ: compose ফাইলে পুরনো ট্যাগটি পুনরায় বসিয়ে docker compose up -d কমান্ডটি চালান। এতে কন্টেইনারটি প্রতিস্থাপিত হবে, ভলিউমগুলো আগের জায়গাতেই থাকবে এবং পুরনো কোড তার লেখা ডেটা পুনরায় পড়তে পারবে।

যদি নতুন ভার্সনে স্কিমা মাইগ্রেট করা হয়ে থাকে, তবে পুরনো কোড আর তা পড়তে পারবে না। মাইগ্রেশনগুলো সাধারণত সামনের দিকে এগিয়ে যাওয়ার জন্য লেখা হয় এবং বেশিরভাগ প্রজেক্টে কোনো ডাউনগ্রেড স্ক্রিপ্ট থাকে না। ফলে পুরনো ভার্সনটি চালু হওয়ার পর যখনই কোনো রিনেম বা ডিলিট করা কলামে কুয়েরি করে, তখনই তা ব্যর্থ হয় এবং ERROR: column "avatar_url" does not exist ফরম্যাটের এরর দেখায়। এক্ষেত্রে ফিরে আসার একমাত্র উপায় হলো আপগ্রেড করার আগে নেওয়া ডাম্প ফাইলটি। পুরনো ট্যাগটি বসান, ডেটাবেস ভলিউমটি সরিয়ে ফেলুন, নতুন করে খালি ভলিউম তৈরি করুন, তাতে ডাম্পটি রিস্টোর করুন এবং সার্ভিস চালু করুন। সেই ডাম্প ফাইলটি না থাকলে ফিরে আসার কোনো উপায় নেই, আর এই কারণেই পুল করার আগে ব্যাকআপ নেওয়া জরুরি।

Postgres-এর মেজর ভার্সন আপগ্রেডের ক্ষেত্রে এটি সবচেয়ে জটিল আকার ধারণ করে। ব্যবহারকারীরা অবাক হন কারণ ব্যর্থতাটি রোলব্যাকের সময় নয়, বরং আপগ্রেডের সময়ই ঘটে। মেজর রিলিজগুলো প্রায়ই সিস্টেম টেবিলের লেআউট পরিবর্তন করে। প্রতিটি ডেটা ডিরেক্টরিতে সেটি যে মেজর ভার্সন দিয়ে তৈরি হয়েছে তার স্ট্যাম্প থাকে। ফলে অন্য কোনো মেজর ভার্সনের সার্ভার সেটি খুলতে অস্বীকার করে, যদিও ব্যবহারকারীর ডেটা ফাইলের ফরম্যাট খুব একটা পরিবর্তিত হয় না। postgres:16.4 পরিবর্তন করে postgres:17.2 করুন, docker compose up -d চালান, আর নতুন সার্ভার চালু হতে অস্বীকার করবে:

FATAL:  database files are incompatible with server
DETAIL:  The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.2.

ইমেজটি আপনার জন্য নিজে থেকে pg_upgrade চালায় না। Compose স্ট্যাকের ভেতরে সবচেয়ে সহজ উপায় হলো ডাম্প, রিপ্লেস এবং রিস্টোর পদ্ধতি: পুরনো ভার্সন চালু থাকা অবস্থায় ডাম্প নিন, docker compose down করুন, ডেটাবেস ভলিউমটি সরিয়ে ফেলুন, নতুন ট্যাগ সেট করুন, একটি নতুন খালি ডেটা ডিরেক্টরির জন্য docker compose create চালান, ডেটাবেস চালু করুন, ডাম্পটি রিস্টোর করুন এবং বাকি সার্ভিসগুলো চালু করুন। যদি নতুন ট্যাগটি 18 বা তার পরের হয়, তবে ভলিউম মাউন্টটিও সরিয়ে নিন: PostgreSQL 18 থেকে অফিসিয়াল ইমেজ তার ডেটা একটি ভার্সন-নির্দিষ্ট ডিরেক্টরিতে রাখে, যেমন /var/lib/postgresql/18/docker, এবং এর ভলিউমটি /var/lib/postgresql/data-এর পরিবর্তে /var/lib/postgresql হয়। নতুন মেজর ভার্সনটি অন্তত একদিন সফলভাবে ট্রাফিক হ্যান্ডেল না করা পর্যন্ত পুরনো ডাম্পটি রেখে দিন। একই মেজর ভার্সনের ভেতরে মাইনর আপগ্রেড, যেমন 16.4 থেকে 16.9-এর ক্ষেত্রে এসবের প্রয়োজন নেই, কারণ মাইনর রিলিজের জন্য ডাম্প ও রিস্টোরের প্রয়োজন হয় না এবং কন্টেইনারটি সরাসরি চালু হয়ে যায়।

VPS snapshot কি backup?

এগুলো backup-এর বিকল্প নয়; বরং backup-এর পরিপূরক। দুটিই ভিন্নভাবে ব্যর্থ হয়। Snapshot hypervisor স্তরে পুরো disk কপি করে। তাই আপনি backup করতে ভুলে যাওয়া অংশসহ পুরো machine কয়েক মিনিটে আগের অবস্থায় ফিরিয়ে আনতে পারেন। নির্দিষ্ট একটি কাজের জন্য এটিই সঠিক উপায়: upgrade-এর কারণে server নষ্ট হয়েছে এবং আপনি সেটিকে বিশ মিনিট আগের অবস্থায় ফিরিয়ে নিতে চান।

অন্য সব কাজের জন্য এটি দুর্বল পদ্ধতি। এর granularity পুরো machine, তাই মুছে যাওয়া একটি table উদ্ধার করতে হলে আগে কোনো জায়গায় পুরো server restore করতে হবে, তারপর সেখান থেকে table বের করতে হবে। Retention সাধারণত অল্প সময়ের হয়। কপিগুলো সাধারণত server-এর একই provider account-এ থাকে। তাই account হারালে server এবং তার snapshot দুটিই একসঙ্গে হারাতে পারেন। চলমান machine-এর snapshot নেওয়া হলে database মাঝপথে চলা write অবস্থায় ধরা পড়ে। ফলে database প্রথমবার চালু হওয়ার সময় crash recovery করে, এবং তখনও সম্পন্ন না হওয়া যেকোনো transaction হারিয়ে যায়।

দুটিই ব্যবহার করুন। Snapshot হলো upgrade window-এর জন্য undo button। Dump হলো এমন কপি, যা মুছে যাওয়া account-এর পরেও টিকে থাকে। snapshot ও backup-এর পার্থক্য কোন failure-এর ক্ষেত্রে কোনটি কার্যকর, তা ব্যাখ্যা করে। একই backup directory একটি stack নতুন VPS-এ স্থানান্তর করাকেও স্মৃতি থেকে নতুন করে তৈরি করার বদলে নিয়মিত কাজে পরিণত করে।

কী ভুল হতে পারে এবং আপনি কী দেখতে পাবেন

down-এ volumes flag। docker compose down -v ফাইলে ঘোষিত named volume-গুলো সরিয়ে দেয়, এবং Compose Volume myapp_db_data Removed লেখা একটি লাইনের মাধ্যমে তা নিশ্চিত করে। এটি পূর্বাবস্থায় ফেরানোর কোনো উপায় নেই। সাধারণ docker compose down এগুলো অপরিবর্তিত রাখে। দীর্ঘ রূপ docker compose down --volumes লিখুন, যাতে ধ্বংসাত্মক flag-টি আপনাকে সম্পূর্ণ লিখে দিতে হয়।

magic string ছাড়া dump। pg_restore: error: did not find magic string in file header বোঝায় যে ফাইলটি archive নয়। সাধারণত docker compose exec-এ -T না থাকার কারণে এটি ঘটে, কারণ TTY সংযুক্ত থাকলে stream আপনার shell-এ যাওয়ার পথে রূপান্তরিত হয় এবং binary dump নষ্ট হয়ে পৌঁছায়। -T ব্যবহার করে আবার dump নিন, তারপর head -c 5 দিয়ে প্রথম পাঁচটি byte পরীক্ষা করুন।

যে password পরিবর্তন হয় না। restore-এর পরে FATAL: password authentication failed for user "appuser" দেখা গেলে বুঝবেন .env এবং data directory ভিন্ন সময়ের। image শুধু খালি data directory তৈরি করার সময় ওই password সেট করে, তাই পরে .env সম্পাদনা করলে database-এর ভেতরে কোনো পরিবর্তন হয় না। সামঞ্জস্যপূর্ণ .env restore করুন, অথবা ALTER USER দিয়ে database-এর ভেতরে password পরিবর্তন করুন।

দ্বিতীয়, খালি volume। Docker প্রয়োজন হলে volume তৈরি করে। তাই s না থাকলে docker run -v myapp_upload:/data একটি নতুন খালি volume-এ লিখে এবং সফলতার বার্তা দেয়। এরপর docker volume ls উভয় নাম দেখায়; একটির মধ্যে কোনো data থাকে না। নাম মনে করে লেখার বদলে docker volume ls থেকে volume-এর নাম কপি করুন।

production-এ restore চালানো। /srv/myapp-restore-এর বদলে /srv/myapp-এ restore command চালালে backup দিয়ে live data overwrite হয়, এবং দুই জায়গাতেই command একই রকম দেখায়। প্রতিটি restore command চালানোর আগে pwd পরীক্ষা করুন এবং drill-টি নিজের directory-তে রাখুন।

FAQ

docker compose down কি আমার ডেটা মুছে দেয়?

না। docker compose down container এবং default network সরিয়ে দেয়, কিন্তু named volume ও bind mount অপরিবর্তিত রাখে। docker compose down -v আপনার file-এ ঘোষিত named volume সরিয়ে দেয়, এবং এটি স্থায়ী। Bind mount হলো host directory, তাই Compose কখনো সেগুলো সরায় না। অন্য সবকিছু অপরিবর্তিত রেখে backup-এর সময় শুধু service-গুলো বন্ধ করতে চাইলে docker compose stop ব্যবহার করুন।

pg_dump চালানোর পরিবর্তে কি Postgres data directory কপি করতে পারি?

শুধু container বন্ধ থাকা অবস্থায়। Server চলার সময় তার file পরিবর্তিত হয়। ফলে কপিতে বিভিন্ন সময়ের মিশ্র অবস্থা থাকতে পারে, যা পুনরায় চালু করা সম্ভব নাও হতে পারে। File-level copy একটি নির্দিষ্ট Postgres major version-এর সঙ্গেও আবদ্ধ। তাই এটি অন্য version-এর অধীনে start হবে না। Container বন্ধ করুন, volume archive করুন, আবার start করুন, এবং এটিকে দ্রুত rebuild করার পদ্ধতি হিসেবে বিবেচনা করুন; একমাত্র backup হিসেবে নয়। Dump হলো portable copy এবং restore করার জন্য ব্যবহৃত কপি।

Compose-এ Postgres-কে নতুন major version-এ কীভাবে upgrade করব?

শুধু tag পরিবর্তন করলেই হবে না। নতুন server পুরোনো data directory ব্যবহার করে start হতে অস্বীকার করে এবং The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.2 log করে। পুরোনো version চালু থাকা অবস্থায় pg_dump চালান। এরপর docker compose down চালান, database volume সরান, নতুন tag সেট করুন, খালি নতুন volume তৈরির জন্য docker compose create চালান, database start করুন এবং dump restore করুন। নতুন version বাস্তব network traffic সামলানো পর্যন্ত পুরোনো dump সংরক্ষণ করুন।

কত ঘন ঘন backup চালানো উচিত, এবং কত দিন সেগুলো সংরক্ষণ করা উচিত?

আপনি কতটা কাজ আবার করতে প্রস্তুত, তার সঙ্গে interval মিলিয়ে নিন। ব্যক্তিগত বা ছোট দলের stack-এর জন্য nightly backup উপযুক্ত। কোনো upgrade-এর ঠিক আগে একটি অতিরিক্ত manual backup নিন। Retention-এর ক্ষেত্রে এমন পর্যাপ্ত history রাখুন, যাতে দেরিতে শনাক্ত হওয়া ক্ষতিও পুনরুদ্ধার করা যায়। শুক্রবারে ধরা পড়া corrupted table-এর ক্ষেত্রে বৃহস্পতিবার রাতের copy যথেষ্ট নাও হতে পারে। restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune একটি যুক্তিসংগত প্রাথমিক policy। Schedule যাই হোক, প্রতি quarter-এ একবার সেটি থেকে restore করুন। এটি না করা পর্যন্ত আপনার backup নেই; শুধু file আছে।

Backup নেওয়ার জন্য কি পুরো stack বন্ধ করতে হবে?

সাধারণত না। Server চলাকালীন database dump consistent থাকে, তাই database-এর কোনো downtime দরকার হয় না। আসল প্রশ্ন হলো volume। App যদি শুধু file যোগ করে, যেমন uploads directory-তে, তাহলে চলমান অবস্থায় archive নেওয়া যথেষ্ট নিরাপদ। App যদি file-এর জায়গাতেই rewrite করে, তাহলে copy চলাকালীন শুধু ওই service-টি docker compose stop app দিয়ে বন্ধ করুন এবং পরে আবার start করুন। Database চালু রেখে app বন্ধ করা সাধারণত সবচেয়ে সংক্ষিপ্ত নিরাপদ window।

এই লেখাটি কি কাজে লেগেছে?