Справочник 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>]

Вручную задаёт эндпоинт или токен без входа в систему. Полезно для сред 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 каждый раз. (Выполните 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>]

Обновляет настройки приложения. Изменяются только переданные флаги. После обновления выполните 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>

Выполняет плавный перезапуск всех работающих реплик без создания новой ревизии.

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>

Возвращает полную конфигурацию приложения, включая список ревизий. Используйте 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>

Выводит список всех операций платформы, зафиксированных для приложения, таких как развёртывания, перезапуски и события масштабирования.

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

Выводит список всех дополнений, подключённых к приложению в данный момент.

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 на стороне сервера и возвращает план импорта: приложения, которые будут созданы, сопоставления дополнений, классификацию ключей переменных окружения/секретов, предупреждения, неподдерживаемые сервисы и проверку прав. Ничего не создаёт. Значения секретов никогда не возвращаются — только имена ключей.

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>

Загружает и ставит в очередь сжатый gzip дамп SQL для импорта в управляемую базу данных.

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 возвращается один раз и больше никогда. Обновите все клиенты перед ротацией в продакшене.

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

Удаляет привязку бакета от приложения. Сам бакет и ключ доступа не затрагиваются; при следующем развёртывании удаляется только внедрение переменных окружения.