أوامر PM2 اليومية والـ Reload من غير Downtime

فك الأمر الطويل

pm2 start ./bin/www -i 8 --merge-logs --time --name ".COM::backend"

• ./bin/www: ملف التشغيل بتاع Express.
• -i 8: يعني 8 instances. ومع Node app بيحوّل لـ cluster لوحده.
• --merge-logs: كل الـ instances بيكتبوا في نفس ملف الـ out ونفس ملف الـ error، بدل ملف لكل instance برقمها.
• --time: بيحط timestamp قدام كل سطر log.
• --name: الاسم اللي هتستخدمه في باقي الأوامر.

نفس الأمر في ecosystem file

الأمر الطويل بيضيع في الـ shell history. الملف ده بيتحط في Git وأي حد يقدر يراجعه:

module.exports = {  apps: [    {      name: ".COM::backend",      script: "./bin/www",      exec_mode: "cluster",      instances: "max", // بدل 8 ثابتة      merge_logs: true,      time: true,      env: { NODE_ENV: "production", PORT: 4000 },    },  ],};

الأوامر اللي هتستخدمها كل يوم

pm2 start ecosystem.config.jspm2 list                          # كل الـ apps والـ mode والـ memorypm2 logs ".COM::backend" --lines 100pm2 monit                         # CPU وmemory لايفpm2 describe ".COM::backend"      # المسارات والـ env وعدد الـ restartspm2 scale ".COM::backend" 4       # غيّر عدد الـ workerspm2 stop ".COM::backend"pm2 delete ".COM::backend"

Restart ولا Reload؟

• pm2 restart: بيقفل الكل وبعدين يشغّلهم تاني، فبيحصل downtime ولو ثواني.
• pm2 reload: في cluster، بيشغّل worker جديد، ولما يجهز يقفل القديم، وهكذا واحد واحد. ده اللي بيخليه zero-downtime.
• في fork، reload بيبقى restart عادي.

reload بيبقى من غير downtime بشرطين

• أولًا: التطبيق يقفل بأدب. PM2 بيبعت SIGINT، فاقفل السيرفر وخلّص الـ requests اللي شغالة:

process.on("SIGINT", () => {  server.close(() => process.exit(0)); // بيستنى الـ requests المفتوحة});

• ثانيًا: الـ worker الجديد يكون جاهز قبل ما القديم يقفل. لو التطبيق بيحتاج وقت عشان يتصل بالداتابيز، استخدم wait_ready: true وابعت process.send("ready") لما يخلص.
• لو الـ worker القديم مقفلش خلال kill_timeout، PM2 بيقفله بالعافية. ولو الجديد مبعتش ready خلال listen_timeout، PM2 بيكمل برضه. وفي الحالتين ممكن requests تضيع، فاختبر الـ reload على staging.

خلّصت الفصل لما

• تفك معنى -i و--merge-logs و--time و--name
• تنقل الأمر لـ ecosystem file
• تستخدم list وlogs وmonit وdescribe
• تفرق بين reload وrestart
• تقفل السيرفر عند SIGINT
• تعرف wait_ready وkill_timeout