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
oldDomainet refuse l’opération si un autre site utilise déjànewDomain. - Fait de
newDomainle 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_rootsi l’option--move-filesest utilisée. - Conserve
www.{newDomain}comme alias si l’option--www-aliasest utilisée. - Supprime
oldDomaindes alias du site et de la directive Nginxserver_name. - Actualise les métadonnées d’installation de l’application et les variables d’environnement courantes telles que
APP_URLetAPP_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 -tdoit 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}etcurl -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.