مرجع cdnctl

install

curl -fsSL https://cdn.com.tr/downloads/cdnctl/install.sh | sh

# pin a specific version
CDNCTL_VERSION=0.12.0 curl -fsSL https://cdn.com.tr/downloads/cdnctl/install.sh | sh

آخرین نسخهٔ منتشرشده برای پلتفرم شما را دانلود می‌کند، آن را در برابر چک‌سام‌های منتشرشده تأیید می‌کند و باینری را نصب می‌کند.

update

cdnctl update --check
cdnctl update --yes
cdnctl update --version <version> --yes

باینری نصب‌شده را از کانال انتشار عمومی به‌صورت خودکار به‌روزرسانی می‌کند. آرشیو دانلودشده پیش از جایگزینی باینری، در برابر فایل چک‌سام منتشرشده تأیید می‌شود.

login

cdnctl login --email <email> --password <password> [--endpoint <url>]

احراز هویت می‌کند و توکن را در ~/.cdnctl/config.json ذخیره می‌کند. یک بار برای هر دستگاه استفاده کنید؛ توکن برای دستورهای بعدی مجدداً استفاده می‌شود.

configure

cdnctl configure [--endpoint <url>] [--token <token>]

اندپوینت یا توکن را بدون ورود (login) به‌صورت دستی تنظیم می‌کند. برای محیط‌های CI یا اتوماسیون مبتنی بر توکن مفید است.

accounts list

cdnctl accounts list

همهٔ حساب‌های CDN قابل دسترس برای کاربر احراز هویت‌شده را لیست می‌کند (JSON کامل). فیلد uuid به‌عنوان --account در همهٔ دستورهای دیگر استفاده می‌شود.

accounts ls

cdnctl accounts ls

نسخه‌ای کوتاه و خوانا از این لیست — یک خط برای هر حساب فقط با uuid، دامنه و نوع. برای پیدا کردن uuid و ذخیره کردن آن به‌عنوان پیش‌فرض مفید است.

accounts use / current / clear

cdnctl accounts use <uuid>
cdnctl accounts current
cdnctl accounts clear

یک بار یک حساب پیش‌فرض را ذخیره کنید تا مجبور نباشید در هر دستور --account <uuid> را ارسال کنید. پس از accounts use، دستورهای مرتبط با حساب به‌صورت خودکار از حساب ذخیره‌شده استفاده می‌کنند (عبارت (using saved account <uuid>) را چاپ می‌کنند تا بدانید کدام حساب است)؛ در هر زمان می‌توانید با ارسال --account آن را بازنویسی کنید. current آن را نمایش می‌دهد و clear آن را فراموش می‌کند.

Set your account once

cdnctl accounts use <uuid>

به این ترتیب دستورهای فایل در ادامه نیازی به --account در هر بار ندارند. (برای پیدا کردن uuid خود cdnctl accounts ls را اجرا کنید.)

List files — files ls

cdnctl files ls                       # lists wp-content (uploads, plugins, themes, …)
cdnctl files ls --path uploads
cdnctl files ls --path uploads/2026

بدون --path، ریشهٔ wp-content را لیست می‌کند.

Upload files — cp

cdnctl cp ./photo.jpg /uploads/photo.jpg
cdnctl cp ./backup.zip /uploads/backup.zip
cdnctl cp ./my-plugin.php /plugins/my-plugin/my-plugin.php

# upload a whole folder recursively (structure is preserved):
cdnctl cp -r ./my-folder /uploads/my-folder

برای آپلود کل یک دایرکتوری، -r را اضافه کنید — ساختار پوشهٔ محلی در مقصد بازسازی می‌شود (پوشه‌های والد به‌طور خودکار ساخته می‌شوند؛ پوشه‌های خالی نادیده گرفته می‌شوند). آپلودها هرگز فایل موجود را بازنویسی نمی‌کنند مگر اینکه --force را اضافه کنید. همچنین می‌توانید به‌جای ذخیرهٔ حساب پیش‌فرض، حساب را به‌صورت درون‌خطی به‌شکل <uuid>:/uploads/photo.jpg بنویسید.

Create a folder — files mkdir

cdnctl files mkdir --path /uploads/2026/07

Delete a file — files rm

cdnctl files rm --path /uploads/photo.jpg --yes

به --yes نیاز دارد. فقط فایل‌ها قابل حذف هستند (دایرکتوری‌ها رد می‌شوند).

container apps list

cdnctl container apps list --account <uuid>

همهٔ اپ‌های کانتینری زیر این حساب را لیست می‌کند.

container apps create

