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

> مخزن پروژه را به PaaS گردو متصل کنید یا داخل پوشه پروژه `gerdoo deploy` را اجرا کنید. گردو ساخت، اجرای سرویس، دامنه موقت، SSL، لاگ و نسخه‌های انتشار را مدیریت می‌کند.

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

## پشتیبانی

- Stack: Express، NestJS و Fastify
- فایل dependency: package.json و lockfile مربوط به npm، yarn یا pnpm
- صفحه محصول: https://gerdoo.cloud/products/nodejs

## فرمان‌های معمول

```bash
# دستور ساخت
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

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

## چک‌لیست محیط عملیاتی

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

## Gerdoo Agents

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

- [همه راهنماها](https://gerdoo.cloud/guides)
- [مستندات CLI](https://gerdoo.cloud/support/docs/cli)
- [راهنمای Agents](https://gerdoo.cloud/support/docs/cli/agents)