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.

  1. Créez le site et lancez l'Assistant de configuration pour configurer la repo Git, .env et la base de données.
  2. Si vous mettez à jour un ancien site, déplacez l'ancien répertoire /var/www/domain/public vers /var/www/domain/web_root avant de changer la racine du document.
  3. Après le premier déploiement, lancez php artisan key:generate à partir du coureur Artisan si APP_KEY est vide.
  4. Exécutez storage:link à partir du coureur Artisan si votre application utilise le stockage disque public.
  5. 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écutez optimize:clear ou rebâtissez des caches à partir du coureur Artisan.
  • Réglez SESSION_DRIVER=file ou database — évitez cookie sur la production.
  • Définissez QUEUE_CONNECTION=database (ou redis) si vous utilisez des tâches en file d'attente — n'utilisez jamais sync sur 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.

  1. Aller à Serveur → Tâches cron
  2. 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é.