exp:install für Hoster #

Diese Seite ist für Systemadministratoren und Entwickler, die die Bereitstellung eines Hosters auf der Installation über die Konsole aufbauen, exp:install (bin/php/install.php). Sie beantwortet: welche Optionen ein Hoster setzt, wie Geheimnisse übergeben werden, was der Befehl mit Passwörtern tut, wie Sie vor der Installation testen und wie ein Skript weiß, dass es funktioniert hat. Die Referenz ist Kapitel 7.

Inhalt #

1. Was es ist
2. Die Optionen, die ein Hoster setzt
3. Geheimnisse
4. Das Administratorpasswort
5. Zuerst testen: Ausgabe und Probelauf
6. Exit-Status
7. Beispiele je Datenbank

Was es ist #

exp:install ist eine Oberfläche für den Kickstarter. Es verwandelt seine Optionen in eine temporäre kickstart.ini, führt expKickstarter im selben Prozess aus, entfernt die temporäre Datei und legt eine kickstart.ini, die vorher da war, wieder zurück (4.2). Jede Option hat einen Standard, sodass php bin/php/console exp:install --apply allein das Seitenpaket sevenx_multisite auf SQLite mit dem Administrator admin und einem erzeugten Passwort installiert.

Die Optionen, die ein Hoster setzt #

Vollständige Liste mit jeder Prüfung und Meldung: 7.3 Optionen.

Hinweis Wenn extension/exp_adminui in der Installation ist, wird auch ein Siteaccess adminui angelegt, erreichbar über /adminui, was auch immer --access sagt (7.3).

Geheimnisse #

• Datenbankpasswort: Übergeben Sie es in EXP_INSTALL_DB_PASSWORD, nicht mit --db-password. Eine Option ist für jeden Benutzer der Maschine in der Prozessliste (ps) sichtbar, solange die Installation läuft, und bleibt in der Shell-Historie. Die Variable ist für beides nicht sichtbar.
• Administratorpasswort: aus Ihrem Geheimnisspeicher mit --password=, oder lassen Sie den Befehl eines erzeugen und lesen Sie es aus var/log/initial-admin-password (Modus 0600).
• Die gespeicherte Konfiguration in var/log/exp-install-<date>.ini hat maskierte Passwörter.

Das Administratorpasswort #

Aus 7.5: exp:install installiert nie ein Passwort, das leer, kurz oder bekannt ist.

Ein erzeugtes Passwort hat 24 Zeichen aus einer sicheren Zufallsquelle. Es wird einmal in der Zusammenfassung gezeigt und nach var/log/initial-admin-password geschrieben. Übergeben Sie es dem Kunden über einen sicheren Kanal und löschen Sie die Datei.

Zuerst testen: Ausgabe und Probelauf #

Ein Probelauf läuft auch auf einem Verzeichnis, das bereits eine Installation enthält, ohne --force, und endet mit Dry-run completed: database and remote packages verified. Stopped after SiteDetails, nothing written.

Exit-Status #

0, wenn installiert, oder für ein bestandenes --dry-run, --print oder --help; 1 für alles andere, einschließlich des Falls, dass das Verzeichnis bereits eine Installation enthält und weder --force noch --dry-run angegeben wurde. Ein Skript kann sich darauf verlassen:

php bin/php/console exp:install --dry-run --db=pgsql --db-user=<db user> --url=https://www.example.com \
  && php bin/php/console exp:install --apply --db=pgsql --db-user=<db user> --url=https://www.example.com \
  || echo "installation failed, see var/log/setup.log"

Wenn der Lauf scheitert, bleibt der Wartungsmodus an, damit Besucher keine halb installierte Website sehen.

Beispiele je Datenbank #

In der offiziellen Reihenfolge. Führen Sie jedes als Benutzer der Website aus, mit gesetztem EXP_INSTALL_DB_PASSWORD, wo ein Server genutzt wird.

# 1. SQLite 3 (the default): no database server
php bin/php/console exp:install --apply --url=https://www.example.com --email=<contact>

# 2. PostgreSQL
php bin/php/console exp:install --apply --db=pgsql --db-host=<db host> --db-name=<db> --db-user=<db user> \
  --url=https://www.example.com --email=<contact>

# 3. MongoDB (a database user is required)
php bin/php/console exp:install --apply --db=mongodb --db-host=<db host> --db-name=<db> --db-user=<db user> \
  --url=https://www.example.com --email=<contact>

# 4. MariaDB and 6. MySQL (same driver)
php bin/php/console exp:install --apply --db=mysql --db-host=<db host> --db-name=<db> --db-user=<db user> \
  --url=https://www.example.com --email=<contact>

# 5. Oracle (service name becomes host:port/service)
php bin/php/console exp:install --apply --db=oracle --db-host=<db host> --db-name=<service> --db-user=<db user> \
  --url=https://www.example.com --email=<contact>

Hinweise je Engine stehen in 7.9 und auf den Datenbankseiten dieses Bereichs, von SQLite für Hoster bis MySQL für Hoster.

Eine öffentliche Demo bereitstellen. EXP_DEMO_MODE=1 ./console exp:install --apply --password=<the published password> ... installiert das veröffentlichte Administratorpasswort unverändert, auch ein bekanntes oder kurzes (publish, publishing); ohne die Variable wird es durch ein erzeugtes in var/log/initial-admin-password ersetzt, was ein Aufbau einer Demo als Fehler behandeln sollte. Stellen Sie die Website eines Kunden nie mit der Variablen bereit. Rezept: eine öffentliche Demo auf LiteSpeed und Plesk betreiben.

Verwandte Seiten #

• Ein-Klick-Installer
• Bereitstellung automatisieren
• Mit einem Befehl installieren
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.