Loading...

Aide CDN.com.tr

Utiliser cdnctl

Exploitez les comptes, applications conteneurisées, importations, journaux, tâches et le stockage d'objets depuis un terminal ou des agents IA.

Utiliser cdnctl

Exploitez les comptes, applications conteneurisées, importations, journaux, tâches et le stockage d'objets depuis un terminal ou des agents IA.

Référence des commandes cdnctl

Vous cherchez toutes les commandes cdnctl ? Le démarrage rapide et la liste complète sont sur une page de référence dédiée.

Référence complète des commandes cdnctl

Commandes de démarrage rapide et liste complète de toutes les commandes (comptes, applications conteneurisées, addons, purge, object storage, tâches, journaux) avec leurs options.

Ouvrir la référence complète des commandes →

Votre IA a construit une app qui fonctionne — voici comment la mettre en ligne

L'histoire et le chemin : d'un simple dossier de projet à une URL HTTPS en ligne, avec les sorties réelles de chaque commande.

Ouvrir la référence complète des commandes →

Chemin dans le panneau

  1. Management Panel
  2. Help
  3. Tools
  4. cdnctl usage guide

Prerequis

  • cdnctl binary does not require PHP.
  • La sortie de connexion ne renvoie pas l'ID utilisateur/e-mail/ID compte.
  • La mise à jour automatique vérifie les sommes de contrôle.

Guide etape par etape

1

Check cdnctl version

Avant qu'une automatisation par agent ou terminal ne démarre, la fraîcheur du binaire est vérifiée.

  • Run cdnctl update --check.
  • Si une mise à jour est disponible, exécuter la mise à jour vérifiée par somme de contrôle.

Resultat attendu: La CLI renvoie du JSON et l'état de mise à jour est clair.

cdnctl equivalent
cdnctl update --check
cdnctl update --yes
2

Transposer le workflow du panneau vers le terminal

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

  • Se connecter.
  • Lister les comptes.
  • Exécuter la commande produit correspondante.
  • Vérifier la sortie JSON pour toute fuite de secret/ID.

Resultat attendu: Le flux terminal conserve la même limite de propriété que la surface client du panneau.

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

Publiez un dossier de projet avec init → check → deploy

cdnctl init lit le dossier du projet, détecte le langage et les agents IA locaux (Claude Code, Cursor et similaires), puis écrit cdnctl.yaml et un modèle de Dockerfile s'il manque. Aucun dépôt git ni registre de conteneurs n'est requis.

  • Lancez cdnctl init dans le dossier du projet et répondez aux questions courtes.
  • Si le compte n'a pas encore de forfait plateforme, cdnctl affiche le lien d'achat ; cdnctl init --wait reprend automatiquement une fois le paiement terminé dans le panneau.
  • Relisez le cdnctl.yaml généré avant le premier déploiement.

Resultat attendu: Le dossier contient cdnctl.yaml et un Dockerfile, et le compte est prêt pour le déploiement.

cdnctl equivalent
cdnctl init
cdnctl init --wait
4

Lancez les vérifications avant que le code ne quitte votre machine

cdnctl check analyse le projet en local. Les erreurs bloquent le déploiement : serveur lié uniquement à localhost, secrets dans le code, .env absent des fichiers ignore, node_modules de l'hôte copié dans l'image. Les avertissements expliquent les risques de production : SQLite sur un seul pod, healthcheck manquant, port codé en dur.

  • Lancez cdnctl check et corrigez les lignes marquées en erreur.
  • Répétez jusqu'à ce que le résumé soit propre ; les avertissements sont informatifs mais méritent lecture.

Resultat attendu: check se termine proprement ; rien n'a quitté votre machine pendant cette étape.

cdnctl equivalent
cdnctl check
5

Donnez à votre agent IA un accès deploy — pas votre mot de passe du panneau

Un deploy token n'est affiché qu'une seule fois, vaut pour un seul compte et ne couvre que la surface de déploiement : envoi, build, deploy, statut et logs — sans suppression ni facturation. cdnctl mcp expose les mêmes commandes aux agents locaux via MCP.

  • Créez un token avec cdnctl deploy-token create et stockez-le comme CDN_ACCESS_TOKEN dans l'environnement de l'agent.
  • Enregistrez cdnctl mcp dans la configuration MCP de l'agent ; l'agent peut alors exécuter check et deploy lui-même.
  • Révoquez le token à tout moment avec cdnctl deploy-token revoke.

Resultat attendu: L'agent déploie avec le token restreint ; la connexion au panneau et le paiement restent entre vos mains.

cdnctl equivalent
cdnctl deploy-token create
cdnctl mcp

Verification

  • Les sorties de commande sont en JSON et masquées.
  • Payment/card handling is outside cdnctl scope.
  • Les agents IA utilisent des outils publics sans kubectl ni API internes.

Cas d'usage

Un agent IA effectue les mêmes étapes de migration que l'utilisateur peut réaliser dans le panneau, après que l'utilisateur a terminé l'achat du forfait et l'assignation du compte.

Workflow rapide

  1. Vérifier que le compte dispose du forfait payant requis.
  2. Run `cdnctl update --check`.
  3. Se connecter.
  4. Lister/sélectionner le compte.
  5. Créer/déployer les ressources.
  6. Lire le statut/les journaux JSON.

Verifications

  • La sortie JSON masque les champs sensibles.
  • La mise à jour vérifie la somme de contrôle avant l'installation.
  • Les commandes ont des équivalents dans le panneau.
  • cdnctl docs do not ask agents to buy packages or handle payment cards.

Questions frequentes

J'ai perdu mon deploy token — puis-je le revoir ?

Non. Le token en clair n'est affiché qu'une fois, à la création. Révoquez-le avec cdnctl deploy-token revoke et créez-en un nouveau ; l'ancien cesse immédiatement de fonctionner.

Le déploiement affiche « Build failed » — où sont les logs ?

cdnctl deploy affiche le log de build en cas d'échec. Les causes les plus fréquentes : un Dockerfile qui copie node_modules de l'hôte dans l'image et une dépendance absente du manifeste — cdnctl check détecte les deux avant tout envoi. Logs d'exécution : cdnctl container apps logs --app <app_uuid>.

Sur quel port mon application doit-elle écouter ?

Écoutez sur le port déclaré dans cdnctl.yaml, sur toutes les interfaces (0.0.0.0). cdnctl check signale un lien limité à localhost, car le trafic de la plateforme atteint le conteneur depuis l'extérieur du loopback.