Migrazione del dominio canonico

Promuovere un dominio temporaneo del sito al dominio primario reale con backup, mosse di file, pulizia alias e verifica Nginx/SSL.

Oggetto

La migrazione di dominio canonico promuove un nuovo hostname al dominio primario del sito. Si intende per casi in cui un dominio temporaneo diventa il vero dominio di produzione e il percorso del sito attivo dovrebbe muoversi troppo.

Questo è diverso da un alias. Un alias aggiunge un altro hostname allo stesso sito, mentre la migrazione canonica aggiorna il dominio del sito, slug, documento root path, app metadata, Nginx config e valori dell'ambiente.

Comando

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

Prima corsa a secco

Ispezionare sempre una corsa a secco prima di applicare una migrazione dal vivo:

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

Applica

Dopo che la corsa a secco è corretta, utilizzare --force per la migrazione reale:

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

Quali sono gli aggiornamenti di comando

  • Individua il sito esistente tramite oldDomain e rifiuta l’operazione se newDomain è in conflitto con un altro sito.
  • Promuove newDomain a dominio principale se è già un alias del sito precedente.
  • Aggiorna lo slug del sito in base al nuovo dominio, ad esempio da fklavye.net a fklavye-net.
  • Sposta il percorso attivo in /var/www/{newDomain}/web_root quando si usa --move-files.
  • Mantiene www.{newDomain} come alias quando si usa --www-alias.
  • Rimuove oldDomain dagli alias del sito e dalla direttiva Nginx server_name.
  • Aggiorna i metadati di installazione e i valori di ambiente comuni come APP_URL e APP_NAME.

Backup e percorso ristretto

Il comando richiede un backup prima delle operazioni distruttive. Quando si spostano i file, la precedente cartella attiva viene archiviata in un percorso con data e ora, ad esempio:

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

I metadati di migrazione sono scritti in modo che il dominio precedente, gli alias, i percorsi e lo stato di installazione dell'app possano essere esaminati se è necessario un lavoro di rollback.

Verifica

  • nginx -t deve passare prima di ricaricare.
  • La configurazione Nginx abilitata dovrebbe contenere solo il nuovo dominio canonico e gli alias attesi.
  • Il vecchio dominio non deve rimanere come dominio del sito, alias, o Nginx server_name.
  • curl -I https://{newDomain} e curl -I https://www.{newDomain} dovrebbero restituire le risposte dal vivo attesi.
  • Le richieste di http:// devono essere reindirizzate a HTTPS secondo la politica del sito.