گردو
راهنمای استقرار Node.js

چطور پروژه Node.js را روی گردو دیپلوی کنیم؟

راهنمای عملی استقرار Express، NestJS و Fastify روی PaaS گردو از Git یا Gerdoo CLI؛ شامل دستور ساخت، دستور اجرا، متغیرها، دامنه و نکات محیط عملیاتی.

پاسخ کوتاه

مخزن پروژه Node.js را به PaaS گردو متصل کنید یا داخل پوشه پروژه gerdoo deploy را اجرا کنید. گردو پروژه را می‌سازد، سرویس را در محیط ایزوله اجرا می‌کند و دامنه موقت، SSL، «لاگ‌ها» و مدیریت نسخه‌ها را در اختیار شما می‌گذارد.

آخرین بازبینی: ۱۴۰۵/۰۶/۱۵

پروژه را برای استقرار آماده کنید

فایل‌های وابستگی یعنی package.json و lockfile مربوط به npm، yarn یا pnpm را در مخزن ثبت کنید. مقادیر معمول فیلدهای «دستور ساخت» و «دستور اجرا» برای این استک:

# دستور ساخت
npm ci && npm run build

# دستور اجرا
npm start

سرور HTTP باید روی process.env.PORT و آدرس 0.0.0.0 گوش دهد.

استقرار از Git

  1. در پنل گردو یک پروژه و محیط بسازید.
  2. سرویس جدید را به مخزن GitHub یا GitLab و شاخه موردنظر متصل کنید.
  3. فیلدهای «دستور ساخت» و «دستور اجرا» را با ساختار واقعی پروژه تطبیق دهید.
  4. مقادیر لازم را در بخش «متغیرها» وارد و نوع زمان ساخت یا زمان اجرا را مشخص کنید.
  5. استقرار را اجرا کنید و لاگ ساخت و لاگ اجرا را تا عبور بررسی سلامت دنبال کنید.
  6. در بخش «دامنه‌ها»، دامنه اختصاصی را متصل و پاسخ HTTPS را آزمایش کنید.

استقرار از پوشه محلی با Gerdoo CLI

curl -fsSL https://get.gerdoo.cloud/install.sh | sh
gerdoo login
cd your-project
gerdoo deploy
gerdoo logs

CLI پوشه محلی را بدون نیاز به اتصال Git منتشر می‌کند. برای CI می‌توانید توکن را از محیط بخوانید و وضعیت سرویس را با خروجی JSON بررسی کنید. راهنمای کامل در مستندات CLI قرار دارد.

چک‌لیست محیط عملیاتی برای Node.js

  • نسخه Node را در engines فایل package.json ثابت کنید.
  • برای worker یک سرویس جدا با فرمان اجرای مستقل بسازید.
  • secretها را در variables قرار دهید، نه فایل .env داخل Git.
  • مسیر بررسی سلامت، زمان انتظار و رفتار شروع مجدد را پیش از دریافت ترافیک واقعی آزمایش کنید.
  • داده را بیرون از فایل‌سیستم نسخه اجرایی، در «افزونه‌ها» یا «ذخیره‌سازی» ماندگار نگه دارید.
  • از بخش «استقرارها» یک «بازگشت به نسخهٔ قبلی» آزمایشی انجام دهید تا مسیر بازیابی تیم مشخص باشد.

مدیریت با Gerdoo Agents

پس از اتصال MCP گردو، Agentهای سازگار مانند Claude Code، Cursor و Codex می‌توانند سرویس را پیدا کنند، استقرار را اجرا کنند، «ساخت‌ها» و «لاگ‌ها» را بخوانند و «متغیرها»، «دامنه‌ها» و وضعیت سرویس را مدیریت کنند. عملیات مخرب همچنان به تأیید صریح نیاز دارند. راهنمای اتصال Agents را ببینید.

سوالات پرتکرار

آیا Node.js بدون Dockerfile روی گردو اجرا می‌شود؟

بله. اگر فایل‌های استاندارد پروژه مانند package.json و lockfile مربوط به npm، yarn یا pnpm در مخزن باشند، گردو می‌تواند فرایند ساخت را تشخیص دهد. برای کنترل کامل نیز Dockerfile پشتیبانی می‌شود.

پروژه Node.js را می‌توان با CLI منتشر کرد؟

بله. داخل پوشه پروژه gerdoo deploy را اجرا کنید. نخستین اجرا سرویس را ایجاد و دفعات بعد همان سرویس را به‌روزرسانی می‌کند.

دامنه و SSL چگونه فعال می‌شوند؟

بعد از deploy یک دامنه موقت دارید. دامنه اختصاصی را از تنظیمات سرویس اضافه کنید تا گواهی SSL به‌صورت خودکار صادر شود.

متغیرهای محرمانه کجا قرار می‌گیرند؟

مقادیر محرمانه را در بخش «متغیرها»ی سرویس یا محیط ثبت کنید و آن‌ها را داخل Git، Dockerfile یا کد مرورگر قرار ندهید.