گردو
راهنمای استقرار React

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

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

پاسخ کوتاه

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

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

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

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

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

# دستور اجرا
npx serve -s dist -l $PORT

متغیرهای Vite در زمان build خوانده می‌شوند و معمولاً پیشوند VITE_ دارند.

استقرار از 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 قرار دارد.

چک‌لیست محیط عملیاتی برای React

  • fallback مسیرهای SPA را به index.html فعال کنید.
  • کلید محرمانه را داخل bundle مرورگر قرار ندهید.
  • API را سرویس جداگانه مستقر و CORS را محدود کنید.
  • مسیر بررسی سلامت، زمان انتظار و رفتار شروع مجدد را پیش از دریافت ترافیک واقعی آزمایش کنید.
  • داده را بیرون از فایل‌سیستم نسخه اجرایی، در «افزونه‌ها» یا «ذخیره‌سازی» ماندگار نگه دارید.
  • از بخش «استقرارها» یک «بازگشت به نسخهٔ قبلی» آزمایشی انجام دهید تا مسیر بازیابی تیم مشخص باشد.

مدیریت با Gerdoo Agents

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

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

آیا React بدون Dockerfile روی گردو اجرا می‌شود؟

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

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

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

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

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

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

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