Distribuzione

Configurare un repository Git URL, ramificare e distribuire il percorso sotto la scheda Deploy.

Configurazione delle applicazioni

Distribuzione Git è il flusso di redistribuzione e webhook basato sul repository. Usalo quando Herne dovrebbe tirare un ramo di repository Git salvato su richiesta o dal webhook per-site firmato.

Vai a Siti → Distribuzione → Distribuzione Git e compila:

  • URL del repository — URL HTTPS o SSH (ad es. git@github.com:user/repo.git)
  • Branch — ramo da distribuire (predefinito: main)
  • Percorso di deploy — la radice del sito è fissata a /var/www/example.com/web_root. Puoi aggiungere solo un suffisso consentito, come /current.

Il percorso di distribuzione non può mai sfuggire all'attuale web_root del sito. I segmenti traversali del percorso come .. sono respinti.

Modalità radice del sito

I nuovi siti scelgono una modalità di root esplicita durante la creazione. Obiettivo vuoto / distribuzione e App gestita da Publisher iniziano con solo /var/www/example.com/web_root; Herne non crea una cartella vuota public/ per quelle modalità. App Laravel e Sito statico iniziano con web_root/public perché il loro runtime iniziale ha bisogno di una radice del documento pubblico.

I siti esistenti mantengono il loro salvato document_root. Runtime si applica ancora prepara radici pubbliche legacy per i record esistenti che sono stati creati prima che le modalità root esistessero.

Utente e Convalida di Runtime

I dislochi si corrono all'interno del percorso di progetto del sito corrente. I controlli esistenti hanno la loro sincronizzazione remota origin al repository salvato URL prima di fetch/reset, che impedisce il repository stale URLs di distribuire silenziosamente vecchio codice.

Dopo l'applicazione delle impostazioni di runtime-affecting, Herne convalida la configurazione generata Nginx/runtime prima del ricaricamento. Se la validazione non riesce, il cambiamento in fase viene rirottato invece di lasciare una configurazione attiva rotta.

Costruire i passi

Abilitare i passaggi di cui l'applicazione gestita ha bisogno. Essi funzionano in questo ordine dopo git pull:

  1. composer install --no-dev --optimize-autoloader
  2. npm ci && npm run build solo per applicazioni gestite che spediscono il proprio frontend costruire pipeline
  3. php artisan migrate --force
  4. php artisan config:cache && php artisan route:cache && php artisan view:cache

Herne Panel è basato su un'assettazione statica e non utilizza Vite, Tailwind, npm, lockfiles, public/build o public/hot. La casella di controllo opzionale npm si applica solo al sito che si sta implementando, mai al pacchetto runtime del pannello o rilascio.

Repositori privati (Cerca del destinatario)

Per i repository privati, generare una chiave di distribuzione e aggiungerla a GitHub / GitLab come chiave di distribuzione di sola lettura.

  1. Vai a Siti → Distribuzione → Distribuzione Git e fai clic su Generare chiave di distribuzione.
  2. Copiare la chiave pubblica visualizzata sullo schermo.
  3. Su GitHub: Repository → Impostazioni → Deploy keys → Aggiungi il tasto di distribuzione. Incolla la chiave. L'accesso di sola lettura è sufficiente.
  4. Su GitLab: Repository → Impostazioni → Repository → Deploy chiavi.

La chiave di distribuzione è una tastiera ed25519 memorizzata in storage/app/deploy-keys/. Solo la chiave pubblica è mostrata nel pannello.

Avvio di una distribuzione

Fare clic su Distribuisci ora per tirare il codice più recente ed eseguire i passaggi configurati. Navigare a Siti → Distribuzione → Distribuzione Git e fare clic sul pulsante Distribuisci ora.

Log di distribuzione

Tutte le rune di distribuzione sono registrate — fare clic su qualsiasi voce in recenti Diploys per vedere l'output completo. Ogni voce di registro mostra l'output completo della shell, il codice di uscita, e se il dispiegamento è riuscito o non è riuscito.

Distribuzione da Publisher

Lo schermo Siti → Distribuzione → Distribuzione da Publisher supporta le implementazioni GitHub-free da Publisher. Server Publisher, prodotto e canale possono essere ricordati per sito; Herne non assume un prodotto predefinito. I siti senza un server salvato utilizzano https://publisher.webblocksui.com, il server di Publisher canonico per le versioni standard attuali; qualsiasi altro server viene inserito come un HTTPS URL personalizzato.

Creare il prodotto e generare una chiave del prodotto Publisher nella gestione dei prodotti Publisher, quindi incollare quella chiave nel modulo di distribuzione Herne. Herne utilizza la chiave per le richieste di metadati/artifact di Publisher. Le chiavi incollate non sono perseguite per impostazione predefinita, ma possono essere salvate crittografate per sito, sostituite o cancellate.

