Procedura guidata di configurazione del sito

Segui i quattro passaggi della procedura guidata per collegare un repository Git, compilare .env, creare un database ed eseguire il primo deploy.

Per le applicazioni supportate, Siti → App → Installazione rapida è l’opzione più veloce. Usa la procedura guidata se colleghi un tuo repository e vuoi controllare manualmente distribuzione, ambiente, database e primo deploy.

Esempio del sito Laravel

Se vuoi creare un sito e distribuire un repository Laravel come git@github.com:example/example.com.git, la procedura guidata è il metodo più veloce.

Prima di iniziare

  • Creare il sito prima da Siti → Nuovo Sito.
  • Per Laravel, mantenere la radice del documento iniziale come web_root/public.
  • Scegliere il dominio corretto e la versione PHP prima di aprire la procedura guidata.
  • Se il dominio è un dominio apex, è possibile abilitare facoltativamente l'alias www durante la creazione del sito.

Fase 1 — Disoccupazione

Compila le impostazioni del repository e della distribuzione:

  • URL del repository: git@github.com:example/example.com.git
  • Branch: di solito main, a meno che il repository non ne usi un altro
  • Percorso di deploy: lascia vuoto il suffisso per clonare il progetto direttamente in web_root.

Opzioni di costruzione consigliate per un progetto Laravel:

  • composer install: attivo
  • npm build: abilitalo solo se il progetto richiede una compilazione del frontend con Node. Herne Panel non richiede npm.
  • php artisan migrate: abilitalo se crei il database al passaggio 3 e scrivi le stesse credenziali in .env.
  • optimize / cache clear: attivo

Il repository SSH URLs attiva automaticamente la generazione di chiavi quando possibile. È inoltre possibile generare la chiave in seguito dalla pagina Deploy.

Passaggio 2 — .env

Incolla o modifica i valori di produzione di .env per l’applicazione. Controlla almeno le voci qui sotto.

  • APP_NAME
  • APP_ENV=production
  • APP_URL=https://your-domain
  • DB_DATABASE, DB_USERNAME, DB_PASSWORD
  • Mail, coda, cache e tutte le impostazioni API di terze parti richieste dall'app

Se l'applicazione utilizza Redis per cache, sessioni o code, utilizzare l'azione Applica le impostazioni Redis predefinite integrata prima di salvare.

In un sito appena creato il repository non è ancora stato clonato. .env.example potrebbe non essere disponibile in questa fase. Tieni pronti i valori da incollare manualmente.

Passaggio 3 — Database

Crea un database MySQL se l’applicazione Laravel ne ha bisogno.

  • Inserisci il nome del database.
  • Inserisci il nome utente del database.
  • Imposta una password robusta.
  • Verifica che gli stessi valori siano riportati in .env.

Se il progetto non usa un database, puoi saltare questo passaggio.

Se il database esiste già sul server, è possibile terminare la procedura guidata prima e poi utilizzare Siti → Databases → Attach Existing per collegarlo al sito.

Fase 4 — Prima distribuzione

Se il repository è privato e la procedura guidata mostra una chiave di distribuzione pubblica:

  1. Copia la chiave pubblica mostrata nella procedura guidata.
  2. Apri il repository su GitHub.
  3. Vai su Settings → Deploy keys → Add deploy key.
  4. Incolla la chiave e lasciala in sola lettura, salvo che ti serva l’accesso in scrittura.

Dopo di che, fare clic su Distribuisci ora per clonare il repository ed eseguire i passaggi selezionati.

Dopo il Primo Discorso

I progetti Laravel hanno spesso bisogno di alcuni controlli di follow-up dopo l'implementazione iniziale:

  • Esegui php artisan key:generate se APP_KEY è vuota.
  • Esegui php artisan storage:link se il progetto richiede il collegamento simbolico allo storage pubblico.
  • Controlla Siti → Log se il deploy segnala errori.
  • Controlla Siti → Log → Log del server se dopo il deploy compaiono errori Nginx o PHP-FPM.
  • Controlla Siti → Ambiente e Siti → Artisan se il sito si avvia con problemi di configurazione.

Installazione rapida alternativa

Usa Siti → Apps → Installazione rapida per WebBlocks CMS o una struttura Laravel App pulita. WebBlocks CMS genera le credenziali del database e configura il CMS; Laravel App installa solo la struttura Laravel, così pacchetti come QuizTem possono essere installati in seguito tramite Composer o Terminale. Entrambe le procedure scrivono valori sicuri in .env, proteggono APP_KEY, verificano la scrivibilità durante l’esecuzione e permettono di riprovare un’installazione fallita dopo una pulizia parziale.