Consigli

Consigli utili e comuni gotchas durante l'esecuzione di applicazioni Laravel su Herne.

Prima lista di controllo

pubblico a web_root migrazione — Se stai migrando un layout del sito precedente, sposta la directory pubblica / esistente in web_root prima di cambiare la radice del documento.

  1. Creare il sito ed eseguire la procedura guidata di configurazione per configurare il repo Git, .env e il database.
  2. Se si sta aggiornando un vecchio sito, spostare la vecchia directory /var/www/domain/public a /var/www/domain/web_root prima di cambiare la radice del documento.
  3. Dopo il primo dispiegamento, eseguire php artisan key:generate dal runner Artisan se APP_KEY è vuoto.
  4. Eseguire storage:link dal runner Artisan se l'app utilizza lo storage su disco public.
  5. Eseguire migrate --force dal corridore Artisan o abilitare il passaggio di migrazione in Deploy Config.

Installazione rapida Retry

Se WebBlocks CMS Quick Install non riesce, aprire i registri delle app, fissare il database segnalato, il permesso, DNS o problema runtime, quindi utilizzare Installazione di Retry. L'installatore pulisce i file parziali sicuri prima di riprovare e protegge le installazioni finalizzate dall'essere sovrascritti.

Le migliori pratiche ambientali

  • Set APP_ENV=produzione e APP_DEBUG=false in .env per tutti i siti in tensione.
  • Dopo aver cambiato .env, eseguire optimize:clear o ricostruire le cache dal runner Artisan.
  • Impostare SESSION_DRIVER=file o database — evitare cookie sulla produzione.
  • Impostare QUEUE_CONNECTION=database (o redis) se si utilizzano lavori in coda - non utilizzare mai sync in produzione.

DNS e SSL

  • La propagazione di DNS può richiedere tempo. Tenere un record di errori disadattamenti rigorosi; non ignorare un nome host che indica al server sbagliato.
  • Gli amministratori possono aggiungere più account Hetzner DNS sotto Admin → Collegamenti DNS. Collegare ogni dominio alla connessione che possiede la sua zona.
  • Se una zona si sposta in un altro account Hetzner, aggiorna il token o allega il dominio alla nuova connessione, quindi usa Ricollegare DNS Zone.
  • Per le zone esterne migrate DNS, gli avvisi apex NS possono essere informati quando il record A è corretto.
  • Dopo l'aggiunta di alias, utilizzare Impostazioni → SSL / HTTPS → Resync SSL in modo da Herne controlla la copertura del certificato dal vivo.

Correggere il tipo di applicazione

Se un sito è stato creato come Obiettivo vuoto / distribuzione o Sito statico, ma un operatore ha successivamente implementato Laravel nella sua canonica web_root con la radice del documento /public, un amministratore può aprire Sito → Impostazioni → General → Applicazione Runtime e scegliere Passa a Laravel.

Questo corregge solo i metadati di gestione di Herne. Non installa Laravel, ispeziona o ripara l'applicazione, sposta i file, cambia Nginx, esegui le migrazioni, oppure avvia un Queue Worker. Verificare l'applicazione utilizzata in modo indipendente prima di confermare, quindi eseguire il preflight di ciascuna funzione Laravel.

worker di coda

Herne non gestisce i worker di coda.

  1. Vai a Server → Operazioni cron
  2. Aggiungi: * * * * * cd /var/www/domain && php artisan queue:work --stop-when-empty >> /dev/null 2>&1

Questo gestisce il worker ogni minuto e si esce quando la coda è vuota (salvo che un processo di lunga durata sotto cron).

Permessi di stoccaggio

Se si ottengono errori permesso negato su storage/ o bootstrap/cache/, eseguire dal Terminal:

chmod -R 775 storage bootstrap/cache

Primo caricamento lento

Dopo aver attivato il cache config/route tramite Deploy Config, la prima richiesta dopo una nuova distribuzione può essere lenta mentre OPcache si riscalda.

Attività WebBlocks UI

Herne carica WebBlocks UI attraverso resources/views/partials/_webblocks-assets.blade.php e App\Support\WebBlocksUiAssets. Non aggiungere nuovi riferimenti alla cartella di asset rimossa /public/webblocks-ui.