Herne invia la chiave al server Publisher selezionato per le richieste dei metadati di rilascio e del pacchetto, scarica lo ZIP, verifica il suo checksum SHA-256, lo estrae in una directory di preparazione e applica il profilo di sicurezza selezionato. I pacchetti Laravel usano laravel_app nel percorso di distribuzione del sito. I pacchetti statici usano static_site solo per le radici dei siti statici Herne e vengono applicati alla radice pubblica reale del sito. Le voci nella radice sono limitate a index.html, robots.txt, assets/**, games/**, site/**, favicon.ico, manifest.json e version.json. Le aree delle risorse statiche seguono un profilo con un elenco di esclusione: sono ammessi gli output Flutter Web come games/*/main.dart.js, games/*/icons/**, games/*/assets/shaders/*.frag, games/*/assets/packages/**, games/*/canvaskit/**, i percorsi delle risorse di prodotto come site/webblocks-play/css/site.css e i file NOTICES. Restano bloccati i percorsi nascosti, l’attraversamento delle directory, i file di backup o temporanei, le configurazioni del server e i file eseguibili o elaborati lato server. Per un sito statico esistente, l’aggiornamento sicuro conserva index.html della radice pubblica nell’area di preparazione se il pacchetto ne è privo e interrompe l’applicazione se non esiste un indice nella radice preparata o in quella esistente.

  • Se la destinazione è vuota, la distribuzione da Publisher esegue la prima installazione.
  • Publisher-gestito prima distribuisce l'interruttore a web_root/public e applica Laravel/static runtime quando l'artefatto include una radice pubblica.
  • Esistente Laravel app: Publisher Deploy richiede una conferma esplicita, le istantanee hanno cambiato i file ed esegue un aggiornamento sicuro.
  • Existing Static site: Publisher Deploy accetta i metadati espliciti static-site/static_site, mostra un avviso di sostituzione invece del blocco Laravel, richiede il riconoscimento, stadi una radice pubblica sostitutiva e verifica index.html dopo l'applicazione.
  • Gli obiettivi non vuoti che non sembrano applicazioni Laravel sono bloccati per la sicurezza.
  • Le chiavi del prodotto mancanti bloccano il dispiegamento prima che il metadati fetch, il download artefatto, la verifica del checksum, l'estrazione o i passaggi post-deploy iniziano.
  • Le voci non sicure ZIP vengono rifiutate, tra cui percorso trasversale, percorsi assoluti, simlink rilevabili, segmenti dot, .env, .git, .github, cartelle di dipendenza a livello root, storage/, bootstrap/cache/, uscite generate di costruzione frontonend e file di blocco npm/yarn/pnpm. Le directory di dipendenza sono bloccate a livello di root; Laravel resources/views/vendor/ sono consentiti overrides di vista pubblicati.
  • I guasti di ispezione dell'artefatto mostrano il primo percorso e la ragione relativi respinti nel registro di distribuzione senza esporre token, percorsi di temp, percorsi assoluti del server o tracce di stack.
  • Esistendo .env, storage/, bootstrap/cache/, vengono conservati upload e file runtime.
  • L’applicazione della distribuzione e le operazioni successive devono usare l’utente di esecuzione e distribuzione del sito configurato per scrivere nell’albero di destinazione. I siti standard gestiti da Herne usano il modello di proprietà e gruppo www-data.
  • Il preflight di permissione controlla la radice di destinazione, l'artefatto applica obiettivi, directory runtime Laravel, bootstrap/cache e obiettivo Composer vendor prima dell'applicazione. Le autorizzazioni non sicure si abortiscono prima che i file vengano modificati.
  • I passaggi opzionali post-deploy possono eseguire composer install --no-dev --prefer-dist --optimize-autoloader, php artisan migrate --force e ottimizzare/cache chiaro.
  • Se manca .env, i passaggi artisan post-deploy vengono saltati e il registro di distribuzione spiega il passo successivo.

Publisher Deploy è riutilizzabile per qualsiasi prodotto Publisher supportato, tra cui WebBlocks Workbench, CMS, Plugins, QuizTem o prodotti futuri. Gli aggiornamenti successivi possono essere effettuati tramite Editor Deploy o attraverso la schermata di System Updates del prodotto quando è disponibile.

Installazione rapida delle app

La distribuzione resta lo strumento adatto alle applicazioni basate su Git. Per le app supportate, Siti → Apps → Installazione rapida può creare un’app senza distribuire un repository. WebBlocks CMS prepara l’app CMS e genera le credenziali del database. Laravel App crea solo una struttura Laravel pulita e aggiornata, imposta Laravel come ambiente di esecuzione e lascia installare in seguito prodotti come QuizTem tramite Composer o Terminale. L’installazione rapida accetta una directory web_root o public/ vuota, ma rifiuta i file preesistenti arbitrari e non li elimina automaticamente.

Webhook di distribuzione per sito

Ogni sito con una configurazione di distribuzione salvata ottiene anche la propria scheda webhook sulla pagina Git Deploy.

  • URL — POST /sites/{site}/webhook/deploy
  • Segreto — generato automaticamente e mostrato nel pannello
  • Intestazione della firma — inviare X-Hub-Signature-256 con la firma HMAC SHA-256 del carico di pagamento grezzo JSON
  • Filtro di ramificazione — le spinte ad altri rami vengono ignorate automaticamente

Setup GitHub

  1. Apri le impostazioni del repository webhook su GitHub
  2. Impostare il carico di pagamento URL al valore indicato nella pagina Git Deploy del sito
  3. Utilizzare application/json come tipo di contenuto
  4. Incolla il segreto generato da Herne nel campo segreto webhook
  5. Selezionare l'evento spinta solo

Questo webhook per-site è per l'applicazione inquilinare distribuisce solo. Aggiornare Herne è un flusso di sola amministrazione separato — vedere lo schermo Aggiornamenti del pannello, che applica le versioni WebBlocks Publisher invece di un webhook.