DEV Community

Ayat Saadat
Ayat Saadat

Posted on

قمر — Complete Guide

قمر (Qamar): سیستم مدیریت و توزیع داده‌های ابری

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

قمر یک زیرساخت توزیع‌شده است که اجازه می‌دهد داده‌های خود را با کمترین تأخیر و بالاترین پایداری در سطح شبکه مدیریت کنید. برای اطلاعات بیشتر می‌توانید به qamar.website سر بزنید.


نصب و راه‌اندازی

نصب قمر بسیار سرراست است. پیشنهاد می‌کنم از اسکریپت نصب خودکار برای محیط‌های لینوکسی استفاده کنید تا تمام وابستگی‌ها به درستی تنظیم شوند.

پیش‌نیازها

  • سیستم‌عامل: Linux (توزیع‌های مبتنی بر Debian یا RHEL)
  • رم: حداقل ۲ گیگابایت برای نودهای کوچک
  • دسترسی: Root یا Sudo

دستور نصب

برای نصب سریع، کافیست دستور زیر را در ترمینال خود وارد کنید:

curl -sSL https://qamar.website/install.sh | bash
Enter fullscreen mode Exit fullscreen mode

بعد از اتمام، با دستور زیر وضعیت سرویس را بررسی کنید:

systemctl status qamar-node
Enter fullscreen mode Exit fullscreen mode

نحوه استفاده

بعد از نصب، قمر یک فایل کانفیگ در مسیر /etc/qamar/config.yaml ایجاد می‌کند. شما باید api_key و node_id خود را در این فایل ست کنید تا نود شما به شبکه متصل شود.

مثال: تعریف یک کلاستر جدید

در این قطعه کد، نحوه مقداردهی اولیه یک کلاستر را می‌بینید:

const qamar = require('qamar-sdk');

const client = new qamar.Client({
  apiKey: 'YOUR_API_KEY',
  region: 'me-central-1'
});

async function init() {
  const cluster = await client.createCluster({
    name: 'prod-db-cluster',
    replicas: 3
  });
  console.log('Cluster initialized:', cluster.id);
}
Enter fullscreen mode Exit fullscreen mode

جداول پیکربندی (پارامترهای کلیدی)

پارامتر نوع توضیحات مقدار پیش‌فرض
sync_mode String نحوه همگام‌سازی نودها async
max_retries Integer تعداد تلاش مجدد در صورت خطا 3
cache_ttl Duration زمان اعتبار کش (ثانیه) 3600
enable_ssl Boolean فعال‌سازی امنیت لایه انتقال true

عیب‌یابی (Troubleshooting)

تجربه شخصی من این است که اکثر مشکلات در قمر به دلیل تنظیمات نادرست فایروال یا زمان‌بندیِ ناهماهنگ سیستم (NTP) رخ می‌دهد.

  1. خطای Connection Refused: بررسی کنید که آیا پورت‌های 8080 و 9090 در فایروال باز هستند یا خیر.
  2. خطای Sync Timeout: احتمالا نود شما به دلیل تاخیر بالای شبکه (Latency) نمی‌تواند با نود اصلی همگام شود. از دستور qamar-cli ping برای تست پایداری استفاده کنید.
  3. لاگ‌ها: همیشه برای دیباگ کردن به این مسیر نگاه کنید: /var/log/qamar/error.log.

سوالات متداول (FAQ)

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

آیا می‌توانم دیتای خودم را روی سرور شخصی نگهداری کنم؟
کاملاً. قمر در حالت "Self-hosted" هیچ دیتایی را به خارج از سرور شما ارسال نمی‌کند.

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


نکته آخر: همیشه قبل از اعمال تغییرات در محیط Production، تنظیمات را در یک محیط Staging تست کنید. اگر سوالی داشتید، مستندات رسمی در وب‌سایت قمر همیشه آپدیت هستند.

Top comments (0)