Référence 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

Télécharge la dernière version pour votre plateforme, la vérifie par rapport aux sommes de contrôle publiées, puis installe le binaire.

update

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

Met à jour automatiquement le binaire installé depuis le canal de publication public. L'archive téléchargée est vérifiée par rapport au fichier de somme de contrôle publié avant que le binaire ne soit remplacé.

login

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

S'authentifie et enregistre un jeton dans ~/.cdnctl/config.json. À utiliser une fois par machine ; le jeton est réutilisé pour les commandes suivantes.

configure

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

Définit manuellement l'endpoint ou le jeton sans se connecter. Utile pour les environnements CI ou l'automatisation basée sur des jetons.

accounts list

cdnctl accounts list

Liste tous les comptes CDN accessibles à l'utilisateur authentifié (JSON complet). Le champ uuid est utilisé comme --account dans toutes les autres commandes.

accounts ls

cdnctl accounts ls

Une version courte et lisible de la liste — une ligne par compte avec seulement l'uuid, le domaine et le type. Pratique pour trouver l'uuid à enregistrer comme valeur par défaut.

accounts use / current / clear

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

Enregistrez un compte par défaut une fois pour ne pas avoir à passer --account <uuid> à chaque commande. Après accounts use, les commandes associées à un compte utilisent automatiquement le compte enregistré (elles affichent (using saved account <uuid>) pour que vous sachiez lequel) ; passez --account à tout moment pour le remplacer. current l'affiche, clear l'oublie.

Set your account once

cdnctl accounts use <uuid>

Ainsi, les commandes de fichiers ci-dessous n'ont pas besoin de --account à chaque fois. (Exécutez cdnctl accounts ls pour trouver votre 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

Sans --path, elle liste la racine de 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

Ajoutez -r pour envoyer un dossier entier — la structure du dossier local est recréée sous la destination (les dossiers parents sont créés automatiquement ; les dossiers vides sont ignorés). Les envois n'écrasent jamais un fichier existant, sauf si vous ajoutez --force. Vous pouvez aussi indiquer le compte directement comme <uuid>:/uploads/photo.jpg au lieu d'enregistrer une valeur par défaut.

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

Nécessite --yes. Seuls les fichiers peuvent être supprimés (les dossiers sont refusés).

container apps list

cdnctl container apps list --account <uuid>

Liste toutes les applications conteneurisées du compte.

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

Crée un nouvel enregistrement d'application conteneurisée et sa première révision. Ne déploie pas — exécutez deploy après la création.

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

Met à jour les paramètres de l'application. Seuls les indicateurs (flags) passés sont modifiés. Exécutez deploy après la mise à jour pour publier la nouvelle révision.

container apps deploy

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

Publie la configuration actuelle en tant que nouvelle révision. Utilisez ensuite wait pour bloquer jusqu'à ce que le déploiement atteigne un statut cible.

container apps expose

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

Crée un sous-domaine permanent et immuable <uid>.cdn.com.tr pour l'application. Le sous-domaine ne change jamais, même si un domaine personnalisé est mis à jour.

container apps restart

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

Effectue un redémarrage progressif (rolling restart) de tous les réplicas en cours d'exécution sans créer de nouvelle révision.

container apps scale

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

Modifie immédiatement le nombre de réplicas sans créer de nouvelle révision. Passez 0 pour réduire l'application à zéro.

container apps show

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

Renvoie la configuration complète de l'application, y compris la liste des révisions. Utilisez les UUID de révision de cette sortie avec rollback.

container apps rollback

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

Redéploie une révision précédente. Utilisez show pour lister les UUID de révision disponibles.

container apps operations

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

Liste toutes les opérations de plateforme enregistrées pour l'application, telles que les déploiements, redémarrages et événements de mise à l'échelle.

container apps status

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

Renvoie le statut d'exécution actuel et le résultat de la dernière opération de l'application.

container apps wait

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

