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

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

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

## پشتیبانی

- Stack: HTML/CSS/JS، Vite و Static Generators
- فایل dependency: فایل‌های آماده یا package.json ابزار build
- صفحه محصول: https://gerdoo.cloud/products/static-sites

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

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

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

پوشه خروجی ممکن است dist، build، out یا public باشد؛ آن را مطابق پروژه تنظیم کنید.

## استقرار از 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
```

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

- برای SPA fallback را فعال کنید.
- دارایی‌های hash‌شده را با cache طولانی سرو کنید.
- فرم و API نیازمند سرویس backend جدا هستند.
- مسیر بررسی سلامت، زمان انتظار و شروع مجدد را آزمایش کنید.
- داده را در «افزونه‌ها» یا «ذخیره‌سازی» ماندگار نگه دارید.
- از بخش «استقرارها» بازگشت به نسخه قبلی را آزمایش کنید.

## Gerdoo Agents

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

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