cdnctl container apps create \
  --account <uuid> \
  --name <name> \
  --image <registry/image> \
  [--tag <tag>] \
  [--port <port>] \
  [--healthcheck <path>] \
  [--healthcheck-type http|tcp|none] \
  [--metrics-port <port>] \
  [--metrics-path <path>] \
  [--replicas <n>] \
  [--plan <code>] \
  [--domain <domain>] \
  [--env-json '{"KEY":"value"}'] \
  [--secrets-json '{"SECRET":"value"}'] \
  [--registry-credential <uuid>] \
  [--persistent-mount-path <path>] \
  [--persistent-storage-gb <n>]

یک رکورد اپ کانتینری جدید و اولین نسخه (revision) را ایجاد می‌کند. استقرار (deploy) انجام نمی‌شود — پس از ایجاد، deploy را اجرا کنید.

container apps update

cdnctl container apps update \
  --account <uuid> \
  --app <uuid> \
  [--image <registry/image>] \
  [--tag <tag>] \
  [--port <port>] \
  [--replicas <n>] \
  [--healthcheck <path>] \
  [--healthcheck-type http|tcp|none] \
  [--metrics-port <port>] \
  [--metrics-path <path>] \
  [--domain <domain>] \
  [--env-json '{"KEY":"value"}'] \
  [--secrets-json '{"SECRET":"value"}'] \
  [--registry-credential <uuid>] \
  [--persistent-mount-path <path>]

تنظیمات اپ را به‌روزرسانی می‌کند. فقط فلگ‌هایی که ارسال می‌کنید تغییر می‌کنند. برای انتشار نسخهٔ جدید، پس از به‌روزرسانی deploy را اجرا کنید.

container apps deploy

cdnctl container apps deploy --account <uuid> --app <uuid>

پیکربندی فعلی را به‌عنوان یک نسخهٔ جدید منتشر می‌کند. سپس برای انتظار تا رسیدن استقرار به وضعیت هدف، از wait استفاده کنید.

container apps expose

cdnctl container apps expose --account <uuid> --app <uuid>

یک زیردامنهٔ دائمی و تغییرناپذیر به‌شکل <uid>.cdn.com.tr برای اپ ایجاد می‌کند. این زیردامنه حتی در صورت به‌روزرسانی دامنهٔ اختصاصی هرگز تغییر نمی‌کند.

container apps restart

cdnctl container apps restart --account <uuid> --app <uuid>

بدون ایجاد نسخهٔ جدید، یک ری‌استارت غلتان (rolling restart) برای همهٔ رپلیکاهای در حال اجرا انجام می‌دهد.

container apps scale

cdnctl container apps scale --account <uuid> --app <uuid> --replicas <n>

تعداد رپلیکاها را بلافاصله و بدون ایجاد نسخهٔ جدید تغییر می‌دهد. برای مقیاس‌دهی اپ به صفر، 0 را ارسال کنید.

container apps show

cdnctl container apps show --account <uuid> --app <uuid>

پیکربندی کامل اپ شامل لیست نسخه‌ها (revisions) را برمی‌گرداند. از UUIDهای نسخه در این خروجی همراه با rollback استفاده کنید.

container apps rollback

cdnctl container apps rollback --account <uuid> --app <uuid> --revision <revision_uuid>

یک نسخهٔ قبلی را دوباره مستقر می‌کند. برای لیست UUIDهای نسخهٔ موجود از show استفاده کنید.

container apps operations

cdnctl container apps operations --account <uuid> --app <uuid>

همهٔ عملیات ثبت‌شدهٔ پلتفرم برای اپ مانند استقرارها، ری‌استارت‌ها و رویدادهای مقیاس‌دهی را لیست می‌کند.

container apps status

cdnctl container apps status --account <uuid> --app <uuid>

وضعیت اجرای فعلی و نتیجهٔ آخرین عملیات اپ را برمی‌گرداند.

container apps wait

cdnctl container apps wait \
  --account <uuid> \
  --app <uuid> \
  --status <target> \
  [--timeout <seconds>] \
  [--interval <seconds>]

وضعیت اپ را به‌صورت دوره‌ای بررسی می‌کند تا به --status برسد یا زمان مهلت (timeout) به پایان برسد. در صورت موفقیت با کد 0 و در صورت شکست یا اتمام مهلت با کد 1 خارج می‌شود. در صورت شکست، خروجی diagnose به‌طور خودکار افزوده می‌شود.

container apps logs

cdnctl container apps logs --account <uuid> --app <uuid> [--tail <n>]

