خطأ في NestJS Docker: لم يتم العثور على الوحدة النمطية @nestjs/cli/bin/nest.js

استكشاف مشكلات Docker وإصلاحها في NestJS Microservices

أثناء تطوير أ NestJS RestAPI المستندة إلى الخدمات الصغيرة، قد يؤدي تشغيل الخدمات داخل حاوية Docker أحيانًا إلى مشكلات غير متوقعة. تنشأ إحدى هذه المشكلات عندما يتعذر على Docker العثور على ملف @nestjs/cli/bin/nest.js الوحدة النمطية، مما يمنع تشغيل الخدمة.

تكون هذه المشكلة محبطة بشكل خاص عندما تكون قد قمت بالفعل بإعداد خدمات متعددة، مثل المصادقة والحجوزات، وتعمل على ضمان تشغيلها بسلاسة في الحاويات الخاصة بها. لقاء أ MODULE_NOT_FOUND يمكن أن يؤدي الخطأ إلى تعطيل التطوير ويتطلب استكشاف الأخطاء وإصلاحها على الفور.

غالبًا ما ترتبط المشكلة بكيفية التعامل مع التبعيات داخل حاوية Docker، خاصة عند استخدام ملف العقدة: جبال الألب الصورة الأساسية ومديري الحزم يحبونها com.pnpm. يشير سجل الأخطاء عادةً إلى وحدة نمطية مفقودة في حاوية node_modules الدليل، مما يؤثر على عملية بدء تشغيل الخدمة.

في هذا الدليل، سنتعرف على الأسباب الشائعة لهذا الخطأ، ونناقش الحلول المحتملة، ونقدم توصيات لحلها، مما يضمن تشغيل خدمات NestJS كما هو متوقع في بيئات Docker.

فهم تكامل Docker وNestJS CLI

يركز ملف Dockerfile الأول المقدم في الأمثلة على حل مشكلة MODULE_NOT_FOUND خطأ متعلق بـ NestJS CLI عند تشغيل خدمات مثل مصادقة و التحفظات. ويتم تحقيق ذلك من خلال ضمان تثبيت التبعيات العالمية اللازمة في مرحلتي التطوير والإنتاج. يبدأ ملف Dockerfile باستخدام ملف خفيف الوزن العقدة: جبال الألب الصورة، مما يساعد على تقليل الحجم الإجمالي للصورة. ثم يقوم بتثبيت مدير الحزم com.pnpm وNestJS CLI عالميًا للتأكد من توفر جميع الوحدات المطلوبة في البيئة.

بمجرد تثبيت واجهة سطر الأوامر (CLI) ومدير الحزم، يقوم البرنامج النصي بنسخ الملفات الضرورية مثل ملف package.json وملفات التكوين، والتي تعتبر ضرورية لتثبيت تبعيات المشروع. بعد تثبيت التبعيات، يتم إنشاء المشروع باستخدام الأمر بناء تشغيل pnpm، الذي يجمع التعليمات البرمجية المصدر في تنسيق قابل للتوزيع. تعد هذه الخطوة ضرورية لأنه سيتم استخدام المخرجات المترجمة في بيئة الإنتاج النهائية، مما يؤدي إلى تجنب الحمل غير الضروري من أدوات التطوير.

تستخدم المرحلة الثانية من ملف Dockerfile عملية بناء متعددة المراحل. في هذه المرحلة، يتم نسخ المخرجات المجمعة من مرحلة التطوير إلى بيئة إنتاج جديدة، مما يضمن أن الصورة النهائية خفيفة الوزن ومُحسَّنة للأداء. تساعد هذه الطريقة في الحفاظ على صورة الإنتاج صغيرة وآمنة، لأنها تحتوي فقط على ما هو ضروري لتشغيل التطبيق. ومن خلال القيام بذلك، يمنع النظام التعارضات المحتملة أو المشكلات المتعلقة بتبعيات التطوير التي يتم تضمينها في بيئة الإنتاج.

للتعامل مع بدء تشغيل التطبيق، كمد يحدد التوجيه الملف الرئيسي المطلوب تنفيذه، والذي يوجد عادةً في ملف حي الدليل بعد عملية الإنشاء. تقوم حاوية Docker بتشغيل الأمر العقدة dist/apps/auth/main.js (أو التحفظات/main.js للخدمة الأخرى)، مما يضمن تنفيذ الخدمة الصغيرة في البيئة الصحيحة. يسمح هذا الأسلوب بتوسيع نطاق بنية الخدمات الصغيرة، حيث يمكن عزل كل خدمة في حاويتها الخاصة مع إدارة جميع التبعيات بشكل صحيح. يضمن الإعداد الشامل أن يقوم Docker بتشغيل خدمات NestJS بكفاءة، مما يؤدي إلى حل مشكلات واجهة سطر الأوامر (CLI) الشائعة التي تتم مواجهتها أثناء النقل بالحاويات.

