Ein-Klick-Installer für Exponential #

Diese Seite ist für Hosting-Anbieter, die möchten, dass Kunden mit einem Klick in ihrem Panel oder Bestellformular eine Exponential-Website bekommen. Sie beantwortet: was Exponential für unbeaufsichtigte Installationen bereits bereitstellt, auf welcher Oberfläche Sie aufbauen und was Ihr Klick drumherum tun muss.

Inhalt #

1. Ein Installer, drei Oberflächen
2. Welche Oberfläche für welches Angebot
3. Was der eine Klick tun muss
4. Sicherheitsregeln
5. Was der Kunde erhält

Ein Installer, drei Oberflächen #

Jede Installationsmethode führt dieselbe Folge von Schrittklassen in kernel/setup/steps/ aus, von Welcome bis Final; CreateSites ist der Schritt, der die Datenbank, die Pakete und die Einstellungen schreibt. Die Oberflächen unterscheiden sich nur darin, woher die Antworten kommen (4.1):

Quelle: 4.2.

Welche Oberfläche für welches Angebot #

Was der eine Klick tun muss #

Exponential installiert die Website. Ihr Installer erledigt alles drumherum:

1. Das Konto vorbereiten: ein Systembenutzer, ein Home-Verzeichnis, ein PHP-FPM-Pool oder eine Velocity-Instanz für die Website (Benutzer und Pools pro Kunde).

2. Die Datenbank vorbereiten: nichts für SQLite 3 (der Standard; ein beschreibbares var/storage/sqlite3/ genügt); für eine Server-Engine eine leere Datenbank und einen Benutzer, der Tabellen anlegen darf (Datenbanken und Benutzer in Panels).

3. Den Code an seinen Platz bringen: einen Git-Checkout eines Release-Tags oder composer create-project/composer install aus einer getesteten Lock-Datei (Composer und Git auf Servern).

4. Den Installer als Benutzer der Website ausführen, nie als root:

   sudo -u <site user> env EXP_INSTALL_DB_PASSWORD='<from your secret store>' \
     php bin/php/console exp:install --dry-run --db=pgsql --db-user=<db user> --url=https://www.example.com
   sudo -u <site user> env EXP_INSTALL_DB_PASSWORD='<from your secret store>' \
     php bin/php/console exp:install --apply --db=pgsql --db-user=<db user> --url=https://www.example.com \
     --email=<customer contact>

5. Die Website ausliefern: den Webserver darauf richten oder Velocity starten (Einen Webserver wählen).

6. Die Crontab einrichten für runcronjobs.php (Cronjobs).

7. Das Passwort übergeben: var/log/initial-admin-password einmal lesen, dem Kunden über einen sicheren Kanal geben und die Datei löschen; oder das Passwort mit --password= aus Ihrem Geheimnisspeicher setzen.

8. Die Website registrieren in Backups und Überwachung.

Jeder Schritt ist in Bereitstellung automatisieren beschrieben.

Sicherheitsregeln #

• Richten Sie --db-action=remove nie auf eine Datenbank, die Daten enthält. Es ist der Standard von exp:install und leert die Datenbank zuerst (7.3). Ein Ein-Klick-Installer sollte jedes Mal eine neue, leere Datenbank anlegen.
• Halten Sie Geheimnisse von der Kommandozeile fern. Nutzen Sie EXP_INSTALL_DB_PASSWORD statt --db-password; eine Option ist für jeden Benutzer der Maschine in der Prozessliste (ps) sichtbar, solange die Installation läuft.
• Als Benutzer der Website ausführen. Dateien, die root anlegt, kann der Webserver später nicht ändern.
• Prüfen Sie den Exit-Status. 0 installiert, 1 etwas ist gescheitert; bei einem Fehler bleibt der Wartungsmodus an, und var/log/setup.log sagt, warum (7.7).
• Lassen Sie keine Installationsdateien zurück. Eine kickstart.ini enthält Passwörter im Klartext; entfernen Sie sie nach der Installation, da der Assistent sie bei einem späteren Lauf lesen würde.

Was der Kunde erhält #

• Die Adresse der Website und die Adresse der Administration (über die URL /admin, über den Host oder über den Port, je nach --access).
• Die Anmeldung admin des Administrators und sein Passwort, einmal; den Rat, es zu ändern und persönliche Konten anzulegen (Erste Anmeldung und Standardpasswörter).
• Das Seitenpaket, das Sie gewählt haben, mit oder ohne Demo-Inhalte (Seitenpakete).
• Einen Link zur Hilfe: das Hilfe-Center in seiner Administration.

Verwandte Seiten #

• exp:install
• Der Kickstarter
• Lizenzierung für Hoster (Images und Installer, die Sie weitergeben)
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.