حاوية JavaScript: Docker لتطبيقات Node.js والواجهة الأمامية

لماذا يستحق مشروع JavaScript الخاص بك استخدام Docker؟

هل سمعت يومًا عبارة: "كان كل شيء يعمل على جهازي!"؟ إذا كنت مطور JavaScript، فمن المحتمل أنك واجهت موقفًا حيث يعمل التطبيق بشكل مثالي محليًا، لكنه يتعطل على الخادم أو على جهاز زميلك مع خطأ غامض. حاوية تطبيقات JavaScript باستخدام Docker تحل هذه المشكلة نهائيًا.

يتيح لك Docker حزم الكود الخاص بك، وجميع التبعيات (حزم npm)، ومتغيرات البيئة، وحتى إصدار Node.js في "حاوية" خفيفة الوزن. ستعمل هذه الحاوية بنفس الطريقة على جهاز الكمبيوتر المحمول الخاص بك، وعلى خادم AWS، وعلى كمبيوتر مبتدئ قام بتثبيت Git للتو. في هذه المقالة، سنشرح كيفية جعل JavaScript و Docker يعملان معًا، وسنكتب كودًا حقيقيًا وننشئ صورة جاهزة للإنتاج لمشروعك الشخصي التالي.

أساسيات Docker لمطور JavaScript

قبل الغوص في الكود، دعنا نفهم المفاهيم الأساسية. Docker يشبه الآلة الافتراضية، لكنه أخف بكثير. بدلاً من محاكاة نظام تشغيل كامل، يستخدم نواة المضيف ويعزل تطبيقك فقط.

Dockerfile — وصفة تطبيقك

هذا ملف نصي تصف فيه كيفية بناء الصورة. بالنسبة لتطبيق Node.js، يبدو Dockerfile النموذجي كالتالي:

# نستخدم الصورة الرسمية لـ Node.js\nFROM node:18-alpine\n\n# نحدد دليل العمل داخل الحاوية\nWORKDIR /app\n\n# ننسخ ملفي package.json و package-lock.json\nCOPY package*.json ./\n\n# نثبت التبعيات\nRUN npm ci --only=production\n\n# ننسخ الكود المصدري\nCOPY . .\n\n# نفتح المنفذ\nEXPOSE 3000\n\n# الأمر لتشغيل التطبيق\nCMD ["node", "server.js"]

لاحظ: نقوم أولاً بنسخ package.json، ثم الكود بأكمله. هذا ليس من قبيل الصدفة. يقوم Docker بتخزين الطبقات مؤقتًا، وإذا لم تقم بتغيير التبعيات، فلن يتم إعادة تشغيل مرحلة npm ci مع كل تغيير في الكود. هذا يسرع عملية البناء بشكل كبير.

الصور والحاويات

\n
• الصورة (Image) — هي قالب. تقوم ببنائها مرة واحدة.
\n
• الحاوية (Container) — هي نسخة قيد التشغيل من الصورة. يمكنك إنشاء 10 حاويات من صورة واحدة.
\n

إنشاء تطبيق Node.js من الصفر ووضعه في حاوية

دعنا نكتب تطبيق Express بسيط ونضعه في Docker. ستكون هذه خطوتنا العملية الأولى في حاوية JavaScript.

الخطوة 1: كتابة التطبيق

أنشئ مجلدًا باسم docker-node-app وداخله ملفًا باسم server.js:

const express = require('express');\nconst app = express();\nconst PORT = process.env.PORT || 3000;\n\napp.get('/', (req, res) => {\n  res.json({ \n    message: 'مرحبًا من الحاوية!',\n    nodeVersion: process.version,\n    environment: process.env.NODE_ENV || 'development'\n  });\n});\n\napp.listen(PORT, () => {\n  console.log(`الخادم يعمل على المنفذ ${PORT}`);\n});

قم بتهيئة npm وتثبيت express:

npm init -y\nnpm install express

الآن لدينا تطبيق يعمل. قم بتشغيله محليًا: node server.js. افتح http://localhost:3000 — سترى JSON.

الخطوة 2: إنشاء Dockerfile

أنشئ ملفًا باسم Dockerfile (بدون امتداد) في جذر المشروع:

FROM node:18-alpine\nWORKDIR /app\nCOPY package*.json ./\nRUN npm ci --only=production\nCOPY . .\nEXPOSE 3000\nCMD ["node", "server.js"]

أضف ملف .dockerignore لتجنب نسخ الملفات غير الضرورية إلى الصورة:

node_modules\nnpm-debug.log\n.git\n.gitignore\n.env\nDockerfile

الخطوة 3: البناء والتشغيل

افتح الطرفية في مجلد المشروع ونفذ:

docker build -t my-node-app .\ndocker run -p 3000:3000 my-node-app

العلم