Deployment

Konfigurieren Sie eine Git-Repository-URL, einen Branch und einen Deploy-Pfad im Deploy-Tab.

Deployment-Konfiguration

Git-Deployment ist der Repository-basierte Redeploy und Webhook-Flow. Verwenden Sie es, wenn Herne einen gespeicherten Git-Repository-Zweig auf Anfrage oder aus dem signierten Webhook ziehen soll.

Gehen Sie zu Websites → Deployment → Git-Deployment und geben Sie ein:

  • Repository-URL — HTTPS- oder SSH-URL (z. B. git@github.com:user/repo.git)
  • Branch — Branch für das Deployment (Standard: main)
  • Deployment-Pfad — das Website-Stammverzeichnis ist auf /var/www/example.com/web_root festgelegt. Sie können nur einen zulässigen Suffix wie /current anhängen.

Der Deployment-Pfad darf web_root der aktuellen Website nie verlassen. Pfadbestandteile wie .., die zu übergeordneten Verzeichnissen führen, werden abgelehnt.

Modi des Website-Stammverzeichnisses

Neue Websites wählen während der Erstellung einen expliziten Root-Modus. Leer / Deployment-Ziel und Über Publisher verwaltete Anwendung beginnen nur mit /var/www/example.com/web_root; Herne erstellt keinen leeren public/ Ordner für diese Modi. Laravel-App und Statische Website beginnen mit web_root/public, weil ihre anfängliche Laufzeit eine öffentliche Dokumentenwurzel benötigt.

Vorhandene Websites behalten ihre gespeicherten document_root. Runtime Appliance bereitet immer noch Legacy-Public-Roots für bestehende Datensätze vor, die erstellt wurden, bevor Root-Modi existierten.

Laufzeitbenutzer und Validierung

Deploys laufen innerhalb des Projektpfads der aktuellen Site. Bestehende Checkouts haben ihre origin Fernbedienung mit der gespeicherten Repository-URL vor dem Abrufen / Zurücksetzen synchronisiert, was verhindert, dass veraltete Repository-URLs alten Code stillschweigend bereitstellen.

Nachdem laufzeitbeeinflussende Einstellungen angewendet wurden, validiert Herne die generierte Nginx/Runtime-Konfiguration vor dem Neuladen. Wenn die Validierung fehlschlägt, wird die inszenierte Änderung zurückgesetzt, anstatt eine defekte aktive Konfiguration zu hinterlassen.

Build-Schritte

Aktivieren Sie die Schritte, die die verwaltete Anwendung benötigt. Sie laufen in dieser Reihenfolge nach git pull:

  1. composer install --no-dev --optimize-autoloader
  2. npm ci && npm run build nur für verwaltete Apps, die eine eigene Frontend-Build-Pipeline bereitstellen
  3. php artisan migrate --force
  4. php artisan config:cache && php artisan route:cache && php artisan view:cache

Herne Panel verwendet statische Ressourcen und benötigt weder Vite, Tailwind, npm und Lockdateien noch public/build oder public/hot. Das optionale npm-Kästchen gilt nur für die Website, die Sie bereitstellen, und nie für die Panel-Laufzeit oder das Release-Paket.

Private Repositorys (Deployment-Schlüssel)

Für private Repositories einen Deploy-Key generieren und als schreibgeschützten Deploy-Key bei GitHub / GitLab hinzufügen.

  1. Gehe zu Websites → Deployment → Git-Deployment und klicke auf Deployment-Schlüssel erstellen.
  2. Kopieren Sie den angezeigten öffentlichen Schlüssel.
  3. Auf GitHub: Repository → Einstellungen → Deployment-Schlüssel → Deployment-Schlüssel hinzufügen. Füge den Schlüssel ein. Read-Only-Zugriff ist ausreichend.
  4. Öffnen Sie auf GitLab Repository → Einstellungen → Repository → Deployment-Schlüssel.

Der Deployment-Schlüssel ist ein ed25519-Schlüsselpaar, das in storage/app/deploy-keys/ gespeichert ist. Nur der öffentliche Schlüssel wird im Panel angezeigt.

Ein Deployment auslösen

Klicken Sie auf Deploy Now, um den neuesten Code abzurufen und die konfigurierten Schritte auszuführen. Navigieren Sie zu Websites → Deployment → Git-Deployment und klicken Sie auf die Schaltfläche Jetzt bereitstellen.

