پرش به مطلب اصلی

ریجن‌های استقرار

ریجن (Region) دیتاسنتری است که اپلیکیشن‌ها و پایگاه‌های داده شما روی آن اجرا می‌شوند.

ریجن فعلی​

ابرکلیک در حال حاضر یک ریجن در دسترس دارد:

ریجنمکانSlug
تهرانایرانir-thr-1

این ریجن به‌صورت پیش‌فرض برای تمام پروژه‌ها، اپلیکیشن‌ها و پایگاه‌های داده استفاده می‌شود.

توسعه آینده

ریجن‌های بیشتر (مثلاً شهرهای دیگر یا کشورهای همسایه) در نقشه راه ابرکلیک قرار دارند. در حال حاضر تمام منابع در تهران میزبانی می‌شوند.

🖼️
نقشه ریجن‌های ابرکلیکplaceholder — تصویر را اینجا جایگزین کنید

مشاهده ریجن‌های در دسترس​

از طریق CLI​

abrclick region list

خروجی:

📍 Available regions:
  • ir-thr-1  Tehran, Iran  (active)

از طریق API​

curl https://api.abrclick.ir/v1/regions \
  -H "Authorization: Bearer <token>"

پاسخ:

{
  "data": [
    {
      "id": "uuid",
      "slug": "ir-thr-1",
      "name": "Tehran",
      "country": "Iran",
      "enabled": true
    }
  ],
  "status": 200
}

تنظیم ریجن پیش‌فرض​

ریجن پیش‌فرض ir-thr-1 است و نیازی به تغییر ندارید، اما برای استفاده در آینده می‌توانید ریجن را در فایل پیکربندی محلی ذخیره کنید:

abrclick region select ir-thr-1

این ریجن در فایل ~/.abrclick/config.json ذخیره می‌شود.

استفاده از ریجن هنگام ایجاد منابع​

ایجاد اپلیکیشن​

abrclick deploy --region ir-thr-1

اگر --region مشخص نشود، ریجن پیش‌فرض (ir-thr-1) استفاده می‌شود.

ایجاد پایگاه داده​

abrclick db create my-postgres --type postgresql --region ir-thr-1

از طریق API​

curl -X POST https://api.abrclick.ir/v1/projects/{projectId}/apps \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-app",
    "region": "ir-thr-1",
    "runtime": "nodejs"
  }'

Latency و انتخاب ریجن​

ریجن تهران (ir-thr-1) بهینه‌ترین latency را برای کاربران در ایران فراهم می‌کند:

  • از تهران: ~5-10ms
  • از شهرهای بزرگ ایران: ~10-20ms
  • از کشورهای همسایه: ~50-100ms
توصیه

اگر اکثر کاربران شما در ایران هستند، ریجن تهران بهترین گزینه است.

Multi-Region (آینده)​

در حال حاضر ابرکلیک از استقرار چند ریجن پشتیبانی نمی‌کند. این ویژگی در نقشه راه است:

  • استقرار Multi-Region: یک اپ روی چند ریجن
  • Load Balancing جغرافیایی: هدایت کاربر به نزدیک‌ترین ریجن
  • Database Replication: پایگاه داده اصلی-رپلیکا بین ریجن‌ها

فعلاً برای HA (High Availability)، اپلیکیشن‌های شما با autoscale و health check در خوشه Kubernetes ریجن تهران اجرا می‌شوند.

رفع خطاهای رایج​

REGION_NOT_FOUND — ریجن نامعتبر​

علت: slug ریجن اشتباه وارد شده (مثلاً us-east-1 یا eu-west-1).

راه‌حل: از ir-thr-1 استفاده کنید. ریجن‌های دیگر هنوز موجود نیستند.

abrclick region list  # لیست ریجن‌های معتبر

REGION_DISABLED — ریجن غیرفعال است​

علت: ریجن به‌صورت موقت غیرفعال شده (مثلاً برای تعمیرات).

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

CLI ریجن پیش‌فرض را تشخیص نمی‌دهد​

علت: فایل ~/.abrclick/config.json وجود ندارد یا خالی است.

راه‌حل:

abrclick region select ir-thr-1

یا ریجن را صریح در دستور مشخص کنید:

abrclick deploy --region ir-thr-1

مطالب مرتبط​