Conseils
Conseils utiles et gotchas communs lors de l'exécution des applications Laravel sur Herne.
Première liste de contrôle du déploiement
migration publique vers web_root — Si vous migrez une ancienne mise en page du site, déplacez le répertoire public/ existant dans web_root avant de changer la racine du document.
- Créez le site et lancez l'Assistant de configuration pour configurer la repo Git,
.envet la base de données. - Si vous mettez à jour un ancien site, déplacez l'ancien répertoire
/var/www/domain/publicvers/var/www/domain/web_rootavant de changer la racine du document. - Après le premier déploiement, lancez php artisan key:generate à partir du coureur Artisan si APP_KEY est vide.
- Exécutez
storage:linkà partir du coureur Artisan si votre application utilise le stockage disquepublic. - Exécutez
migrate --forceà partir du coureur Artisan ou activez l'étape de migration dans Deploy Config.
Installation rapide de réessayer
Si WebBlocks CMS Quick Install échoue, ouvrez les journaux de l'application, corrigez la base de données, les permissions, DNS ou les problèmes d'exécution, puis utilisez Réessayer l'installation. L'installateur nettoie les fichiers partiels sûrs avant de réessayer et protège les installateurs finalisés d'être écrasés.
Pratiques exemplaires en matière d'environnement
- Définissez APP_ENV=production et APP_DEBUG=false dans .env pour tous les sites en direct.
- Après avoir changé
.env, exécutezoptimize:clearou rebâtissez des caches à partir du coureur Artisan. - Réglez
SESSION_DRIVER=fileoudatabase— évitezcookiesur la production. - Définissez
QUEUE_CONNECTION=database(ouredis) si vous utilisez des tâches en file d'attente — n'utilisez jamaissyncsur la production.
DNS et SSL
- La propagation de DNS peut prendre du temps. Gardez un enregistrement mal assorti strict ; n'ignorez pas un nom d'hôte pointant sur le mauvais serveur.
- Admins peut ajouter plusieurs comptes Hetzner DNS sous Admin → Connexions DNS. Joindre chaque domaine à la connexion qui possède sa zone.
- Si une zone se déplace vers un autre compte Hetzner, mettez à jour le jeton ou attachez le domaine à la nouvelle connexion, puis utilisez Reconnecter la zone DNS.
- Pour les zones DNS externes migrées, les avertissements apex NS peuvent être informatifs lorsque l'enregistrement A est correct.
- Après avoir ajouté des alias, utilisez Paramètres → SSL / HTTPS → Re-sync SSL afin que Herne vérifie la couverture du certificat en direct.
Correction du type de demande
Si un site a été créé sous la forme de Cible vide/déploiement ou Site statique, mais qu'un opérateur a ensuite déployé Laravel dans son canonique web_root avec la racine de document /public, un administrateur peut ouvrir Site → Paramètres → Général → Application Durée et choisir Passer à Laravel.
Ceci corrige uniquement les métadonnées de gestion Herne. Il n'installe pas Laravel, inspecte ou répare l'application, déplace des fichiers, change Nginx, exécute des migrations ou démarre un travail de recherche. Vérifier l'application déployée indépendamment avant de confirmer, puis exécuter chaque fonction Laravel-seulement de prévol propre.
workers en file d'attente
Herne ne gère pas les workers de la file d'attente.
- Aller à Serveur → Tâches cron
- Ajouter :
* * * * * cd /var/www/domain && php artisan queue:work --stop-when-empty >> /dev/null 2>&1
Cela exécute le worker toutes les minutes et sort lorsque la file d'attente est vide (plus sûre qu'un processus à long terme sous cron).
Autorisations de stockage
Si vous recevez des erreurs autorisation refusée sur storage/ ou bootstrap/cache/, lancez depuis le terminal:
chmod -R 775 storage bootstrap/cache
Premier chargement lent
Après avoir activé la mise en cache config/route via Deploy Config, la première demande après un nouveau déploiement peut être lente pendant que OPcache se réchauffe. Ceci est normal.
Actifs WebBlocks UI
Herne charge WebBlocks UI dans resources/views/partials/_webblocks-assets.blade.php et App\Support\WebBlocksUiAssets. N'ajoutez pas de nouvelles références au dossier d'actifs /public/webblocks-ui supprimé.