Deployment-Protokolle

Alle Deploy-Vorgänge werden protokolliert — klicken Sie auf einen Eintrag in Letzte Deploys für die vollständige Ausgabe. Jeder Protokolleintrag zeigt die Vollschalenausgabe, den Exit-Code und ob der Deployment erfolgreich oder fehlgeschlagen ist.

Deployment über Publisher

Der Websites → Deployment → Deployment über Publisher Bildschirm unterstützt GitHub-freie Deployments von Publisher. Publisher Server, Produkt und Kanal können pro Site gespeichert werden; Herne geht nicht von einem Standardprodukt aus. Sites ohne gespeicherten Server nutzen https://publisher.webblocksui.com, den kanonischen Publisher-Server für aktuelle Standard-Releases; jeder andere Server wird als benutzerdefinierte HTTPS-URL eingegeben.

Erstellen Sie das Produkt und generieren Sie einen Publisher Product Key im Publisher-Produktmanagement, und fügen Sie diesen Schlüssel dann in das Herne-Bereitstellungsformular ein. Herne verwendet den Schlüssel für Publisher Metadaten/Artefaktanforderungen. Eingefügte Schlüssel werden standardmäßig nicht beibehalten, aber sie können pro Site verschlüsselt gespeichert, ersetzt oder gelöscht werden.

