پرش به مطلب اصلی

پیش‌نیازها

قبل از نصب CLI و ایجاد اولین پروژه، لازم است محیط توسعه خود را آماده کنید. در این صفحه تمامی پیش‌نیازهای موردنیاز برای اجرای پروژه‌های DorNext را بررسی می‌کنیم.

سیستم مورد نیاز​

اطمینان حاصل کنید که محیط توسعه شما حداقل الزامات زیر را برآورده می‌کند:

  • Node.js: حداقل نسخه 20.9+
  • Pnpm: حداقل نسخه 11+
  • سیستم‌عامل‌ها: macOS، ویندوز (شامل WSL) و لینوکس

نسخه‌های موردنیاز پروژه​

پروژه‌های ایجادشده توسط CLI بر پایه نسخه‌های زیر هستند:

  • React.js: حداقل نسخه 19+
  • Next.js: حداقل نسخه 16+

نصب گواهی امنیتی (CRT)​

برای دسترسی به سرویس‌های داخلی سازمان (مانند Nexus، GitLab و رجیستری npm داخلی)، لازم است گواهی امنیتی (SSL Certificate) روی سیستم شما نصب شده باشد.

در صورت نصب نبودن این گواهی، ممکن است هنگام اتصال به سرویس‌های داخلی با خطاهایی مانند موارد زیر مواجه شوید:

  • SELF_SIGNED_CERT
  • unable to verify the first certificate
  • unable to verify leaf signature

دانلود گواهی​

آخرین نسخه گواهی را از این لینک دانلود کنید.

هشدار

این فایل فقط برای استفاده داخلی سازمان است و نباید در اختیار خارج از شرکت قرار گیرد.

نصب در Windows​

  1. روی فایل dornica-co.local.crt دابل‌کلیک کنید.
  2. گزینه Install Certificate را انتخاب کنید.
  3. گزینه Local Machine را انتخاب کرده و Next را بزنید.
  4. گزینه Place all certificates in the following store را انتخاب کنید.
  5. مسیر زیر را انتخاب کنید:
Trusted Root Certification Authorities
  1. مراحل نصب را تکمیل کرده و سیستم را یک‌بار ری‌استارت کنید.

نصب در Linux (Ubuntu / Debian)​

روش پیشنهادی​

sudo curl -L https://tools.admin.dornicafile.ir/dornica-co.local.crt \
  -o /usr/local/share/ca-certificates/dornica-co.local.crt

sudo update-ca-certificates

روش دستی​

sudo cp dornica-co.local.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates

نصب در macOS​

  1. فایل dornica-co.local.crt را باز کنید.
  2. آن را به System Keychain اضافه کنید.
  3. روی گواهی دابل‌کلیک کنید.
  4. بخش Trust را باز کنید.
  5. گزینه Always Trust را انتخاب کنید.
  6. رمز عبور سیستم را وارد کنید.

بررسی نصب صحیح​

Windows​

مرورگر خود را باز کرده و آدرس زیر را وارد کنید:

http://nexus.dornica-co.local

اگر صفحه بدون هشدار مربوط به Certificate یا SSL باز شد، نصب گواهی با موفقیت انجام شده است.

Linux / macOS​

curl -I http://nexus.dornica-co.local:8081

اگر پاسخ بدون خطای SSL دریافت شد، نصب گواهی با موفقیت انجام شده است.

تنظیم رجیستری داخلی (Nexus)​

برای نصب پکیج‌ها و ابزارهای داخلی سازمان، لازم است رجیستری npm داخلی را روی سیستم خود تنظیم کنید.

npm config set registry https://nexus.dornicafile.ir/repository/npm/

برای بررسی صحت تنظیمات رجیستری:

npm config get registry

خروجی باید مشابه مقدار زیر باشد:

https://nexus.dornicafile.ir/repository/npm/

پس از انجام مراحل این صفحه، محیط توسعه شما آماده است و می‌توانید در صفحه نصب و راه‌اندازی، CLI را نصب کرده و اولین پروژه خود را ایجاد کنید.