Cloudflare
ربط
يحقق Polylane في المشكلات ويشرحها من دون أن يغيّر أي شيء في حسابك أبداً.
اربط Cloudflare من الطرفية. مرّر --help للأعلام التي يقبلها Cloudflare، إضافة إلى --no-browser للبيئات بلا واجهة.
polylane cloud connect --provider cloudflareرمز API للقراءة فقط مملوك للحساب.
يُربط Cloudflare برمز API للقراءة فقط مملوك للحساب. يحقق Polylane ويشرح ما يجده من دون أن يغيّر أي شيء في حسابك أبداً؛ وحين يكون الإصلاح في الكود، يصل على شكل pull request لتراجعه. يُشفَّر رمزك قبل تخزينه، ولا يراه الوكيل أبداً.
الإعداد
- انقر Create read-only token أعلاه، أو Create API token في نموذج الاتصال في وحدة التحكم. يفتح كلاهما شاشة رموز API للحساب في Cloudflare مع تحديد كل إذن يحتاجه Polylane مسبقاً.
- اختر الحساب الذي تريد ربطه. يجب أن تكون Super Administrator على ذلك الحساب لإنشاء رمز مملوك للحساب.
- راجع الأذونات المعبَّأة مسبقاً، ثم انقر Continue to summary وCreate Token.
- انسخ الرمز والصقه في Polylane.
- يتحقق Polylane من الرمز ويبدأ المزامنة.
يجب أن تكون على Workers Paid plan لاكتشاف الموارد كاملاً.
الأذونات
ينشئ الرابط المضبوط مسبقاً رمزاً مملوكاً للحساب: كيان خدمة دائم يواصل العمل حتى إذا غادر الشخص الذي أنشأه الحساب. كل إذن للقراءة فقط، عبر الحساب كله:
- Developer Platform: Workers وKV وR2 وD1 وQueues وPipelines وHyperdrive وDurable Objects وContainers وSecrets Store وArtifacts وغيرها
- AI & Machine Learning: Workers AI وAI Gateway وAutoRAG وVectorize وAI Search
- DNS & Zones: DNS وإعدادات المناطق والمسجّل وجدار حماية DNS
- Network Services: Load Balancing وMagic Transit/WAN وSpectrum والأنفاق
- App Security: WAF ومجموعات القواعد وDDoS وإدارة bots وقواعد الصفحات والشهادات
- Cache, Email, Media, Rules, Analytics & Logs
لا شيء في الرمز يستطيع إنشاء أي شيء في حسابك أو تعديله أو حذفه: لا عمليات نشر، ولا تغييرات إعدادات، ولا تراجعات، ولا إدارة للفوترة أو رموز API. تصل المعالجة على شكل pull requests بدلاً من ذلك.
الفصل
افصل الحساب في Polylane، ثم ألغِ رمز API من لوحة تحكم Cloudflare تحت My Profile → API Tokens (أو Manage Account → API Tokens للرموز المملوكة للحساب).
اربط Cloudflare من مهمة CI أو أي بيئة أخرى بلا متصفح.
لا يحتاج ربط Cloudflare إلى متصفح: نقطة النهاية نفسها التي تستدعيها وحدة التحكم تناسب مهمة CI. ينشئ طلب POST موثَّق واحد الاتصال ويبدأ المزامنة الأولى.
المتطلبات الأساسية
- مفتاح API من Polylane بنطاقَي
cloud_accounts:writeوcloud_accounts:read. انظر مفاتيح API وOAuth. - معرّف مساحة عملك، الذي يبدأ بـ
ws_. اقرأه منGET /v1/workspacesبالمفتاح نفسه. - رمز API مملوك لحساب Cloudflare. يحدد رابط Create read-only token أعلاه مسبقاً كل إذن يحتاجه Polylane.
إنشاء الاتصال
curl -X POST https://api.polylane.com/v1/cloud_accounts \
-H "x-api-key: $POLYLANE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "cloudflare",
"workspaceId": "ws_0abc123",
"token": "<cloudflare-api-token>",
"readOnly": true
}'
يربط استدعاء واحد كل حساب Cloudflare يستطيع الرمز الوصول إليه، كل واحد كاتصال خاص به.
- يسجّل
readOnlyأن الرمز أُنشئ للقراءة فقط؛ احذفه (أو مرّرfalse) لرمز يستطيع الكتابة. - يتحكم
createMonitoringAlarms(اختياري، الافتراضيtrue) في تنبيهات قابلية الملاحظة الافتراضية لـ Workers.
تسرد الاستجابة ما رُبط، مع المزامنة الأولى جارية أصلاً. مختصرة إلى الحقلين اللذين تقرؤهما بقية التدفق:
{
"success": true,
"result": {
"provider": "cloudflare",
"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"
ثم ألغِ بيانات اعتماد Cloudflare على جانب المزود، كما هو موضح تحت الفصل أدناه.
فصل
يوقف الفصل كل مزامنة وفحص ويحذف بيانات الاعتماد التي احتفظ بها Polylane. يُزال أيضاً كل ما أعدّه Polylane في Cloudflare؛ ولا يبقى شيء.
polylane cloud disconnect <id>الأدوات
14العمليات التي يستطيع الوكلاء إجراءها في المحادثات.
الموارد المدعومة
47أنواع الموارد التي تظهر في مخطط بنيتك التحتية.