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

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

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

پاسخ کوتاه

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

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

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

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

# دستور ساخت
cargo build --release

# دستور اجرا
./target/release/app

نام باینری را با package پروژه هماهنگ و listener را روی 0.0.0.0:$PORT تنظیم کنید.

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

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

  • Cargo.lock را برای برنامه production در Git نگه دارید.
  • برای کاهش image از build چندمرحله‌ای استفاده کنید.
  • SIGTERM و connection drain را در shutdown مدیریت کنید.
  • مسیر بررسی سلامت، زمان انتظار و رفتار شروع مجدد را پیش از دریافت ترافیک واقعی آزمایش کنید.
  • داده را بیرون از فایل‌سیستم نسخه اجرایی، در «افزونه‌ها» یا «ذخیره‌سازی» ماندگار نگه دارید.
  • از بخش «استقرارها» یک «بازگشت به نسخهٔ قبلی» آزمایشی انجام دهید تا مسیر بازیابی تیم مشخص باشد.

مدیریت با Gerdoo Agents

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

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

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

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

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

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

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

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

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

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