قمر — Complete Guide

قمر (Qamar): راهنمای جامع و فنی

وقتی صحبت از بهینه‌سازی جریان‌های کاری در محیط‌های ابری و مدیریت زیرساخت‌های توزیع‌شده به میان می‌آید، ابزارهای زیادی را دیده‌ایم که فقط پیچیدگی اضافه می‌کنند. اما قمر متفاوت است. قمر (Qamar) یک پلتفرم متمرکز برای مدیریت و استقرار سرویس‌هاست که با تمرکز بر سادگی و کارایی برای تیم‌های فنی طراحی شده است.

اگر از درگیری با کانفیگ‌های بی‌پایان YAML و چالش‌های استقرار خسته شده‌اید، جای درستی آمده‌اید.

---

۱. نصب و راه‌اندازی (Installation)

نصب قمر بسیار سرراست است. ما سعی کردیم وابستگی‌ها را به حداقل برسانیم. برای شروع، کافی است ابزار CLI آن را دریافت کنید:

پیش‌نیازها

• Node.js نسخه ۱۸ به بالا
• یک حساب کاربری فعال در qamar.website

دستور نصب

بهترین راه برای شروع، استفاده از npm یا yarn است:

# نصب به صورت سراسری
npm install -g @qamar/cli

# یا اگر از yarn استفاده می‌کنید
yarn global add @qamar/cli

بعد از نصب، با دستور زیر وارد حساب خود شوید:

qamar login

---

۲. نحوه استفاده (Usage)

پس از لاگین، می‌توانید یک پروژه جدید را در چند ثانیه مقداردهی اولیه (Initialize) کنید.

گام اول: مقداردهی پروژه

در پوشه ریشه پروژه خود دستور زیر را بزنید:

qamar init --template node-service

گام دوم: استقرار (Deployment)

برای ارسال کد به محیط عملیاتی، فقط کافیست دستور زیر را اجرا کنید. قمر به صورت خودکار تغییرات را شناسایی و بیلد می‌کند:

qamar deploy --env production

---

۳. جدول مقایسه‌ای ویژگی‌ها

ویژگی	قمر (Qamar)	روش‌های سنتی (Manual)
سرعت استقرار	زیر ۳۰ ثانیه	۱۰ تا ۱۵ دقیقه
مدیریت لاگ	یکپارچه و هوشمند	دستی و پراکنده
مقیاس‌پذیری	خودکار (Auto-scale)	دستی (Manual-scale)
مانیتورینگ	در لحظه	نیازمند ابزار جانبی

---

۴. مثال کد (Configuration)

قمر از یک فایل ساده qamar.config.json برای مدیریت تنظیمات استفاده می‌کند. این فایل جایگزین بسیاری از پیچیدگی‌های CI/CD کلاسیک است:

{
  "project": "my-awesome-app",
  "region": "tehran-1",
  "runtime": "node-18",
  "scaling": {
    "min": 1,
    "max": 5
  },
  "env": {
    "NODE_ENV": "production"
  }
}

---

۵. عیب‌یابی (Troubleshooting)

بر اساس تجربیات تیم ما در کار با قمر، این موارد بیشترین کمک را به شما می‌کنند:

• خطای Authentication: اگر در اجرای دستورات به مشکل خوردید، ابتدا توکن خود را با qamar logout و سپس qamar login ریست کنید.
• بیلد ناموفق: فایل .qamarignore را بررسی کنید. ممکن است فایل‌های سنگین یا بی‌استفاده در پوشه node_modules باعث طولانی شدن زمان بیلد شوند.
• سرویس در دسترس نیست: وضعیت سلامت (Health Check) را در پنل کاربری چک کنید؛ گاهی اوقات تنظیم نادرست پورت در فایل کانفیگ علت اصلی است.

---

۶. پرسش‌های متداول (FAQ)

آیا قمر از دیتابیس‌های خارجی پشتیبانی می‌کند؟
بله، شما می‌توانید از طریق متغیرهای محیطی (Environment Variables) به هر دیتابیس خارجی متصل شوید.

آیا امکان rollback وجود دارد؟
قطعاً. با دستور qamar rollback می‌توانید به آخرین نسخه پایدار قبل از استقرار فعلی برگردید.

آیا استفاده از قمر برای پروژه‌های کوچک رایگان است؟
قمر یک لایه رایگان سخاوتمندانه برای توسعه‌دهندگان دارد. جزئیات بیشتر را می‌توانید در وب‌سایت رسمی مشاهده کنید.

---

نکته پایانی: اگر به مشکلی برخوردید که در این مستندات نبود، تیم پشتیبانی ما در دیسکورد همیشه آماده شنیدن چالش‌های فنی شماست. کدنویسی خوش!