Interroge le statut de l'application jusqu'à ce qu'il atteigne --status ou que le délai expire. Se termine avec 0 en cas de succès, 1 en cas d'échec ou de dépassement du délai. En cas d'échec, inclut automatiquement la sortie de diagnose.

container apps logs

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

Renvoie les lignes récentes des journaux du conteneur.

container apps diagnose

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

Renvoie un instantané combiné du statut et des journaux. Utilisé automatiquement par wait en cas d'échec. Exécutez-le en premier lorsqu'une application est bloquée ou en échec.

container apps delete

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

Supprime définitivement l'application et toutes ses révisions. Cette opération est irréversible.

container preflight

cdnctl container preflight --account <uuid>

Vérifie que le compte est prêt à exécuter des charges de travail conteneurisées et renvoie la liste des éventuels problèmes détectés.

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

Supprime définitivement un identifiant de registre. Toutes les applications faisant référence à cet identifiant échoueront à récupérer les images lors du prochain déploiement.

container addons list

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

Liste tous les modules complémentaires actuellement associés à l'application.

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

Désactive le module complémentaire Postgres. Par défaut, les données sont conservées. Passez --delete-data avec --confirmation pour détruire définitivement toutes les données.

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]

Désactive le module complémentaire NATS. Passez --delete-data pour détruire définitivement toutes les données JetStream.

container compose preview

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

Analyse le fichier compose côté serveur et renvoie le plan d'import : applications à créer, mappages de modules complémentaires, classification des clés d'environnement/secrets, avertissements, services non pris en charge, et une vérification des droits. Ne crée rien. Les valeurs des secrets ne sont jamais renvoyées — seulement les noms de clés.

container compose apply

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

Applique l'import : crée les applications dans l'ordre des dépendances et active les modules complémentaires mappés. Tout ou rien — si le nom d'une application entre en conflit avec une application existante, ou si un service n'est pas pris en charge (par ex. utilise build:), rien n'est créé. Déployez ensuite chaque application créée avec container apps deploy.

container imports list

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

Liste tous les imports et leur statut actuel pour l'application.

container imports database

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

Envoie et met en file d'attente un dump SQL compressé en gzip pour import dans la base de données gérée.

container imports files

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

Envoie et extrait une archive tar.gz dans le volume persistant.

container imports cancel

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

Annule un import en file d'attente ou en cours. N'a aucun effet si l'import est déjà terminé.

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

Déclenche immédiatement une exécution ponctuelle de la tâche. Utilisez --wait pour bloquer jusqu'à ce que l'exécution se termine ou échoue.

container jobs delete

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

Supprime définitivement la tâche planifiée.

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>

Renvoie les statistiques d'utilisation actuelles du stockage pour le bucket.

object-storage buckets delete

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

Supprime définitivement le bucket et tous les objets qu'il contient. Cette opération est irréversible.

object-storage access-keys create

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

Crée une clé d'accès compatible S3. Le champ secret_key de la réponse n'est affiché qu'une seule fois et n'est plus jamais renvoyé. Copiez-la avant de fermer le terminal.

object-storage access-keys rotate

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

Génère un nouveau secret pour la clé d'accès en conservant le même UUID de clé et la même portée de bucket. Le nouveau secret_key est renvoyé une seule fois et jamais plus. Mettez à jour tous les clients avant d'effectuer la rotation en production.

object-storage access-keys revoke

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

Révoque et supprime définitivement la clé d'accès. Tous les clients utilisant encore cette clé recevront immédiatement des erreurs d'authentification.

object-storage bindings create

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

Associe un bucket à une application. Les identifiants S3 et l'endpoint sont injectés comme variables d'environnement lors du prochain déploiement.

object-storage bindings delete

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

Supprime l'association du bucket de l'application. Le bucket et la clé d'accès ne sont pas affectés ; seule l'injection de variables d'environnement est supprimée lors du prochain déploiement.