مرجع أوامر cdnctl الكامل
أوامر البدء السريع والقائمة الكاملة لجميع الأوامر (الحسابات، تطبيقات الحاويات، الإضافات، purge، التخزين الكائني، المهام، السجلات) مع معاملاتها.
افتح مرجع الأوامر الكامل →مساعدة CDN.com.tr
استخدام cdnctl
شغّل الحسابات وتطبيقات الحاويات وعمليات الاستيراد والسجلات والمهام والتخزين الكائني من الطرفية أو وكلاء الذكاء الاصطناعي.
المطورون وواجهة برمجة التطبيقات وcdnctl والأدوات
استخدام cdnctl
شغّل الحسابات وتطبيقات الحاويات وعمليات الاستيراد والسجلات والمهام والتخزين الكائني من الطرفية أو وكلاء الذكاء الاصطناعي.
مسار اللوحة
- Management Panel
- Help
- Tools
- cdnctl usage guide
المتطلبات المسبقة
- cdnctl binary does not require PHP.
- لا تُرجع مخرجات تسجيل الدخول معرّف المستخدم/البريد/الحساب.
- التحديث الذاتي يتحقق من المجاميع الاختبارية.
دليل خطوة بخطوة
Check cdnctl version
قبل بدء أتمتة الوكيل أو الطرفية، يُتحقق من حداثة الملف الثنائي.
- Run cdnctl update --check.
- إذا توفر تحديث، شغّل تحديثاً مُتحقَّقاً منه بالمجموع الاختباري.
النتيجة المتوقعة: يُرجع سطر الأوامر JSON وتكون حالة التحديث واضحة.
cdnctl equivalent
cdnctl update --check
cdnctl update --yesانقل تدفق عمل اللوحة إلى الطرفية
cdnctl is the public API equivalent of the panel; it does not take over panel-only payment/card steps.
- سجّل الدخول.
- أدرج الحسابات.
- شغّل أمر المنتج ذي الصلة.
- افحص مخرجات JSON بحثاً عن تسريب أسرار/معرّفات.
النتيجة المتوقعة: يحافظ تدفق الطرفية على حدود الملكية نفسها الموجودة في واجهة العميل باللوحة.
cdnctl equivalent
cdnctl login --email "<email>" --password "<password>"
cdnctl accounts listانشر مجلد المشروع عبر init ثم check ثم deploy
يقرأ cdnctl init مجلد المشروع ويكتشف اللغة ووكلاء الذكاء الاصطناعي المحليين (Claude Code وCursor وما شابه)، ثم يكتب cdnctl.yaml وقالب Dockerfile إن لم يوجد. لا حاجة إلى مستودع git ولا إلى سجل حاويات.
- شغّل cdnctl init داخل مجلد المشروع وأجب عن الأسئلة القصيرة.
- إذا لم يكن للحساب باقة منصة بعد، يطبع cdnctl رابط الشراء؛ ويتابع cdnctl init --wait تلقائيًا بعد إتمام الدفع في اللوحة.
- راجع ملف cdnctl.yaml المُنشأ قبل أول نشر.
النتيجة المتوقعة: المجلد يحتوي cdnctl.yaml وDockerfile، والحساب جاهز للنشر.
cdnctl equivalent
cdnctl init
cdnctl init --waitشغّل الفحوصات المسبقة قبل أن يغادر الكود جهازك
يفحص cdnctl check المشروع محليًا. الأخطاء توقف النشر: خادم يستمع إلى localhost فقط، أسرار داخل الكود، ملف .env خارج ملفات التجاهل، نسخ node_modules من الجهاز إلى الصورة. أما التحذيرات فتشرح مخاطر الإنتاج: SQLite على حاوية واحدة، غياب healthcheck، منفذ مكتوب بشكل ثابت.
- شغّل cdnctl check وأصلح الأسطر المعلَّمة كأخطاء.
- كرّر حتى يصبح الملخص نظيفًا؛ التحذيرات إرشادية لكنها تستحق القراءة.
النتيجة المتوقعة: ينتهي check نظيفًا؛ لم يغادر أي شيء جهازك في هذه الخطوة.
cdnctl equivalent
cdnctl checkامنح وكيل الذكاء الاصطناعي صلاحية النشر — لا كلمة مرور اللوحة
يُعرض deploy token مرة واحدة فقط، ويعمل لحساب واحد، ويغطي سطح النشر فقط: الرفع والبناء والنشر والحالة والسجلات — بلا حذف وبلا فوترة. ويتيح cdnctl mcp الأوامر نفسها للوكلاء المحليين عبر MCP.
- أنشئ الرمز عبر cdnctl deploy-token create واحفظه باسم CDN_ACCESS_TOKEN في بيئة الوكيل.
- سجّل cdnctl mcp في إعدادات MCP لدى الوكيل؛ حينها يستطيع الوكيل تشغيل check وdeploy بنفسه.
- ألغِ الرمز في أي وقت عبر cdnctl deploy-token revoke.
النتيجة المتوقعة: ينشر الوكيل بالرمز المقيّد؛ ويبقى دخول اللوحة والدفع بين يديك.
cdnctl equivalent
cdnctl deploy-token create
cdnctl mcpالتحقق
- مخرجات الأوامر بصيغة JSON ومخفية.
- Payment/card handling is outside cdnctl scope.
- يستخدم وكلاء الذكاء الاصطناعي أدوات عامة دون kubectl أو واجهات برمجة تطبيقات داخلية.
حالات الاستخدام
ينفّذ وكيل ذكاء اصطناعي خطوات الترحيل نفسها التي يمكن للمستخدم القيام بها في اللوحة بعد أن يكمل المستخدم شراء الباقة وتعيين الحساب.
سير عمل سريع
- تحقق من أن الحساب لديه الباقة المدفوعة المطلوبة.
- Run `cdnctl update --check`.
- سجّل الدخول.
- أدرج/اختر الحساب.
- أنشئ/انشر الموارد.
- اقرأ حالة/سجلات JSON.
الفحوصات
- تخفي مخرجات JSON الحقول الحساسة.
- يتحقق التحديث من المجموع الاختباري قبل التثبيت.
- للأوامر مكافئات في اللوحة.
- cdnctl docs do not ask agents to buy packages or handle payment cards.
الأسئلة الشائعة
فقدت deploy token — هل يمكنني رؤيته مجددًا؟
لا. يُعرض الرمز النصي مرة واحدة فقط عند الإنشاء. ألغِه عبر cdnctl deploy-token revoke وأنشئ رمزًا جديدًا؛ يتوقف الرمز القديم عن العمل فورًا.
يقول النشر "Build failed" — أين السجلات؟
يطبع cdnctl deploy سجل البناء عند فشله. أكثر سببين شيوعًا: ملف Dockerfile ينسخ node_modules من الجهاز إلى الصورة، واعتماد ناقص في ملف البيان — وكلاهما يلتقطه cdnctl check قبل الرفع. سجلات التشغيل: cdnctl container apps logs --app <app_uuid>.
على أي منفذ يجب أن يستمع تطبيقي؟
استمع على المنفذ المعلن في cdnctl.yaml وعلى كل الواجهات (0.0.0.0). يعلّم cdnctl check الاستماع إلى localhost فقط، لأن حركة المنصة تصل إلى الحاوية من خارج واجهة loopback.