في هذا المقال، سنستعرض كيفية تحويل تطبيق Next.js إلى حاوية باستخدام Docker ونشر الصورة الناتجة في سجل حاويات GitHub. هذا الدليل مناسب للمطورين الذين لديهم معرفة بـ Next.js و Docker ويرغبون في تبسيط عملية النشر.

## المتطلبات الأساسية

قبل أن نبدأ، تأكد من تثبيت التالي على جهازك:

- Node.js
- Docker
- حساب GitHub

## الخطوة 1: تكوين Next.js لإخراج مستقل

لتحويل تطبيق Next.js إلى حاوية، تحتاج إلى تكوينه لإخراج بناء مستقل. يمكن القيام بذلك عن طريق إضافة السطر التالي إلى ملف `next.config.ts`:

```javascript
  output: "standalone"
```

هذا التكوين يخبر Next.js بإنشاء بناء مستقل يتضمن جميع الملفات اللازمة لتشغيل التطبيق دون الاعتماد على واجهة سطر أوامر Next.js.

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

بعد ذلك، قم بإنشاء ملف `Dockerfile` في جذر مشروع Next.js الخاص بك. هذا الملف سيحدد الخطوات اللازمة لبناء وتشغيل التطبيق داخل حاوية Docker.

```dockerfile
# استخدام صورة Node.js الرسمية كصورة أساسية
FROM node:22-alpine AS builder

# تعيين دليل العمل داخل الحاوية
WORKDIR /app

# نسخ package.json و package-lock.json (أو yarn.lock)
COPY package*.json ./

# تثبيت التبعيات
RUN npm install --legacy-peer-deps

# نسخ بقية كود التطبيق
COPY . .

# بناء تطبيق Next.js
RUN npm run build

# استخدام صورة أصغر للمرحلة النهائية
FROM node:22-alpine AS runner

# تعيين دليل العمل
WORKDIR /app

# نسخ الملفات الضرورية فقط من مرحلة البناء
COPY --from=builder /app/package*.json ./
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/public ./public
COPY --from=builder /app/locales ./locales
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/next.config.ts ./

# تعريض المنفذ الذي يعمل عليه التطبيق (الافتراضي هو 3000 لـ Next.js)
EXPOSE 3036

# بدء التطبيق
CMD ["node", ".next/standalone/server.js"]
```

### شرح Dockerfile

1. **مرحلة البناء**:
   - نبدأ بصورة Node.js Alpine كصورة أساسية.
   - تعيين دليل العمل إلى `/app`.
   - نسخ `package.json` و `package-lock.json` إلى دليل العمل.
   - تثبيت التبعيات باستخدام `npm install`.
   - نسخ بقية كود التطبيق.
   - بناء تطبيق Next.js باستخدام `npm run build`.

2. **مرحلة التشغيل**:
   - نستخدم صورة Node.js Alpine أصغر للمرحلة النهائية لتقليل حجم الصورة.
   - تعيين دليل العمل إلى `/app`.
   - نسخ الملفات الضرورية فقط من مرحلة البناء، بما في ذلك التطبيق المبنى، الأصول العامة، اللغات، وحدات node، وملف تكوين Next.js.
   - تعريض المنفذ `3036` (أو أي منفذ آخر يعمل عليه التطبيق).
   - بدء التطبيق باستخدام `node .next/standalone/server.js`.

## الخطوة 3: بناء صورة Docker

بعد أن يصبح ملف Dockerfile جاهزًا، يمكنك بناء صورة Docker باستخدام الأمر التالي:

```bash
docker build -t ghcr.io/username/image:latest .
```

هذا الأمر يبني صورة Docker ويضع عليها علامة باسم `ghcr.io/username/image:latest`.

## الخطوة 4: نشر صورة Docker في سجل حاويات GitHub

لنشر صورة Docker في سجل حاويات GitHub، استخدم الأمر التالي:

```bash
docker push ghcr.io/username/image:latest
```

هذا الأمر يدفع صورة Docker إلى سجل حاويات GitHub، مما يجعلها جاهزة للنشر أو الاستخدام الإضافي.

## الخاتمة

تحويل تطبيق Next.js إلى حاوية ونشره في سجل حاويات GitHub هي عملية بسيطة يمكن أن تبسط بشكل كبير سير عمل النشر. باتباع الخطوات الموضحة في هذا المقال، يمكنك التأكد من أن تطبيق Next.js الخاص بك محول إلى حاوية وجاهز للنشر في أي بيئة.

في هذا المقال، سنستعرض كيفية تحويل تطبيق Next.js إلى حاوية باستخدام Docker ونشر الصورة الناتجة في سجل حاويات GitHub. هذا الدليل مناسب للمطورين الذين لديهم معرفة بـ Next.js و Docker ويرغبون في تبسيط عملية النشر.

كيفية تحويل تطبيق Next.js إلى صورة Docker ونشرها في سجل حاويات GitHub