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/publicbei. - 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
wwwwä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_rootzu klonen.
Empfohlene Build-Optionen für ein Laravel-Projekt:
composer install: aktiviertnpm 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.enveintragen.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_NAMEAPP_ENV=productionAPP_URL=https://your-domainDB_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:
- Kopieren Sie den öffentlichen Schlüssel aus dem Assistenten.
- Öffnen Sie das Repository auf GitHub.
- Wählen Sie Settings → Deploy keys → Add deploy key.
- 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:generateaus, wennAPP_KEYleer ist. - Führen Sie
php artisan storage:linkaus, 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.