مرجع 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

يقوم بتنزيل أحدث إصدار لنظام تشغيلك، والتحقق منه مقابل الـ checksums المنشورة، ثم تثبيت الملف التنفيذي.

update

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

يحدّث الملف التنفيذي المثبَّت ذاتياً من قناة الإصدارات العامة. يتم التحقق من الأرشيف المُنزَّل مقابل ملف الـ checksum المنشور قبل استبدال الملف التنفيذي.

login

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

يقوم بالمصادقة وحفظ رمز (token) في ~/.cdnctl/config.json. استخدمه مرة واحدة لكل جهاز؛ يُعاد استخدام الرمز في الأوامر اللاحقة.

configure

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

يضبط نقطة النهاية (endpoint) أو الرمز يدوياً دون تسجيل الدخول. مفيد لبيئات CI أو الأتمتة المعتمدة على الرموز.

accounts list

cdnctl accounts list

يسرد جميع حسابات CDN المتاحة للمستخدم المصادَق عليه (بصيغة JSON كاملة). يُستخدم حقل uuid كقيمة لـ --account في جميع الأوامر الأخرى.

accounts ls

cdnctl accounts ls

نسخة مختصرة وسهلة القراءة من القائمة — سطر واحد لكل حساب يتضمن فقط uuid والنطاق (domain) والنوع. مفيدة لإيجاد الـ 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 في كل مرة. (شغّل cdnctl accounts ls لإيجاد الـ uuid الخاص بك.)

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>]

ينشئ سجل تطبيق حاوية جديد ومراجعة أولى. لا يقوم بالنشر — شغّل 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>]

يحدّث إعدادات التطبيق. تُغيَّر فقط الرايات (flags) التي تمررها. شغّل 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 لتصفير التطبيق (scale to zero).

container apps show

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

يُعيد تكوين التطبيق الكامل بما في ذلك قائمة المراجعات. استخدم معرّفات UUID للمراجعات من هذا الإخراج مع rollback.

container apps rollback

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

يعيد نشر مراجعة سابقة. استخدم show لسرد معرّفات UUID للمراجعات المتاحة.

container apps operations

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

يسرد جميع عمليات المنصة المسجَّلة للتطبيق، مثل عمليات النشر وإعادة التشغيل وأحداث التحجيم (scale).

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 أو انتهاء المهلة. يخرج بالرمز 0 عند النجاح، و1 عند الفشل أو انتهاء المهلة. عند الفشل، يتضمن إخراج diagnose تلقائياً.

container apps logs

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

يُعيد أحدث أسطر سجل الحاوية (container log).

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

يزيل بيانات اعتماد السجل نهائياً. أي تطبيقات تشير إلى هذا الاعتماد ستفشل في سحب الصور في عملية النشر التالية.

container addons list

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

يسرد جميع الإضافات (add-ons) المرتبطة حالياً بالتطبيق.

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. مرّر --delete-data لتدمير جميع بيانات JetStream نهائياً.

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 إلى الحجم الدائم (persistent volume).

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>

يُعيد إحصائيات استخدام التخزين الحالية للحاوية (bucket).

object-storage buckets delete

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

يحذف الحاوية (bucket) وجميع الكائنات بداخلها نهائياً. هذه العملية لا رجعة فيها.

object-storage access-keys create

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

ينشئ مفتاح وصول متوافقاً مع S3. يُعرض حقل secret_key في الاستجابة مرة واحدة ولا يُعاد أبداً بعد ذلك. انسخه قبل إغلاق الطرفية (terminal).

object-storage access-keys rotate

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

يُولّد سراً جديداً لمفتاح الوصول مع الإبقاء على نفس معرّف المفتاح UUID ونطاق الحاوية. يُعاد secret_key الجديد مرة واحدة ولا يُعاد أبداً مرة أخرى. حدّث أي عملاء (clients) قبل التدوير في بيئة الإنتاج.

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>]

يربط حاوية (bucket) بتطبيق. تُحقن بيانات اعتماد S3 ونقطة النهاية (endpoint) كمتغيرات بيئة في عملية النشر التالية.

object-storage bindings delete

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

يزيل ربط الحاوية من التطبيق. لا يتأثر كل من الحاوية ومفتاح الوصول؛ يُزال فقط حقن متغير البيئة في عملية النشر التالية.