Init et déploiement

​

Initialiser un projet

kennhosting init

project: mon-app
environments:
  production:
    service_uuid: "..."
    domain: "app.example.com"
    branch: "main"
    build:
      type: laravel
      php: "8.4"
      run_migrations: true
      assets:
        enabled: true
        command: "npm run build"
        output_dir: "public/build"
    hooks:
      pre_deploy: []
      post_deploy: []

project: mon-app-react
environments:
  production:
    service_uuid: "..."
    domain: "app.example.com"
    branch: "main"
    build:
      type: react
      assets:
        enabled: true
        command: "npm run build"
        output_dir: "dist"

​

Premier déploiement

kennhosting deploy setup

• Laravel : clone le dépôt sur le serveur (via un dossier temporaire fusionné dans le docroot, pour préserver les fichiers que cPanel y place déjà, comme .well-known, requis par AutoSSL) et prépare le docroot.
• React / static : aucun clone, équivalent à kennhosting deploy (le serveur n’héberge jamais le code source, seulement le build). Les deux commandes existent pour la cohérence de l’interface, mais font la même chose pour ces types.

​

Déploiements suivants

kennhosting deploy

• Laravel : git pull sur le serveur, upload des assets pré-buildés localement, composer, migrations (si activées), cache Laravel, redémarrage des workers de queue.
• React : build local (build.assets.command), puis upload direct de output_dir dans le docroot : l’ancien contenu est remplacé (pas fusionné), sauf les entrées gérées par cPanel (.well-known, cgi-bin).
• static : pas de build, upload direct de output_dir (racine du projet par défaut) dans le docroot, même logique de remplacement.

​

Assets frontend

1. Exécute la commande de build en local
2. Vérifie output_dir (ex. public/build)
3. Upload les artefacts après git pull sur le serveur

​

Tableau de bord TUI

​

Dépannage rapide

• Token refusé : vérifiez le scope cli:deploy sur Espace développeur
• Domaine introuvable : le domaine doit être attaché au service dans le panel
• Build assets échoue : testez npm run build localement avant kennhosting deploy
• Le déploiement affiche ”✔ Setup terminé” mais le site reste vide : l’accès shell SSH doit être activé sur votre service pour que kennhosting deploy/deploy setup puisse cloner et installer votre application. Sans lui, le compte refuse silencieusement chaque commande. Contactez le support KENN HOSTING pour vérifier l’accès shell de votre service.