Migration de domaine canonique

Promouvoir un domaine de site temporaire vers le domaine primaire réel avec des sauvegardes, des mouvements de fichiers, alias nettoyage, et la vérification Nginx/SSL.

Objet

La migration canonique du domaine favorise un nouveau nom d'hôte vers le domaine principal du site. Il est destiné aux cas où un domaine temporaire devient le domaine de production réel et le chemin actif du site devrait aussi se déplacer.

C'est différent d'un pseudonyme. Un alias ajoute un autre nom d'hôte au même site, tandis que la migration canonique met à jour le domaine du site, le slug, le chemin racine du document, les métadonnées de l'application, la configuration Nginx et les valeurs d'environnement.

Commande

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

D'abord à sec

Inspectez toujours un parcours sec avant d'appliquer une migration vivante :

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

Appliquer

Une fois le cycle sec correct, utilisez --force pour la migration réelle :

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

Ce que la commande met à jour

  • Retrouve le site existant via oldDomain et refuse l’opération si un autre site utilise déjà newDomain.
  • Fait de newDomain le domaine principal s’il s’agit déjà d’un alias du site initial.
  • Actualise l’identifiant du site à partir du nouveau domaine, par exemple de fklavye.net à fklavye-net.
  • Déplace le chemin actif vers /var/www/{newDomain}/web_root si l’option --move-files est utilisée.
  • Conserve www.{newDomain} comme alias si l’option --www-alias est utilisée.
  • Supprime oldDomain des alias du site et de la directive Nginx server_name.
  • Actualise les métadonnées d’installation de l’application et les variables d’environnement courantes telles que APP_URL et APP_NAME.

Sauvegardes et chemins de retraite

La commande exige une sauvegarde avant toute étape destructive. Lors du déplacement des fichiers, l’ancien répertoire actif est mis de côté dans un chemin horodaté, par exemple :

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

Les métadonnées de migration sont écrites de sorte que le domaine précédent, les alias, les chemins et l'état d'installation de l'application peuvent être revus si un travail de retour est nécessaire.

Vérification

  • nginx -t doit passer avant de recharger.
  • La configuration Nginx activée ne doit contenir que le nouveau domaine canonique et les alias attendus.
  • L'ancien domaine ne doit pas rester un domaine de site, alias, ou Nginx server_name.
  • curl -I https://{newDomain} et curl -I https://www.{newDomain} doivent retourner les réponses en direct attendues.
  • Les requêtes http:// doivent être redirectionnées vers HTTPS conformément à la politique du site.