Referencia completa de comandos cdnctl
Comandos de inicio rápido y la lista completa de todos los comandos (cuentas, apps en contenedor, addons, purge, object storage, tareas, registros) con sus parámetros.
Abrir la referencia completa de comandos →Ayuda de CDN.com.tr
Usar cdnctl
Opere cuentas, apps en contenedor, importaciones, registros, tareas y almacenamiento de objetos desde la terminal o agentes de IA.
Desarrolladores, API, cdnctl y herramientas
Usar cdnctl
Opere cuentas, apps en contenedor, importaciones, registros, tareas y almacenamiento de objetos desde la terminal o agentes de IA.
Ruta en el panel
- Panel de administración
- Help
- Tools
- cdnctl usage guide
Requisitos previos
- cdnctl binary does not require PHP.
- La salida de inicio de sesión no devuelve ID de usuario/correo/ID de cuenta.
- La autoactualización verifica las sumas de comprobación.
Guía paso a paso
Check cdnctl version
Antes de que comience la automatización por agente o terminal, se verifica la actualidad del binario.
- Run cdnctl update --check.
- Si hay una actualización disponible, ejecute la actualización verificada por suma de comprobación.
Resultado esperado: La CLI devuelve JSON y el estado de actualización es claro.
cdnctl equivalent
cdnctl update --check
cdnctl update --yesTrasladar el flujo del panel a la terminal
cdnctl is the public API equivalent of the panel; it does not take over panel-only payment/card steps.
- Inicie sesión.
- Liste las cuentas.
- Ejecute el comando del producto relevante.
- Verifique la salida JSON en busca de fugas de secretos/IDs.
Resultado esperado: El flujo en terminal mantiene el mismo límite de propiedad que la superficie del panel para el cliente.
cdnctl equivalent
cdnctl login --email "<email>" --password "<password>"
cdnctl accounts listPublique una carpeta de proyecto con init → check → deploy
cdnctl init lee la carpeta del proyecto, detecta el lenguaje y los agentes de IA locales (Claude Code, Cursor y similares), y escribe cdnctl.yaml más una plantilla de Dockerfile si falta. No se necesita repositorio git ni registro de contenedores.
- Ejecute cdnctl init en la carpeta del proyecto y responda las preguntas breves.
- Si la cuenta aún no tiene paquete de plataforma, cdnctl imprime el enlace de compra; cdnctl init --wait continúa automáticamente cuando el pago se completa en el panel.
- Revise el cdnctl.yaml generado antes del primer deploy.
Resultado esperado: La carpeta contiene cdnctl.yaml y un Dockerfile, y la cuenta está lista para el deploy.
cdnctl equivalent
cdnctl init
cdnctl init --waitEjecute las comprobaciones antes de que el código salga de su máquina
cdnctl check analiza el proyecto localmente. Los errores bloquean el deploy: servidor ligado solo a localhost, secretos en el código, .env fuera de los archivos ignore, node_modules del host copiado a la imagen. Las advertencias explican riesgos de producción: SQLite en un solo pod, healthcheck ausente, puerto fijo en el código.
- Ejecute cdnctl check y corrija las líneas marcadas como error.
- Repita hasta que el resumen quede limpio; las advertencias son informativas pero vale la pena leerlas.
Resultado esperado: check termina limpio; nada ha salido de su máquina en este paso.
cdnctl equivalent
cdnctl checkDé a su agente de IA acceso de deploy — no su contraseña del panel
Un deploy token se muestra una sola vez, funciona para una única cuenta y solo cubre la superficie de deploy: subida, build, deploy, estado y logs — sin borrado y sin facturación. cdnctl mcp expone los mismos comandos a agentes locales vía MCP.
- Cree un token con cdnctl deploy-token create y guárdelo como CDN_ACCESS_TOKEN en el entorno del agente.
- Registre cdnctl mcp en la configuración MCP del agente; el agente podrá ejecutar check y deploy por sí mismo.
- Revoque el token en cualquier momento con cdnctl deploy-token revoke.
Resultado esperado: El agente despliega con el token restringido; el acceso al panel y el pago quedan con usted.
cdnctl equivalent
cdnctl deploy-token create
cdnctl mcpVerificación
- Las salidas de comandos son JSON y están ocultas.
- Payment/card handling is outside cdnctl scope.
- Los agentes de IA usan herramientas públicas sin kubectl ni API internas.
Casos de uso
Un agente de IA realiza los mismos pasos de migración que el usuario puede hacer en el panel, después de que el usuario haya completado la compra del paquete y la asignación de la cuenta.
Flujo de trabajo rápido
- Verifique que la cuenta tenga el paquete pagado requerido.
- Run `cdnctl update --check`.
- Inicie sesión.
- Liste/seleccione la cuenta.
- Cree/implemente recursos.
- Lea el estado/registros en JSON.
Verificaciones
- La salida JSON enmascara los campos sensibles.
- La actualización verifica la suma de comprobación antes de instalar.
- Los comandos tienen equivalentes en el panel.
- cdnctl docs do not ask agents to buy packages or handle payment cards.
Preguntas frecuentes
Perdí mi deploy token — ¿puedo verlo de nuevo?
No. El token en texto plano se muestra solo una vez al crearlo. Revóquelo con cdnctl deploy-token revoke y cree uno nuevo; el antiguo deja de funcionar de inmediato.
El deploy dice "Build failed" — ¿dónde están los logs?
cdnctl deploy imprime el log de build cuando falla. Las causas más comunes son un Dockerfile que copia node_modules del host a la imagen y una dependencia ausente del manifiesto — cdnctl check detecta ambas antes de subir nada. Logs de ejecución: cdnctl container apps logs --app <app_uuid>.
¿En qué puerto debe escuchar mi aplicación?
Escuche en el puerto declarado en cdnctl.yaml, en todas las interfaces (0.0.0.0). cdnctl check marca el enlace solo a localhost, porque el tráfico de la plataforma llega al contenedor desde fuera del loopback.