// Dockerfile - Solution 1 (Ensure Global Dependencies are Installed)FROM node:alpine AS development
WORKDIR /usr/src/app
COPY package.json pnpm-lock.yaml tsconfig.json nest-cli.json ./
RUN npm install -g pnpm @nestjs/cli  # Install NestJS CLI globally
RUN pnpm install
COPY . .
RUN pnpm run build auth
FROM node:alpine AS production
WORKDIR /usr/src/app
COPY --from=development /usr/src/app/dist ./dist
CMD ["node", "dist/apps/auth/main.js"]

// Dockerfile - Solution 2 (Install CLI during both development and production stages)FROM node:alpine AS development
WORKDIR /usr/src/app
COPY package.json pnpm-lock.yaml tsconfig.json nest-cli.json ./
RUN npm install -g pnpm @nestjs/cli  # Install CLI in dev environment
RUN pnpm install
COPY . .
RUN pnpm run build reservations
FROM node:alpine AS production
WORKDIR /usr/src/app
COPY package.json pnpm-lock.yaml ./
RUN npm install -g pnpm @nestjs/cli --prod  # Install CLI in production too
COPY --from=development /usr/src/app/dist ./dist
CMD ["node", "dist/apps/reservations/main.js"]

// jest.config.js - Unit Testsmodule.exports = {
  testEnvironment: 'node',
  moduleFileExtensions: ['js', 'json', 'ts'],
  rootDir: './',
  testRegex: '.spec.ts$',
  transform: { '^.+\\.(t|j)s$': 'ts-jest' },
  coverageDirectory: './coverage',
};

// sample.spec.ts - Check if Nest CLI is available in the Docker containerdescribe('Nest CLI Module Check', () => {
  it('should have @nestjs/cli installed', async () => {
    const { exec } = require('child_process');
    exec('nest --version', (error, stdout, stderr) => {
      expect(stdout).toContain('Nest');  // Verify CLI presence
    });
  });
});

التعامل مع وحدات العقدة في خدمات NestJS Dockerized

عند العمل مع بنية الخدمات الصغيرة في NestJS، أحد الجوانب المهمة هو التأكد من تثبيت تبعياتك وإدارتها بشكل صحيح داخل حاويات Docker. قد تؤدي بيئات الإرساء في بعض الأحيان إلى تعقيد عملية التعامل مع node_modules، خاصة عند استخدام بنيات متعددة المراحل، مما قد يؤدي إلى حدوث أخطاء مثل "لا يمكن العثور على الوحدة النمطية @nestjs/cli/bin/nest.js". ينشأ هذا الخطأ عمومًا عندما تكون الوحدات النمطية العامة مثل @nestjs/cli لم يتم تثبيتها بشكل صحيح داخل الحاوية.

لتجنب ذلك، من المهم هيكلة ملف Dockerfile بطريقة تضمن وجود جميع الوحدات الضرورية في مرحلتي التطوير والإنتاج. أحد الحلول الشائعة هو تثبيت NestJS CLI خلال كلتا المرحلتين لتجنب أي مشاكل تتعلق بالثنائيات المفقودة عند تشغيل أوامر مثل nest start أو nest build. توفر هذه الطريقة الاتساق عبر البيئات، سواء كنت تستخدم pnpm، أو npm، أو الغزل.

بالإضافة إلى ذلك، باستخدام أدوات مثل com.pnpm يمكن تحسين حجم صورة Docker وعملية تثبيت التبعية. ومع ذلك، يجب عليك أيضًا التأكد من تثبيت pnpm عالميًا، حيث يواجه العديد من المطورين مشكلات عند التبديل بين مديري الحزم المختلفين داخل حاويات Docker. قم بتنظيم تصميماتك متعددة المراحل بحيث يتم حفظ الملفات الأساسية فقط (مثل مجلد dist و node_modules) يمكن أن يساعد نسخها إلى مرحلة الإنتاج في تبسيط عملية النشر وتجنب الأخطاء الشائعة المتعلقة بالوحدات النمطية المفقودة.