Fly.io

يُربط Fly.io برمز API من لوحة التحكم الخاصة بك. استخدم أكثر أنواع الرموز تقييداً: لا يحتاج Polylane إلا إلى حق القراءة. يُشفَّر رمزك قبل تخزينه، ولا يراه الوكيل أبداً.

الإعداد

1. افتح Fly.io Dashboard وانتقل إلى Tokens.
2. أنشئ رمزاً جديداً للقراءة فقط.
3. انسخ الرمز والصقه في Polylane.
4. يتحقق Polylane من الرمز ويبدأ المزامنة.

يكتشف Polylane تطبيقاتك وأجهزتك وأحجامك وشهاداتك وموارد Fly.io الأخرى.

أنواع الرموز

الفصل

افصل الحساب في Polylane، ثم ألغِ الرمز من لوحة تحكم Fly.io تحت Tokens.

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

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

• مفتاح API من Polylane بنطاقَي cloud_accounts:write وcloud_accounts:read. انظر مفاتيح API وOAuth.
• معرّف مساحة عملك، الذي يبدأ بـ ws_. اقرأه من GET /v1/workspaces بالمفتاح نفسه.
• رمز API للقراءة فقط من Fly.io، منشأ تحت Tokens في لوحة تحكم Fly.io.

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

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

يحلّ الرمز إلى مؤسسة Fly.io واحدة، فيربط استدعاء واحد مؤسسة واحدة.

• يقرأ اكتشاف المؤسسة التطبيقات التي يستطيع الرمز رؤيتها، فيفشل الرمز الذي لا يصل إلى أي تطبيقات بالرمز 400.

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

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

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