Hauptdomain-Migration

Machen Sie eine temporäre Website-Domain mit Backups, Dateiumzug, Alias-Cleanup und Nginx/SSL-Prüfung zur primären Domain.

Zweck

Canonical Domain Migration fördert einen neuen Hostnamen für die primäre Domain der Site. Es ist für Fälle gedacht, in denen eine temporäre Domain zur realen Produktionsdomäne wird und sich auch der aktive Site-Pfad bewegen sollte.

Dies unterscheidet sich von einem Alias. Ein Alias fügt der gleichen Site einen anderen Hostnamen hinzu, während die kanonische Migration die Site-Domäne, den Slug, den Dokument-Root-Pfad, die App-Metadaten, die Nginx-Konfiguration und die Umgebungswerte aktualisiert.

Befehl

php artisan herne:sites:canonicalize-domain {oldDomain} {newDomain} --www-alias --move-files --backup --force

Zuerst einen Probelauf ausführen

Überprüfen Sie immer einen Testlauf, bevor Sie eine Live-Migration durchführen:

php artisan herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --dry-run

Anwenden

Nachdem der Testlauf korrekt war, verwenden Sie --force für die tatsächliche Migration:

php artisan herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --force

Was der Befehl aktualisiert

  • Findet die bestehende Website über oldDomain und lehnt den Vorgang ab, wenn für newDomain bereits eine separate Website existiert.
  • Macht newDomain zur Hauptdomain, wenn sie bereits ein Alias der alten Website ist.
  • Aktualisiert den Website-Slug anhand der neuen Domain, etwa von fklavye.net zu fklavye-net.
  • Verschiebt bei --move-files den aktiven Pfad nach /var/www/{newDomain}/web_root.
  • Behält www.{newDomain} als Alias bei, wenn --www-alias gesetzt ist.
  • Entfernt oldDomain aus den Website-Aliassen und der Nginx-Direktive server_name.
  • Aktualisiert die Installationsmetadaten der Anwendung und gängige Umgebungswerte wie APP_URL und APP_NAME.

Sicherungen und archiviertes Verzeichnis

Vor destruktiven Schritten verlangt der Befehl eine Sicherung. Beim Verschieben der Dateien wird der zuvor aktive Ordner unter einem Pfad mit Zeitstempel abgelegt:

/var/www/_retired/fklavye.webblocksui.com_YYYYMMDD_HHMMSS

Migrationsmetadaten werden so geschrieben, dass die vorherige Domäne, Aliase, Pfade und der Status der App-Installation überprüft werden können, wenn Rollback-Arbeit erforderlich ist.

Überprüfung

  • nginx -t muss vor dem Nachladen passieren.
  • Die aktivierte Nginx-Konfiguration sollte nur die neue kanonische Domäne und erwartete Aliase enthalten.
  • Die alte Domain darf nicht als Site-Domain, Alias oder Nginx server_name verbleiben.
  • curl -I https://{newDomain} und curl -I https://www.{newDomain} sollten die erwarteten Live-Antworten zurückgeben.
  • http://-Anforderungen sollten gemäß der Site-Richtlinie auf HTTPS umgeleitet werden.