Справка CDN.com.tr

Использование cdnctl

Управляйте аккаунтами, контейнерными приложениями, импортами, логами, заданиями и объектным хранилищем из терминала или через ИИ-агентов.

Разработчикам, API, cdnctl и инструменты

Использование cdnctl

Справочник команд cdnctl

Ищете все команды cdnctl? Быстрый старт и полный список команд находятся на отдельной странице справочника.

Полный справочник команд cdnctl

Команды быстрого старта и полный список всех команд (аккаунты, контейнерные приложения, аддоны, purge, объектное хранилище, задания, логи) с их параметрами.

Открыть полный справочник команд →

Ваш ИИ написал работающее приложение — вот как оно выходит в онлайн

История и путь: от обычной папки проекта до живого HTTPS-адреса, с реальным выводом каждой команды.

Открыть полный справочник команд →

cdnctl init → deploy: практический учебник

Установка, init, check, deploy с реальным выводом — и что делать, если что-то не так.

Открыть полный справочник команд →

Путь в панели

Management Panel
Help
Tools
cdnctl usage guide

Предварительные требования

cdnctl binary does not require PHP.
Вывод входа не возвращает ID пользователя/email/ID аккаунта.
Самообновление проверяет контрольные суммы.

Пошаговое руководство

Check cdnctl version

Перед началом автоматизации через агента или терминал проверяется актуальность бинарного файла.

Run cdnctl update --check.
Если доступно обновление, выполните обновление с проверкой контрольной суммы.

Ожидаемый результат: CLI возвращает JSON, статус обновления понятен.

cdnctl equivalent

cdnctl update --check
cdnctl update --yes

Перенос рабочего процесса панели в терминал

cdnctl is the public API equivalent of the panel; it does not take over panel-only payment/card steps.

Войдите в систему.
Выведите список аккаунтов.
Выполните соответствующую команду продукта.
Проверьте вывод JSON на утечку секретов/идентификаторов.

Ожидаемый результат: Процесс в терминале сохраняет ту же границу владения, что и клиентский интерфейс панели.

cdnctl equivalent

cdnctl login --email "<email>" --password "<password>"
cdnctl accounts list

Опубликуйте папку проекта через init → check → deploy

cdnctl init читает папку проекта, определяет язык и локальные AI-агенты (Claude Code, Cursor и похожие), записывает cdnctl.yaml и шаблон Dockerfile, если его нет. Git-репозиторий и реестр контейнеров не требуются.

Запустите cdnctl init в папке проекта и ответьте на короткие вопросы.
Если у аккаунта ещё нет пакета платформы, cdnctl выводит ссылку на покупку; cdnctl init --wait автоматически продолжит после завершения оплаты в панели.
Просмотрите созданный cdnctl.yaml перед первым деплоем.

Ожидаемый результат: В папке есть cdnctl.yaml и Dockerfile, аккаунт готов к деплою.

cdnctl equivalent

cdnctl init
cdnctl init --wait

Запустите предварительные проверки до того, как код покинет вашу машину

cdnctl check сканирует проект локально. Ошибки блокируют деплой: сервер, слушающий только localhost, секреты в коде, .env вне ignore-файлов, node_modules хоста, копируемый в образ. Предупреждения объясняют риски продакшена: SQLite на одном поде, отсутствие healthcheck, жёстко заданный порт.

Запустите cdnctl check и исправьте строки, помеченные как ошибки.
Повторяйте, пока сводка не станет чистой; предупреждения носят справочный характер, но их стоит прочитать.

Ожидаемый результат: check завершается чисто; на этом шаге ничего не покинуло вашу машину.

cdnctl equivalent

cdnctl check

Дайте AI-агенту доступ к деплою — а не пароль от панели

Deploy-токен показывается один раз, действует для одного аккаунта и покрывает только поверхность деплоя: загрузка, сборка, деплой, статус и логи — без удаления и без биллинга. cdnctl mcp открывает те же команды локальным агентам через MCP.

Создайте токен командой cdnctl deploy-token create и сохраните его как CDN_ACCESS_TOKEN в окружении агента.
Зарегистрируйте cdnctl mcp в MCP-конфигурации агента; агент сможет сам запускать check и deploy.
Отзовите токен в любой момент командой cdnctl deploy-token revoke.

Ожидаемый результат: Агент деплоит с ограниченным токеном; вход в панель и оплата остаются у вас.

cdnctl equivalent

cdnctl deploy-token create
cdnctl mcp

Проверка

Вывод команд представлен в формате JSON и очищен от чувствительных данных.
Payment/card handling is outside cdnctl scope.
ИИ-агенты используют публичные инструменты без kubectl или внутренних API.

Сценарии использования

ИИ-агент выполняет те же шаги миграции, что и пользователь мог бы выполнить в панели, после того как пользователь завершил покупку пакета и назначение аккаунта.

Краткий порядок действий

Убедитесь, что у аккаунта есть нужный оплаченный пакет.
Run `cdnctl update --check`.
Войдите в систему.
Выведите список/выберите аккаунт.
Создайте/разверните ресурсы.
Прочитайте статус/логи в формате JSON.

Проверки

Вывод JSON маскирует чувствительные поля.
Обновление проверяет контрольную сумму перед установкой.
У команд есть эквиваленты в панели.
cdnctl docs do not ask agents to buy packages or handle payment cards.

Часто задаваемые вопросы

Я потерял deploy-токен — можно увидеть его снова?

Нет. Токен в открытом виде показывается только один раз при создании. Отзовите его командой cdnctl deploy-token revoke и создайте новый; старый перестаёт работать сразу.

Деплой пишет «Build failed» — где логи?

cdnctl deploy выводит лог сборки при ошибке. Самые частые причины: Dockerfile, копирующий node_modules хоста в образ, и зависимость, отсутствующая в манифесте — обе ловит cdnctl check ещё до загрузки. Логи выполнения: cdnctl container apps logs --app <app_uuid>.

Какой порт должно слушать моё приложение?

Слушайте порт, объявленный в cdnctl.yaml, на всех интерфейсах (0.0.0.0). Привязку только к localhost помечает cdnctl check: трафик платформы приходит в контейнер извне loopback-интерфейса.