مرجع کامل دستورات cdnctl
دستورات شروع سریع و فهرست کامل همه دستورات (حسابها، اپلیکیشنهای کانتینری، افزونهها، purge، object storage، jobها، لاگها) همراه با پارامترهایشان.
باز کردن مرجع کامل دستورات →راهنمای CDN.com.tr
استفاده از cdnctl
اداره حسابها، اپلیکیشنهای کانتینری، وارد کردنها، لاگها، jobها و object storage از ترمینال یا عاملهای هوش مصنوعی.
توسعهدهندگان، API، cdnctl و ابزارها
استفاده از cdnctl
اداره حسابها، اپلیکیشنهای کانتینری، وارد کردنها، لاگها، jobها و object storage از ترمینال یا عاملهای هوش مصنوعی.
مسیر در پنل
- Management Panel
- Help
- Tools
- cdnctl usage guide
پیشنیازها
- cdnctl binary does not require PHP.
- خروجی ورود شناسه کاربر/ایمیل/شناسه حساب را برنمیگرداند.
- بهروزرسانی خودکار checksumها را تأیید میکند.
راهنمای گامبهگام
Check cdnctl version
پیش از آغاز خودکارسازی عامل یا ترمینال، تازگی باینری بررسی میشود.
- Run cdnctl update --check.
- اگر بهروزرسانی موجود است، بهروزرسانی تأییدشده با checksum را اجرا کنید.
نتیجه مورد انتظار: CLI خروجی JSON برمیگرداند و وضعیت بهروزرسانی روشن است.
معادل cdnctl
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
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
cdnctl init
cdnctl init --waitپیش از آنکه کد از دستگاه شما خارج شود، بررسیها را اجرا کنید
cdnctl check پروژه را بهصورت محلی بررسی میکند. خطاها استقرار را متوقف میکنند: سروری که فقط به localhost گوش میدهد، کلیدهای محرمانه داخل کد، نبودن .env در فایلهای ignore، کپی شدن node_modules میزبان به ایمیج. هشدارها ریسکهای محیط عملیاتی را توضیح میدهند: SQLite روی یک پاد، نبود healthcheck، پورت ثابت در کد.
- cdnctl check را اجرا کنید و خطهای علامتخورده بهعنوان خطا را برطرف کنید.
- تا پاک شدن خلاصه تکرار کنید؛ هشدارها جنبه راهنما دارند اما ارزش خواندن دارند.
نتیجه مورد انتظار: check پاک تمام میشود؛ در این مرحله هیچ چیزی از دستگاه شما خارج نشده است.
معادل cdnctl
cdnctl checkبه ایجنت هوش مصنوعی خود دسترسی استقرار بدهید — نه گذرواژه پنل را
توکن استقرار فقط یک بار نمایش داده میشود، برای یک حساب کار میکند و فقط سطح استقرار را پوشش میدهد: بارگذاری، ساخت، استقرار، وضعیت و لاگها — بدون حذف و بدون صورتحساب. cdnctl mcp همین فرمانها را از راه MCP در اختیار ایجنتهای محلی میگذارد.
- با cdnctl deploy-token create توکن بسازید و آن را بهعنوان CDN_ACCESS_TOKEN در محیط ایجنت نگه دارید.
- cdnctl mcp را در پیکربندی MCP ایجنت ثبت کنید؛ سپس ایجنت میتواند خودش check و deploy را اجرا کند.
- توکن را هر زمان خواستید با cdnctl deploy-token revoke باطل کنید.
نتیجه مورد انتظار: ایجنت با توکن محدود مستقر میکند؛ ورود به پنل و پرداخت نزد شما میماند.
معادل cdnctl
cdnctl deploy-token create
cdnctl mcpراستیآزمایی
- خروجیهای فرمان JSON و پنهانشدهاند.
- Payment/card handling is outside cdnctl scope.
- عاملهای هوش مصنوعی از ابزارهای عمومی بدون kubectl یا APIهای داخلی استفاده میکنند.
موارد کاربرد
یک عامل هوش مصنوعی همان گامهای مهاجرتی را که کاربر میتواند در پنل انجام دهد، پس از آنکه کاربر خرید بسته و اختصاص حساب را کامل کرد، انجام میدهد.
جریان کاری سریع
- تأیید کنید که حساب بسته پولی موردنیاز را دارد.
- Run `cdnctl update --check`.
- ورود.
- فهرست/انتخاب حساب.
- ساخت/استقرار منابع.
- خواندن وضعیت/لاگهای JSON.
بررسیها
- خروجی JSON فیلدهای حساس را ماسک میکند.
- بهروزرسانی پیش از نصب checksum را تأیید میکند.
- فرمانها معادل پنلی دارند.
- cdnctl docs do not ask agents to buy packages or handle payment cards.
پرسشهای متداول
توکن استقرارم را گم کردهام — میتوانم دوباره ببینمش؟
خیر. متن توکن فقط یک بار هنگام ساخت نمایش داده میشود. با 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) گوش دهید. گوش دادن فقط به localhost را cdnctl check علامت میزند، چون ترافیک پلتفرم از بیرونِ loopback به کانتینر میرسد.