Docker والنشر السحابي

١«يعمل على جهازي!»

تطبيقك يعمل على جهازك لأن عليه إصدارًا معيّنًا من Node، ومكتبات مثبتة، ومتغيرات بيئة. على خادم آخر قد يختلف أي منها فيتعطل. الحاوية Container تحزم التطبيق مع كل ما يحتاجه (نظام تشغيل مصغّر، و Node، والمكتبات، والكود) في وحدة واحدة تعمل بالطريقة نفسها في أي مكان فيه Docker.

٢Dockerfile لتطبيقنا الكامل

تطبيقنا جزآن: واجهة React تُبنى بـ Vite، وخادم Express يقدّم الواجهة المبنية والـ API (كما في الدرس السابق). نستخدم بناءً متعدد المراحل: مرحلة فيها أدوات البناء، ثم صورة نهائية صغيرة فيها ما يلزم للتشغيل فقط:

shop/
├── client/          ← مشروع Vite
├── server/          ← Express (server.js, routes/, models/)
├── Dockerfile
└── .dockerignore

# ---------- المرحلة 1: بناء الواجهة ----------FROM node:24-alpine AS clientWORKDIR /app/clientCOPY client/package*.json ./RUN npm ci                          # تثبيت دقيق من package-lock.jsonCOPY client/ ./RUN npm run build                   # ← /app/client/dist # ---------- المرحلة 2: صورة التشغيل ----------FROM node:24-alpineWORKDIR /appENV NODE_ENV=productionCOPY server/package*.json ./RUN npm ci --omit=dev               # مكتبات التشغيل فقطCOPY server/ ./COPY --from=client /app/client/dist ./distUSER node                           # لا تشغّل التطبيق بصلاحيات rootEXPOSE 3000HEALTHCHECK CMD wget -qO- http://localhost:3000/health || exit 1CMD ["node", "server.js"]

node_modules**/node_modulesclient/dist.env.git*.log

٣البناء والتشغيل

$ docker build -t shop:1.0 .$ docker images shop$ docker run -d --name shop -p 8080:3000 -e JWT_SECRET=طويل-وعشوائي shop:1.0$ docker ps$ docker logs -f shop$ docker stop shop && docker rm shop

٤عدة خدمات معًا: docker compose

التطبيق الحقيقي يحتاج قاعدة بيانات أيضًا. ملف compose.yaml يصف الخدمات وشبكتها ومتغيراتها، ويشغّلها كلها بأمر واحد. وفي Sequelize لا يتغير إلا الاتصال: من SQLite إلى PostgreSQL:

services:  app:    build: .    ports: ["8080:3000"]    environment:      DATABASE_URL: postgres://shop:secret@db:5432/shop      JWT_SECRET: ${JWT_SECRET}    depends_on: [db]  db:    image: postgres:17-alpine    environment:      POSTGRES_USER: shop      POSTGRES_PASSWORD: secret      POSTGRES_DB: shop    volumes: ["dbdata:/var/lib/postgresql/data"]   # البيانات تبقى بعد إيقاف الحاويةvolumes:  dbdata:

// db.js في الإنتاجconst sequelize = process.env.DATABASE_URL  ? new Sequelize(process.env.DATABASE_URL, { logging: false })     // PostgreSQL  : new Sequelize({ dialect: 'sqlite', storage: 'dev.sqlite' });    // جهازك

$ docker compose up -d --build$ docker compose logs app$ docker compose down

٥خادم جاهز للإنتاج

قبل النشر يحتاج الخادم أربعة أشياء: أن يقرأ المنفذ من البيئة (المنصات تحدده هي)، وأن يعرف أنه في الإنتاج، وأن يوفّر مسار فحص صحة تسأله المنصة دوريًّا، وألا يكشف تفاصيل الأخطاء. جرّب الفرق بين وضعي التطوير والإنتاج في صفحة الخطأ الافتراضية:

const express = require('express');const app = express();const PORT = process.env.PORT || 3000; app.get('/health', (req, res) => {  res.json({ status: 'ok', env: app.get('env'), uptime: Math.round(process.uptime()) });}); app.get('/boom', () => { throw new Error('تفاصيل داخلية سرية'); }); app.listen(PORT, () => console.log(`يعمل على ${PORT} في وضع ${app.get('env')}`));

٦النشر على منصة سحابية

منصات «المنصة كخدمة» PaaS تأخذ مستودع GitHub (أو Dockerfile) وتبنيه وتشغّله وتعطيك رابطًا بشهادة HTTPS. الخطوات العامة متشابهة:

1. ارفع المشروع إلى GitHub (بلا .env ولا node_modules).
2. أنشئ خدمة ويب جديدة في المنصة واربطها بالمستودع.
3. حدّد أمر البناء والتشغيل، أو اختر أنها تُبنى من Dockerfile.
4. أضف متغيرات البيئة: NODE_ENV و JWT_SECRET و DATABASE_URL.
5. أنشئ قاعدة بيانات مُدارة (PostgreSQL) من المنصة نفسها وانسخ عنوانها.
6. كل دفع push جديد إلى الفرع الرئيسي يعيد النشر تلقائيًّا.