Website-Einrichtungsassistent

Der Assistent führt Sie in vier Schritten durch Git-Anbindung, .env-Konfiguration, Datenbankanlage und das erste Deployment.

Für unterstützte Anwendungen ist Websites → Apps → Schnellinstallation der schnellere Weg. Verwenden Sie den Assistenten, wenn Sie Ihr eigenes Repository anbinden und Deployment, Umgebung, Datenbank und Erstdeployment selbst steuern möchten.

Beispiel einer Laravel-Website

Wenn Sie eine neue Website erstellen und ein Laravel-Repository wie git@github.com:example/example.com.git deployen möchten, ist der Einrichtungsassistent der schnellste Weg.

Vor dem Start

  • Erstellen Sie die Site zuerst aus Websites → Neue Website.
  • Für Laravel behalten Sie den ursprünglichen Dokumentstamm als web_root/public bei.
  • Wählen Sie die richtige Domain und PHP-Version aus, bevor Sie den Assistenten öffnen.
  • Wenn es sich bei der Domain um eine Apex-Domain handelt, können Sie optional den Alias www während der Websiteerstellung aktivieren.

Schritt 1 — Deployment

Füllen Sie das Repository und stellen Sie die Einstellungen bereit:

  • Repository-URL: git@github.com:example/example.com.git
  • Branch: gewöhnlich main, sofern das Repository keinen anderen Branch verwendet
  • Deployment-Pfad: Lassen Sie den Suffix leer, um das Projekt direkt in web_root zu klonen.

Empfohlene Build-Optionen für ein Laravel-Projekt:

  • composer install: aktiviert
  • npm build: nur aktivieren, wenn das Projekt einen Frontend-Build mit Node benötigt. Herne Panel selbst benötigt kein npm.
  • php artisan migrate: aktivieren, wenn Sie in Schritt 3 die Datenbank anlegen und dieselben Zugangsdaten in .env eintragen.
  • optimize / cache clear: aktiviert

SSH-Repository-URLs lösen nach Möglichkeit automatisch die Generierung von Deployment-Schlüssel aus. Sie können den Schlüssel auch später auf der Bereitstellungsseite generieren.

Schritt 2 – .env

Fügen oder Bearbeiten der Produktionswerte .env für die Anwendung ein. Überprüfen Sie mindestens diese Einträge:

  • APP_NAME
  • APP_ENV=production
  • APP_URL=https://your-domain
  • DB_DATABASE, DB_USERNAME, DB_PASSWORD
  • Mail-, Warteschlangen-, Cache- und alle von der App erforderlichen API-Einstellungen von Drittanbietern

Wenn die App Redis für Cache, Sessions oder Warteschlangen verwendet, verwenden Sie vor dem Speichern die integrierte Aktion Redis-Standards anwenden.

Bei einer neuen Website wurde das Repository noch nicht geklont. .env.example ist daher im Assistenten möglicherweise noch nicht verfügbar. Halten Sie die Werte zum manuellen Einfügen bereit.

Schritt 3 – Datenbank

Erstellen Sie eine MySQL-Datenbank, wenn die Laravel-Anwendung eine benötigt.

  • Geben Sie den Datenbanknamen ein.
  • Geben Sie den Datenbankbenutzer ein.
  • Legen Sie ein starkes Passwort fest.
  • Übernehmen Sie dieselben Werte in .env.

Wenn das Projekt keine Datenbank nutzt, können Sie diesen Schritt überspringen.

Wenn die Datenbank bereits auf dem Server vorhanden ist, können Sie den Assistenten zuerst beenden und später Websites → Datenbanken → Vorhandene Datenbank verknüpfen verwenden, um ihn mit der Website zu verknüpfen.

Schritt 4 — Erstes Deployment

Wenn das Repository privat ist und der Assistent einen öffentlichen Bereitstellungsschlüssel anzeigt:

  1. Kopieren Sie den öffentlichen Schlüssel aus dem Assistenten.
  2. Öffnen Sie das Repository auf GitHub.
  3. Wählen Sie Settings → Deploy keys → Add deploy key.
  4. Fügen Sie den Schlüssel ein. Lassen Sie ihn schreibgeschützt, sofern Sie keinen Schreibzugriff benötigen.

Klicken Sie danach auf Jetzt bereitstellen, um das Repository zu klonen und die ausgewählten Schritte auszuführen.

Nach dem ersten Deployment

Laravel-Projekte benötigen oft einige Nachprüfungen nach dem ersten Einsatz:

  • Führen Sie php artisan key:generate aus, wenn APP_KEY leer ist.
  • Führen Sie php artisan storage:link aus, wenn das Projekt den öffentlichen Storage-Symlink erwartet.
  • Prüfen Sie bei Deployment-Fehlern Websites → Protokolle.
  • Prüfen Sie Websites → Protokolle → Serverprotokolle, wenn nach dem Deployment Nginx- oder PHP-FPM-Fehler auftreten.
  • Prüfen Sie bei Konfigurationsproblemen beim Start Websites → Umgebung und Websites → Artisan.

Alternative: Schnellinstallation

Verwenden Sie Websites → Apps → Schnellinstallation für WebBlocks CMS oder ein sauberes Laravel App-Skelett. WebBlocks CMS erstellt generierte Datenbankanmeldeinformationen und CMS-Setup; Laravel App installiert nur das Laravel-Skelett, so dass Pakete wie QuizTem nachträglich über Composer oder Terminal installiert werden können. Beide Flüsse schreiben sichere .env Werte, schützen APP_KEY, überprüfen die Schreibbarkeit der Laufzeit und halten fehlgeschlagene Installationen nach einer teilweisen Bereinigung wiederholbar.