خطوط اخیر لاگ کانتینر را برمی‌گرداند.

container apps diagnose

cdnctl container apps diagnose --account <uuid> --app <uuid> [--tail <n>]

یک اسنپ‌شات ترکیبی از وضعیت و لاگ برمی‌گرداند. در صورت شکست، به‌طور خودکار توسط wait استفاده می‌شود. وقتی اپ گیر کرده یا با شکست مواجه شده، ابتدا این را اجرا کنید.

container apps delete

cdnctl container apps delete --account <uuid> --app <uuid> --yes

اپ و همهٔ نسخه‌های آن را به‌طور دائمی حذف می‌کند. این عملیات غیرقابل بازگشت است.

container preflight

cdnctl container preflight --account <uuid>

بررسی می‌کند که آیا حساب برای اجرای بارهای کاری کانتینری آماده است و لیستی از مشکلات یافت‌شده را برمی‌گرداند.

container registry-credentials list

cdnctl container registry-credentials list --account <uuid>

container registry-credentials create

cdnctl container registry-credentials create \
  --account <uuid> \
  --name <name> \
  --password <token> \
  [--registry-url <url>] \
  [--username <user>]

container registry-credentials delete

cdnctl container registry-credentials delete \
  --account <uuid> \
  --credential <credential_uuid> \
  --yes

یک اعتبارنامهٔ رجیستری را به‌طور دائمی حذف می‌کند. هر اپی که به این اعتبارنامه ارجاع دهد، در استقرار بعدی در دریافت (pull) ایمیج با شکست مواجه خواهد شد.

container addons list

cdnctl container addons list --account <uuid> --app <uuid>

همهٔ افزونه‌های (add-on) متصل به اپ در حال حاضر را لیست می‌کند.

container addons enable-database

cdnctl container addons enable-database \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>] \
  [--storage-mb <n>] \
  [--url-scheme <scheme>]

container addons disable-database

cdnctl container addons disable-database --account <uuid> --app <uuid>

container addons enable-redis

cdnctl container addons enable-redis \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>]

container addons disable-redis

cdnctl container addons disable-redis --account <uuid> --app <uuid>

container addons enable-postgres

cdnctl container addons enable-postgres \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>] \
  [--storage-mb <n>]

container addons disable-postgres

cdnctl container addons disable-postgres \
  --account <uuid> \
  --app <uuid> \
  [--delete-data --confirmation <app_name>]

افزونهٔ Postgres را غیرفعال می‌کند. به‌طور پیش‌فرض داده‌ها نگه‌داشته می‌شوند. برای حذف دائمی همهٔ داده‌ها، --delete-data را همراه با --confirmation ارسال کنید.

container addons enable-nats

cdnctl container addons enable-nats \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>] \
  [--storage-mb <n>]

container addons disable-nats

cdnctl container addons disable-nats \
  --account <uuid> \
  --app <uuid> \
  [--delete-data]

افزونهٔ NATS را غیرفعال می‌کند. برای حذف دائمی همهٔ داده‌های JetStream، --delete-data را ارسال کنید.

container compose preview

cdnctl container compose preview --account <uuid> --file docker-compose.yml

فایل compose را در سمت سرور تجزیه می‌کند و طرح ایمپورت را برمی‌گرداند: اپ‌هایی که باید ایجاد شوند، نگاشت افزونه‌ها، دسته‌بندی کلیدهای متغیر محیطی/محرمانه، هشدارها، سرویس‌های پشتیبانی‌نشده و بررسی مجوز (entitlement). چیزی ایجاد نمی‌شود. مقادیر محرمانه هرگز بازگردانده نمی‌شوند — فقط نام کلیدها.

container compose apply

cdnctl container compose apply --account <uuid> --file docker-compose.yml --yes

ایمپورت را اعمال می‌کند: اپ‌ها را به ترتیب وابستگی ایجاد می‌کند و افزونه‌های نگاشت‌شده را فعال می‌کند. به‌صورت همه‌یا‌هیچ — اگر نام هر اپی با اپ موجود تداخل داشته باشد، یا هر سرویسی پشتیبانی نشود (مثلاً از build: استفاده کند)، چیزی ایجاد نمی‌شود. پس از آن، هر اپ ایجادشده را با container apps deploy مستقر کنید.

container imports list

cdnctl container imports list --account <uuid> --app <uuid>

همهٔ ایمپورت‌ها و وضعیت فعلی آن‌ها را برای اپ لیست می‌کند.

container imports database

cdnctl container imports database \
  --account <uuid> \
  --app <uuid> \
  --file <path/to/dump.sql.gz>

