Déploiement
Configurer un dépôt Git URL, une branche et déployer le chemin sous l'onglet Déployer.
Déployer la configuration
Déploiement Git est le flux de redéployement et de webhook basé sur le dépôt. Utilisez-le quand Herne devrait tirer une branche de dépôt Git sauvegardée sur demande ou à partir du webhook signé par site.
Allez sur Sites → Déploiement → Déploiement Git et remplissez :
- URL du dépôt — URL HTTPS ou SSH (p. ex.
git@github.com:user/repo.git) - Branche — branche à déployer (par défaut :
main) - Chemin de déploiement — la racine du site est fixée à
/var/www/example.com/web_root. Vous pouvez uniquement ajouter un suffixe autorisé comme/current.
Le chemin de déploiement ne peut jamais échapper au web_root du site actuel. Les segments de chemin traversant tels que .. sont rejetés.
Modes de racine du site
Les nouveaux sites choisissent un mode racine explicite pendant la création. Cible vide/déploiement et Application gérée par Publisher commencent avec seulement /var/www/example.com/web_root; Herne ne crée pas de dossier public/ vide pour ces modes. Application Laravel et Site statique commencent par web_root/public parce que leur exécution initiale nécessite une racine de document public.
Les sites existants conservent leur document_root sauvegardé. L'application Runtime prépare toujours les racines publiques héritées des enregistrements existants qui ont été créés avant l'existence des modes root.
Utilisateur et validation de l'exécution
Des déploiements s'effectuent dans le parcours du projet actuel. Les commandes existantes ont leur télécommande origin synchronisée avec le dépôt enregistré URL avant de récupérer/reset, ce qui empêche le dépôt statique URLs de déployer silencieusement l'ancien code.
Après l'application des paramètres d'impact sur l'exécution, Herne valide la configuration Nginx/runtime générée avant de recharger. Si la validation échoue, le changement par étapes est repoussé au lieu de laisser une configuration active cassée.
Étapes de construction
Activer les étapes nécessaires à l'application gérée. Ils fonctionnent dans cet ordre après git pull:
composer install --no-dev --optimize-autoloadernpm ci && npm run builduniquement pour les applications gérées qui expédient leur propre pipeline de construction frontendphp artisan migrate --forcephp artisan config:cache && php artisan route:cache && php artisan view:cache
Herne Panel est lui-même basé sur l'ensemble statique et n'utilise pas de Vite, Tailwind, npm, Lockfiles, public/build ou public/hot. La case à cocher optionnelle npm s'applique uniquement au site que vous déployez, jamais au panneau d'exécution ou au paquet de libération.
Dépôts privés (clés de paiement)
Pour les dépôts privés, générer une clé de déploiement et l'ajouter à GitHub / GitLab en lecture seule.
- Allez dans Sites → Déploiement → Déploiement Git et cliquez sur Générer la clé de déploiement.
- Copier la clé publique affichée à l'écran.
- Sur GitHub: Dépôt → Paramètres → Déploiement → Ajout de la clé de déploiement. Coller la clé. L'accès en lecture seule est suffisant.
- Sur GitLab: Dépôt → Paramètres → Dépôt → Déploiement des clés.
La clé de déploiement est un ed25519 keypair stocké dans storage/app/deploy-keys/. Seule la clé publique est affichée dans le panneau.
Déclencher un déploiement
Cliquez sur Déployer Maintenant pour tirer le dernier code et exécuter les étapes configurées. Naviguez vers Sites → Déploiement → Déploiement Git et cliquez sur le bouton Déployez-vous.
Déployer des journaux
Tous les déploiements sont enregistrés — cliquez sur n'importe quelle entrée dans les Déploiements Récents pour voir la sortie complète. Chaque entrée de journal affiche la sortie complète du shell, le code de sortie et si le déploiement a réussi ou a échoué.
Déploiement via Publisher
L'écran Sites → Déploiement → Déploiement via Publisher prend en charge les déploiements sans GitHub depuis l'Publisher. Serveur de Publisher, produit et canal peuvent être mémorisés par site; Herne ne suppose pas un produit par défaut. Les sites sans serveur sauvegardé utilisent https://publisher.webblocksui.com, le serveur canonique Publisher pour les versions standard actuelles; tout autre serveur est entré comme un HTTPS URL personnalisé.
Créez le produit et créez une clé de produit Publisher dans la gestion du produit Publisher, puis collez cette clé dans le formulaire de déploiement Herne. Herne utilise la clé pour les métadonnées de Publisher/demandes d'artefact. Les clés collées ne sont pas maintenues par défaut, mais elles peuvent être enregistrées cryptées par site, remplacées ou effacées.
Herne envoie la clé au serveur Publisher sélectionné pour les demandes de métadonnées de version et de paquet, télécharge le ZIP, vérifie sa somme SHA-256, l’extrait dans un répertoire de préparation, puis applique le profil de sécurité choisi. Les paquets Laravel utilisent laravel_app dans le chemin de déploiement du site. Les paquets statiques utilisent static_site uniquement pour les racines de sites statiques Herne et sont appliqués dans la véritable racine publique du site. Les entrées à la racine se limitent à index.html, robots.txt, assets/**, games/**, site/**, favicon.ico, manifest.json et version.json. Les zones de ressources statiques suivent un profil avec liste d’exclusion. Cela permet le déploiement de fichiers Flutter Web tels que games/*/main.dart.js, games/*/icons/**, games/*/assets/shaders/*.frag, games/*/assets/packages/**, games/*/canvaskit/**, de chemins de ressources produit tels que site/webblocks-play/css/site.css et de fichiers NOTICES. Les chemins masqués, la traversée de répertoires, les fichiers de sauvegarde ou temporaires, les configurations serveur et les fichiers exécutables ou traités côté serveur restent bloqués. Pour un site statique existant, le déploiement sécurisé conserve index.html de la racine publique dans le répertoire de préparation si le paquet n’en contient pas. Il s’arrête avant application si aucun index de racine n’existe dans le répertoire de préparation ou le site actuel.
- Sur une cible vide, le déploiement via Publisher effectue la première installation.
- La première version de l'objet est dirigée par l'Publisher et elle est activée sur
web_root/publicet applique Laravel/statique lorsque l'objet comprend une racine publique. - Application Laravel existante: Publisher Deploy nécessite une confirmation explicite, des snapshots changés de fichiers et effectue une mise à jour sécurisée.
- Site statique existant : Déploiement via Publisher accepte les métadonnées
static-site/static_siteexplicites, affiche un avertissement de remplacement au lieu du bloqueur Laravel, nécessite une reconnaissance, met en place un root public de remplacement et vérifieindex.htmlaprès application. - Les cibles non vides qui ne ressemblent pas à des applications Laravel sont bloquées pour des raisons de sécurité.
- Les touches manquantes bloquent le déploiement avant que les métadonnées ne récupèrent, que les artefacts ne soient téléchargés, que la vérification, l'extraction ou les étapes postérieures au déploiement commencent.
- Les entrées de ZIP non sûres sont rejetées, y compris les chemins de chemin traversants, les chemins absolus, les liens symboliques détectables, les segments de points,
.env,.git,.github, les dossiers de dépendance au niveau racine,storage/,bootstrap/cache/, les sorties de construction frontend générées et les fichiers de verrouillage npm/yarn/pnpm. Les répertoires de dépendance sont bloqués au niveau racine; les overfores de vue publiées Laravelresources/views/vendor/sont autorisées. - Les défaillances d'inspection artifact montrent le premier chemin relatif et raison rejeté dans le journal de déploiement sans exposer les jetons, les chemins temp, les chemins absolus du serveur ou les traces de pile.
- Les fichiers
.env,storage/,bootstrap/cache/existants, les téléchargements et les fichiers d'exécution sont conservés. - L’application du déploiement et les étapes qui suivent doivent s’exécuter avec le compte d’exécution et de déploiement du site configuré pour écrire dans l’arborescence cible. Les sites standard gérés par Herne utilisent le modèle de propriétaire et de groupe
www-data. - La permission de vol vérifie la racine cible, l'artefact applique des cibles, les répertoires d'exécution Laravel,
bootstrap/cacheet Composervendoravant de s'appliquer. Les permissions non sécurisées ont été abandonnées avant que les fichiers ne soient modifiés. - Les étapes post-déploiement en option peuvent exécuter
composer install --no-dev --prefer-dist --optimize-autoloader,php artisan migrate --forceet optimiser/cache. - Si
.envmanque, les étapes artisan post-deploy sont ignorées et le journal de déploiement explique l'étape suivante.
Publisher Deploy est réutilisable pour tout produit de Publisher supporté, y compris WebBlocks Workbench, CMS, Plugins, QuizTem ou produits futurs. Des mises à jour ultérieures peuvent être effectuées par l'intermédiaire de Publisher Deploy ou par le biais du propre écran de Mises à jour système du produit lorsque celui-ci est disponible.
Installer rapidement les applications
Le déploiement reste l’outil adapté aux applications basées sur Git. Pour les applications prises en charge, Sites → Applications → Installation rapide peut créer l’application sans déployer un dépôt. WebBlocks CMS prépare l’application CMS et génère les identifiants de la base de données. Laravel App crée uniquement un squelette Laravel récent, marque le site comme utilisant Laravel et laisse installer ensuite les produits tels que QuizTem via Composer ou le terminal. L’installation rapide accepte un répertoire web_root ou public/ vide, mais refuse les fichiers préexistants arbitraires et ne les supprime jamais automatiquement.
Webhook de déploiement par site
Chaque site avec une configuration de déploiement sauvegardée obtient également sa propre carte webhook sur la page Git Deploy.
- URL —
POST /sites/{site}/webhook/deploy - Secret — généré automatiquement et affiché dans le panneau
- En-tête de la signature — envoyer
X-Hub-Signature-256avec la signature HMAC SHA-256 de la charge utile brute JSON - Filtre de branche — les poussées vers d'autres branches sont ignorées automatiquement
Configuration de GitHub
- Ouvrez les paramètres de votre dépôt webhook sur GitHub
- Définissez la charge utile URL à la valeur affichée sur la page Git Deploy du site
- Utiliser
application/jsoncomme type de contenu - Coller le secret généré de Herne dans le champ secret de webhook
- Sélectionnez uniquement l'événement Pousser
Ce webhook par site est réservé aux applications de locataire. Mettre à jour Herne lui-même est un flux d'administration séparé — voir l'écran Mises à jour des panels, qui applique les versions WebBlocks Publisher au lieu d'un webhook.