cdnctl Referansı

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

Platformunuz için en son sürümü indirir, yayımlanan sağlama toplamlarına (checksum) göre doğrular ve ikili dosyayı kurar.

update

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

Kurulu ikili dosyayı genel sürüm kanalından kendi kendine günceller. İndirilen arşiv, ikili dosya değiştirilmeden önce yayımlanan checksum dosyasına göre doğrulanır.

login

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

Kimlik doğrulaması yapar ve bir token'ı ~/.cdnctl/config.json içine kaydeder. Makine başına bir kez kullanılır; token sonraki komutlarda yeniden kullanılır.

configure

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

Giriş yapmadan endpoint veya token'ı manuel olarak ayarlar. CI ortamları veya token tabanlı otomasyon için kullanışlıdır.

accounts list

cdnctl accounts list

Kimliği doğrulanmış kullanıcının erişebildiği tüm CDN hesaplarını listeler (tam JSON). uuid alanı diğer tüm komutlarda --account olarak kullanılır.

accounts ls

cdnctl accounts ls

Listenin kısa, okunması kolay hali — her hesap için yalnızca uuid, alan adı ve türü içeren tek satır. Varsayılan olarak kaydedilecek uuid'yi bulmak için kullanışlıdır.

accounts use / current / clear

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

Her komutta --account <uuid> geçmek zorunda kalmamak için bir kez bir varsayılan hesap kaydedin. accounts use sonrasında, hesap kapsamlı komutlar otomatik olarak kaydedilmiş hesabı kullanır (hangisinin kullanıldığını bilmeniz için (using saved account <uuid>) yazdırırlar); istediğiniz zaman --account geçerek geçersiz kılabilirsiniz. current onu gösterir, clear unutur.

Set your account once

cdnctl accounts use <uuid>