یک دامپ SQL فشرده‌شده با gzip را آپلود و برای ایمپورت به پایگاه‌دادهٔ مدیریت‌شده در صف قرار می‌دهد.

container imports files

cdnctl container imports files \
  --account <uuid> \
  --app <uuid> \
  --file <path/to/archive.tar.gz> \
  [--target-path <path>]

یک آرشیو tar.gz را آپلود و در والیوم پایدار استخراج می‌کند.

container imports cancel

cdnctl container imports cancel \
  --account <uuid> \
  --app <uuid> \
  --import <import_uuid>

یک ایمپورت در صف یا در حال اجرا را لغو می‌کند. اگر ایمپورت قبلاً کامل شده باشد، هیچ تأثیری ندارد.

container jobs list

cdnctl container jobs list --account <uuid> --app <uuid>

container jobs create

cdnctl container jobs create \
  --account <uuid> \
  --app <uuid> \
  --name <name> \
  --schedule "<cron expression>" \
  --path </endpoint/path> \
  [--method <POST|GET>] \
  [--secret-header-name <header>] \
  [--secret-source <ENV_VAR>] \
  [--enabled]

container jobs run

cdnctl container jobs run \
  --account <uuid> \
  --app <uuid> \
  --job <job_uuid> \
  [--wait] \
  [--timeout <seconds>] \
  [--interval <seconds>]

یک اجرای فوری و یک‌باره از جاب را آغاز می‌کند. برای انتظار تا پایان یا شکست اجرا، از --wait استفاده کنید.

container jobs delete

cdnctl container jobs delete \
  --account <uuid> \
  --app <uuid> \
  --job <job_uuid> \
  --yes

جاب زمان‌بندی‌شده را به‌طور دائمی حذف می‌کند.

object-storage buckets list

cdnctl object-storage buckets list --account <uuid>

object-storage buckets create

cdnctl object-storage buckets create \
  --account <uuid> \
  --name <bucket-name> \
  [--visibility private|public]

object-storage buckets usage

cdnctl object-storage buckets usage --account <uuid> --bucket <bucket_uuid>

آمار فعلی مصرف فضای ذخیره‌سازی باکت را برمی‌گرداند.

object-storage buckets delete

cdnctl object-storage buckets delete --account <uuid> --bucket <bucket_uuid> --yes

باکت و همهٔ آبجکت‌های داخل آن را به‌طور دائمی حذف می‌کند. این عملیات غیرقابل بازگشت است.

object-storage access-keys create

cdnctl object-storage access-keys create \
  --account <uuid> \
  [--bucket <uuid>] \
  [--name <name>]

یک کلید دسترسی سازگار با S3 ایجاد می‌کند. فیلد secret_key در پاسخ فقط یک بار نمایش داده می‌شود و دیگر بازگردانده نمی‌شود. پیش از بستن ترمینال آن را کپی کنید.

object-storage access-keys rotate

cdnctl object-storage access-keys rotate --account <uuid> --key <key_uuid>

یک مقدار محرمانهٔ جدید برای کلید دسترسی تولید می‌کند در حالی که همان UUID کلید و محدودهٔ باکت حفظ می‌شود. secret_key جدید فقط یک بار بازگردانده می‌شود و دیگر تکرار نمی‌شود. پیش از چرخش (rotate) در محیط پروداکشن، همهٔ کلاینت‌ها را به‌روزرسانی کنید.

object-storage access-keys revoke

cdnctl object-storage access-keys revoke --account <uuid> --key <key_uuid> --yes

کلید دسترسی را به‌طور دائمی لغو و حذف می‌کند. هر کلاینتی که هنوز از این کلید استفاده می‌کند، بلافاصله با خطاهای احراز هویت مواجه خواهد شد.

object-storage bindings create

cdnctl object-storage bindings create \
  --account <uuid> \
  --app <uuid> \
  --bucket <uuid> \
  [--access-key <uuid>] \
  [--env-prefix <prefix>]

یک باکت را به یک اپ متصل می‌کند. در استقرار بعدی، اعتبارنامه‌های S3 و اندپوینت به‌عنوان متغیرهای محیطی تزریق می‌شوند.

object-storage bindings delete

cdnctl object-storage bindings delete \
  --account <uuid> \
  --app <uuid> \
  --binding <binding_uuid> \
  --yes

اتصال باکت را از اپ حذف می‌کند. باکت و کلید دسترسی تحت تأثیر قرار نمی‌گیرند؛ فقط تزریق متغیر محیطی در استقرار بعدی حذف می‌شود.