تطوير الويب

من Docker إلى المراقبة: Runbook عملي لنشر تطبيقات Node.js بثقة

Runbook هندسي مختصر لنشر تطبيق Node.js/NestJS: بناء Image، Health checks، متغيرات البيئة، Logs، Metrics، النسخ الاحتياطي، وخطة Rollback.

Mohd Morad25 يوليو 2026آخر تحديث 30 يوليو 20261 دقائق0 مشاهدة
من Docker إلى المراقبة: Runbook عملي لنشر تطبيقات Node.js بثقة
جدول المحتويات

الـ Deployment الناجح ليس الذي يظهر فيه زر أخضر فقط؛ الناجح هو الذي تستطيع مراقبته وتشخيصه والتراجع عنه بدون تخمين.

1. Image قابلة للتكرار

Dockerfile
Dockerfile
FROM node:22-alpine AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci
 
FROM node:22-alpine AS build
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build
 
FROM node:22-alpine AS runtime
WORKDIR /app
ENV NODE_ENV=production
COPY --from=build /app/dist ./dist
COPY --from=deps /app/node_modules ./node_modules
CMD ["node", "dist/main.js"]

2. Health ليس مجرد 200

افصل بين:

  • Liveness: العملية نفسها حية.
  • Readiness: التطبيق جاهز لاستقبال Traffic.
  • Dependency status: قاعدة البيانات أو Redis أو خدمات أساسية.
health-check.sh
Bash
curl --fail --silent http://127.0.0.1:3000/health/ready   || exit 1

3. ماذا أراقب؟

Signalمثال
Latencyp50 / p95 / p99
Trafficrequests per minute
Errors5xx + domain failures
SaturationCPU / memory / DB pool
Jobsqueue lag / failed jobs

4. Checklist قبل الضغط على Deploy

  • Migration backward-compatible
  • Secrets خارج Image
  • Health endpoints جاهزة
  • Backup حديث ويمكن استعادته
  • Rollback command معروف
  • Smoke test بعد النشر

5. Rollback يجب أن يكون إجراءً معروفًا

rollback-example.ps1
PowerShell

Deployments should be boring. Incidents should be diagnosable.

بعد تجهيز Runbook، اربطه بقرارات هندسة المنتج وبنية SaaS حتى يصبح التشغيل جزءًا من التصميم منذ البداية.

عن الكاتب

Mohd Morad

أوثّق هنا القرارات الهندسية والدروس المستفادة من بناء المنتجات الرقمية.

مقالات ذات صلة

الذكاء الاصطناعي ليس بديلاً للمطور: كيف أبني RAG ومساعدات AI تخدم المنتج فعلًامقال مميز
الذكاء الاصطناعيالذكاء الاصطناعي ليس بديلاً للمطور: كيف أبني RAG ومساعدات AI تخدم المنتج فعلًا

دليل عملي لدمج الذكاء الاصطناعي داخل المنتجات عبر RAG وVector Database والأتمتة، مع التركيز على القيمة والقياس بدل إضافة AI لمجرد الترند.

28 يوليو 2026· 2 دقائق قراءة· 0 مشاهدة