Böylece aşağıdaki dosya komutlarının her seferinde --account gerektirmemesi sağlanır. (uuid'nizi bulmak için cdnctl accounts ls çalıştırın.)

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 verilmediğinde wp-content kökünü listeler.

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

Bütün bir dizini yüklemek için -r ekleyin — yerel klasör yapısı hedef altında yeniden oluşturulur (üst klasörler otomatik olarak yaratılır; boş klasörler atlanır). Yüklemeler, --force eklemediğiniz sürece mevcut bir dosyanın üzerine yazmaz. Varsayılan kaydetmek yerine hesabı satır içinde <uuid>:/uploads/photo.jpg şeklinde de belirtebilirsiniz.

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 gerektirir. Yalnızca dosyalar silinebilir (dizinler reddedilir).

container apps list

cdnctl container apps list --account <uuid>

Hesap altındaki tüm container uygulamalarını listeler.

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

Yeni bir container uygulama kaydı ve ilk revizyonu oluşturur. Dağıtım (deploy) yapmaz — oluşturduktan sonra deploy çalıştırın.

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

Uygulama ayarlarını günceller. Yalnızca geçtiğiniz bayraklar (flag) değiştirilir. Yeni revizyonu yayımlamak için güncellemeden sonra deploy çalıştırın.

container apps deploy

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

Geçerli yapılandırmayı yeni bir revizyon olarak yayımlar. Dağıtım hedef duruma ulaşana kadar engellemek için ardından wait kullanın.

container apps expose

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

Uygulama için kalıcı, değişmez bir <uid>.cdn.com.tr alt alan adı oluşturur. Özel bir alan adı güncellense bile bu alt alan adı asla değişmez.

container apps restart

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

Yeni bir revizyon oluşturmadan çalışan tüm replikaların kademeli (rolling) yeniden başlatmasını yapar.

container apps scale

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

Yeni bir revizyon oluşturmadan replika sayısını anında değiştirir. Uygulamayı sıfıra ölçeklendirmek için 0 geçin.

container apps show

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

Revizyon listesi dahil tam uygulama yapılandırmasını döndürür. Bu çıktıdaki revizyon UUID'lerini rollback ile kullanın.

container apps rollback

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

Önceki bir revizyonu yeniden dağıtır. Kullanılabilir revizyon UUID'lerini listelemek için show kullanın.

container apps operations

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

Dağıtım, yeniden başlatma ve ölçeklendirme olayları gibi uygulama için kaydedilen tüm platform işlemlerini listeler.

container apps status

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

Uygulamanın geçerli çalışma zamanı durumunu ve son işlem sonucunu döndürür.

container apps wait

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

Uygulama durumu --status değerine ulaşana veya zaman aşımı süresi dolana kadar kontrol eder (poll). Başarıda 0, başarısızlık veya zaman aşımında 1 ile çıkar. Başarısızlıkta diagnose çıktısını otomatik olarak içerir.

container apps logs

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

Son container log satırlarını döndürür.

container apps diagnose

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

Birleştirilmiş bir durum ve log anlık görüntüsü döndürür. Başarısızlıkta wait tarafından otomatik olarak kullanılır. Bir uygulama takılı kaldığında veya başarısız olduğunda önce bunu çalıştırın.

container apps delete

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

Uygulamayı ve tüm revizyonlarını kalıcı olarak siler. Bu işlem geri alınamaz.

container preflight

cdnctl container preflight --account <uuid>

Hesabın container iş yüklerini çalıştırmaya hazır olup olmadığını kontrol eder ve bulunan sorunların listesini döndürür.

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

Bir registry kimlik bilgisini kalıcı olarak kaldırır. Bu kimlik bilgisine referans veren uygulamalar bir sonraki dağıtımda imaj çekemeyecektir.

container addons list

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

Uygulamaya şu anda bağlı tüm eklentileri (add-on) listeler.

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 eklentisini devre dışı bırakır. Varsayılan olarak veriler saklanır. Tüm verileri kalıcı olarak yok etmek için --delete-data ile birlikte --confirmation geçin.

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 eklentisini devre dışı bırakır. Tüm JetStream verilerini kalıcı olarak yok etmek için --delete-data geçin.

container compose preview

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

Compose dosyasını sunucu tarafında ayrıştırır ve içe aktarma planını döndürür: oluşturulacak uygulamalar, eklenti eşlemeleri, ortam değişkeni/gizli anahtar sınıflandırması, uyarılar, desteklenmeyen servisler ve yetkilendirme kontrolü. Hiçbir şey oluşturmaz. Gizli anahtar (secret) değerleri asla geri yansıtılmaz — yalnızca anahtar adları.

container compose apply

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

İçe aktarmayı uygular: uygulamaları bağımlılık sırasına göre oluşturur ve eşlenen eklentileri etkinleştirir. Ya hep ya hiç yaklaşımı — herhangi bir uygulama adı mevcut bir uygulamayla çakışırsa veya herhangi bir servis desteklenmiyorsa (örn. build: kullanıyorsa), hiçbir şey oluşturulmaz. Oluşturulan her uygulamayı daha sonra container apps deploy ile dağıtın.

container imports list

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

Uygulama için tüm içe aktarmaları ve mevcut durumlarını listeler.

container imports database

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

Gzip ile sıkıştırılmış bir SQL dökümünü yönetilen veritabanına içe aktarılmak üzere yükler ve kuyruğa alır.

container imports files

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

Bir tar.gz arşivini yükler ve kalıcı volume içine çıkarır.

container imports cancel

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

Kuyrukta bekleyen veya devam eden bir içe aktarmayı iptal eder. İçe aktarma zaten tamamlandıysa hiçbir etkisi yoktur.

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

İşin (job) anında tek seferlik bir çalıştırmasını tetikler. Çalıştırma tamamlanana veya başarısız olana kadar beklemek için --wait kullanın.

container jobs delete

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

Zamanlanmış işi kalıcı olarak kaldırır.

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 için geçerli depolama kullanım istatistiklerini döndürür.

object-storage buckets delete

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

Bucket'ı ve içindeki tüm nesneleri kalıcı olarak siler. Bu işlem geri alınamaz.

object-storage access-keys create

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

S3 uyumlu bir erişim anahtarı oluşturur. Yanıttaki secret_key alanı yalnızca bir kez gösterilir ve bir daha döndürülmez. Terminali kapatmadan önce kopyalayın.

object-storage access-keys rotate

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

Aynı anahtar UUID'sini ve bucket kapsamını koruyarak erişim anahtarı için yeni bir gizli anahtar (secret) üretir. Yeni secret_key yalnızca bir kez döndürülür ve bir daha gösterilmez. Üretim ortamında döndürmeden önce tüm istemcileri güncelleyin.

object-storage access-keys revoke

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

Erişim anahtarını kalıcı olarak iptal eder ve siler. Bu anahtarı hâlâ kullanan istemciler anında kimlik doğrulama hatası alır.

object-storage bindings create

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

Bir bucket'ı bir uygulamaya bağlar. S3 kimlik bilgileri ve endpoint, bir sonraki dağıtımda ortam değişkenleri olarak enjekte edilir.

object-storage bindings delete

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

Uygulamadan bucket bağlamasını kaldırır. Bucket ve erişim anahtarı etkilenmez; yalnızca ortam değişkeni enjeksiyonu bir sonraki dağıtımda kaldırılır.