Render

يُربط Render بمفتاح API من إعدادات حسابك. يُشفَّر مفتاحك قبل تخزينه، ولا يراه الوكيل أبداً.

الإعداد

1. افتح Render Dashboard، وانتقل إلى Account Settings → API Keys.
2. انقر Create API Key.
3. انسخ المفتاح والصقه في Polylane.
4. يتحقق Polylane من المفتاح ويبدأ المزامنة.

يكتشف Polylane خدمات الويب والخدمات الخاصة وعمال الخلفية ومهام cron وقواعد البيانات وموارد Render الأخرى لديك.

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

خطأ "Invalid API key"

• تأكد من أنك نسخت المفتاح كاملاً (يبدأ بـ rnd_).
• تحقق من أن المفتاح لم يُلغَ في لوحة تحكم Render.
• تأكد من أنك تستخدم مفتاح API، لا رمز deploy hook.

موارد مفقودة

• قد يستغرق Render بضع دقائق لمزامنة كل شيء.
• أطلق Sync يدوياً من رأس الحساب للتحديث.

الفصل

افصل الحساب في Polylane، ثم ألغِ مفتاح API من لوحة تحكم Render.

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

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

• مفتاح API من Polylane بنطاقَي cloud_accounts:write وcloud_accounts:read. انظر مفاتيح API وOAuth.
• معرّف مساحة عملك، الذي يبدأ بـ ws_. اقرأه من GET /v1/workspaces بالمفتاح نفسه.
• مفتاح API من Render (يبدأ بـ rnd_) من Account Settings → API Keys.

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

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "render",
    "workspaceId": "ws_0abc123",
    "apiKey": "rnd_..."
  }'

يربط استدعاء واحد كل مساحة عمل Render يستطيع المفتاح الوصول إليها؛ مرّر ownerId الاختياري (usr-… أو tea-…) لربط واحدة فقط.

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

{
  "success": true,
  "result": {
    "provider": "render",
    "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"

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