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:
composer install --no-dev --optimize-autoloadernpm ci && npm run buildsolo per applicazioni gestite che spediscono il proprio frontend costruire pipelinephp artisan migrate --forcephp 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.
- Vai a Siti → Distribuzione → Distribuzione Git e fai clic su Generare chiave di distribuzione.
- Copiare la chiave pubblica visualizzata sullo schermo.
- Su GitHub: Repository → Impostazioni → Deploy keys → Aggiungi il tasto di distribuzione. Incolla la chiave. L'accesso di sola lettura è sufficiente.
- 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/publice 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 verificaindex.htmldopo 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; Laravelresources/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/cachee obiettivo Composervendorprima 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 --forcee 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-256con la firma HMAC SHA-256 del carico di pagamento grezzo JSON - Filtro di ramificazione — le spinte ad altri rami vengono ignorate automaticamente
Setup GitHub
- Apri le impostazioni del repository webhook su GitHub
- Impostare il carico di pagamento URL al valore indicato nella pagina Git Deploy del sito
- Utilizzare
application/jsoncome tipo di contenuto - Incolla il segreto generato da Herne nel campo segreto webhook
- 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.