Supabase

يُربط Supabase عبر OAuth: انقر Connect with Supabase، وفوّض حق القراءة على Supabase مع اختيار المؤسسة التي تريد ربطها، فتُعاد توجيهك مع بدء المزامنة أصلاً. تُشفَّر الرموز قبل تخزينها، ولا يراها الوكيل أبداً.

بديل رمز الوصول الشخصي

إن كنت تفضّل بيانات اعتماد طويلة الأمد، فاربط برمز وصول شخصي بدلاً من ذلك:

1. افتح Supabase، وانتقل إلى Account → Access Tokens.
2. انقر Generate new token وانسخ الرمز (يبدأ بـ sbp_).
3. الصق الرمز في Polylane. إذا كان حسابك يستطيع الوصول إلى أكثر من مؤسسة، فقدّم أيضاً slug المؤسسة التي تريد ربطها.
4. يتحقق Polylane من الرمز ويبدأ المزامنة.

يغطي كل اتصال مؤسسة Supabase واحدة. يكتشف Polylane مشاريعها مع دوال الحافة وفروع قواعد البيانات وحاويات التخزين، بما في ذلك الحالة والمنطقة وحجم الحوسبة.

استكشاف الأخطاء

خطأ "Invalid access token"

• تحقق من أن الرمز لم يُلغَ في إعدادات حساب Supabase.
• تتصرف رموز الوصول الشخصية بأذونات حسابك؛ فتأكد من أن حسابك يستطيع الوصول إلى المؤسسة.

خطأ "Multiple Supabase organizations are reachable"

• تستطيع بيانات الاعتماد الوصول إلى أكثر من مؤسسة، فسمّ المؤسسة التي تريد ربطها.
• عند الربط عبر OAuth في وحدة التحكم، اختر المؤسسة عند المطالبة بعد التفويض.
• عند الربط عبر API، عيّن حقل organization إلى slug المؤسسة.

موارد مفقودة

• قد يستغرق Supabase بضع دقائق لمزامنة كل شيء.
• تُسرد المشاريع المتوقفة مؤقتاً (غير النشطة)، لكن دوال الحافة وفروعها وحاوياتها لا تُزامَن إلا ما دام المشروع نشطاً.
• أطلق Sync يدوياً من رأس الحساب للتحديث.

الفصل

افصل الحساب في Polylane، ثم ألغِ رمز الوصول من إعدادات حساب Supabase الخاص بك.

لا يحتاج ربط Supabase إلى متصفح: نقطة النهاية نفسها التي تستدعيها وحدة التحكم تناسب مهمة CI. ينشئ طلب POST موثَّق واحد الاتصال ويبدأ المزامنة الأولى.

المتطلبات الأساسية

• مفتاح API من Polylane بنطاقَي cloud_accounts:write وcloud_accounts:read. انظر مفاتيح API وOAuth.
• معرّف مساحة عملك، الذي يبدأ بـ ws_. اقرأه من GET /v1/workspaces بالمفتاح نفسه.
• رمز وصول شخصي من Supabase (يبدأ بـ sbp_) من Account → Access Tokens. يحتاج تدفق OAuth في وحدة التحكم إلى متصفح؛ ولا تحتاج رموز الوصول إليه.

إنشاء الاتصال

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "supabase",
    "workspaceId": "ws_0abc123",
    "token": "sbp_...",
    "organization": "my-org-slug"
  }'

يربط استدعاء واحد مؤسسة Supabase واحدة.

• لا يجوز حذف organization إلا حين يصل الرمز إلى مؤسسة واحدة بالضبط؛ وإلا يفشل الاستدعاء بالرمز 400 الذي يسرد slugs المؤسسات التي يمكن الوصول إليها.

تسرد الاستجابة ما رُبط، مع المزامنة الأولى جارية أصلاً. مختصرة إلى الحقلين اللذين تقرؤهما بقية التدفق:

{
  "success": true,
  "result": {
    "provider": "supabase",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

يقع الحساب المربوط أصلاً في failures بدلاً من accounts، فلا يكرر تكرار الاستدعاء اتصالاً أبداً.

انتظار المزامنة الأولى

استطلع كل حساب مُعاد عبر id الخاص به حتى تصل status إلى ready (‏new عند التسجيل، وsyncing أثناء تدفق الموارد):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

أعطِ الحلقة موعداً نهائياً ليُفشل الربط الفاشل المهمة بدلاً من تعليقها. وبعد أن يصبح الحساب ready، تكون موارده في Topology ويكون Polylane قد بدأ فحصه الأول.

الفصل من API

يوقف حذف الاتصال كل مزامنة وفحص ويحذف بيانات الاعتماد التي احتفظ بها Polylane. يحتاج الاستدعاء إلى نطاق cloud_accounts:delete:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

ثم ألغِ بيانات اعتماد Supabase على جانب المزود، كما هو موضح تحت الفصل أدناه.