Herne sendet den Schlüssel für Anfragen nach Release-Metadaten und Artefakten an den ausgewählten Publisher-Server. Anschließend lädt Herne die ZIP-Datei herunter, prüft deren SHA-256-Prüfsumme, entpackt sie in ein Staging-Verzeichnis und wendet das ausgewählte Sicherheitsprofil an. Laravel-Artefakte werden mit laravel_app im Bereitstellungspfad der Website installiert. Statische Artefakte verwenden static_site ausschließlich für statische Herne-Websites und werden in deren tatsächliches öffentliches Stammverzeichnis installiert. Im Stammverzeichnis sind nur index.html, robots.txt, assets/**, games/**, site/**, favicon.ico, manifest.json und version.json zulässig. Für statische Assets gilt ein Profil mit Sperrliste. Damit lassen sich Flutter-Web-Ausgaben wie games/*/main.dart.js, games/*/icons/**, games/*/assets/shaders/*.frag, games/*/assets/packages/** und games/*/canvaskit/**, Produkt-Asset-Pfade wie site/webblocks-play/css/site.css und NOTICES-Dateien bereitstellen. Versteckte Pfade, Ausbrüche aus dem Zielverzeichnis, Sicherungs- und temporäre Dateien, Serverkonfigurationen sowie ausführbare und serverseitige Dateien bleiben gesperrt. Bei einem sicheren statischen Update übernimmt Herne die vorhandene index.html aus dem öffentlichen Stammverzeichnis in das Staging-Verzeichnis, falls das Artefakt keine mitliefert. Gibt es weder im Staging- noch im bestehenden Stammverzeichnis eine Indexdatei, bricht Herne vor der Installation ab.

  • Bei leerem Ziel führt das Deployment über Publisher die Erstinstallation durch.
  • Erstdeployments über Publisher wechseln zu web_root/public und wenden die Laravel- oder statische Laufzeit an, wenn das Paket ein öffentliches Stammverzeichnis enthält.
  • Für eine vorhandene Laravel-Anwendung verlangt das Deployment über Publisher eine ausdrückliche Bestätigung, sichert die geänderten Dateien in einem Snapshot und aktualisiert die Anwendung sicher.
  • Existing Static site: Publisher Deploy akzeptiert explizite static-site/static_site Metadaten, zeigt eine Ersatzwarnung anstelle des Laravel-Blockers an, erfordert eine Bestätigung, inszeniert eine Ersatz-Public-Root und überprüft index.html nach dem Anwenden.
  • Nicht leere Ziele, die nicht wie Laravel-Apps aussehen, werden aus Sicherheitsgründen blockiert.
  • Fehlende Product Keys blockieren die Bereitstellung, bevor Metadaten abrufen, Artefakt herunterladen, Prüfsummenverifizierung, Extraktion oder Schritte nach der Bereitstellung beginnen.
  • Unsichere ZIP-Einträge werden abgelehnt, einschließlich Pfad-Traversal, absoluten Pfaden, detektierbaren Symlinks, Punktsegmenten, .env, .git, .github, Root-Level-Abhängigkeitsordnern, storage/, bootstrap/cache/, generierten Frontend-Build-Ausgaben und npm/yarn/pnpm-Lock-Dateien. Abhängigkeitsverzeichnisse werden auf Root-Ebene blockiert; Laravelresources/views/vendor/veröffentlichte View-Overrides sind erlaubt.
  • Artefaktinspektionsfehler zeigen den ersten abgelehnten relativen Pfad und Grund im Bereitstellungsprotokoll an, ohne Token, Temp-Pfade, Server-Absolutpfade oder Stack-Traces freizulegen.
  • Bestehende .env, storage/, bootstrap/cache/, Uploads und Laufzeitdateien werden beibehalten.
  • Die Schritte Anwenden und Nachbereiten müssen als konfigurierter Site Runtime/Deploy-Benutzer ausgeführt werden, der den Zielbaum schreiben kann. Standard Herne-verwaltete Websites verwenden das www-data Runtime Ownership/Group-Modell.
  • Permission Preflight überprüft die Zielwurzel, Artefakt-Ziele anwenden, Laravel-Laufzeitverzeichnisse bootstrap/cache und Composer vendor Ziel vor der Anwendung. Unsichere Berechtigungen brechen ab, bevor Dateien geändert werden.
  • Optionale Schritte nach dem Bereitstellen können composer install --no-dev --prefer-dist --optimize-autoloader, php artisan migrate --force ausführen und optimieren/cache-frei.
  • Wenn .env fehlt, werden die handwerklichen Schritte nach der Bereitstellung übersprungen und das Bereitstellungsprotokoll erklärt den nächsten Schritt.

Publisher Deploy ist für jedes unterstützte Publisher-Produkt wiederverwendbar, einschließlich WebBlocks Workbench, CMS, Plugins, QuizTem oder zukünftige Produkte. Spätere Updates können über Publisher Deploy oder über den produkteigenen Systemaktualisierungsbildschirm vorgenommen werden, wenn eines verfügbar ist.

Anwendungen schnell installieren

Deploy ist immer noch das richtige Tool für Git-basierte Anwendungen. Für unterstützte Apps kann Websites → Apps → Schnellinstallation eine App ohne einen Repository-Bereitstellungsschritt erstellen. WebBlocks CMS bereitet die CMS-App vor und generiert Datenbankanmeldeinformationen. Laravel App erstellt nur ein sauberes neuestes Laravel-Skelett, markiert die Laufzeit der Website als Laravel und lässt Paketprodukte wie QuizTem anschließend über Composer oder Terminal installieren. Quick Install akzeptiert ein leeres web_root- oder ein leeres public/-Verzeichnis, lehnt jedoch beliebige vorhandene Dateien ab und löscht sie nicht automatisch.

Deployment-Webhook pro Website

Jede Website mit einer gespeicherten Bereitstellungskonfiguration erhält auch eine eigene Webhook-Karte auf der Git Deploy-Seite.

  • URL — POST /sites/{site}/webhook/deploy
  • Geheimer Schlüssel — wird automatisch generiert und im Bedienfeld angezeigt
  • Signature Header — Senden Sie X-Hub-Signature-256 mit der HMAC-SHA-256-Signatur der unveränderten JSON-Nutzlast
  • Zweigfilter — Pushes an andere Zweige werden automatisch ignoriert

GitHub einrichten

  1. Öffnen Sie Ihre Repository-Webhook-Einstellungen auf GitHub
  2. Legen Sie die Payload-URL auf den Wert fest, der auf der Git-Bereitstellungsseite der Site angezeigt wird.
  3. Verwenden Sie application/json als Inhaltstyp
  4. Fügen Sie das aus Herne generierte Secret in das Webhook Secret Feld ein
  5. Wählen Sie nur das Push-Ereignis aus

Dieser Webhook ist nur für die Bereitstellung von Mandantenanwendungen gedacht. Die Aktualisierung von Herne selbst ist ein separater Admin-Flow - siehe den Aktualisierungen des Panels Bildschirm, der WebBlocks Publisher-Versionen anstelle eines Webhooks anwendet.