Documentation

Correction des problèmes de routage du domaine client dans AEM as a Cloud Service

Last update: Sat Sep 13 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Le routage du domaine client dans Adobe Experience Manager as a Cloud Service (AEMaaCS) échoue lorsque les fermes du Dispatcher sont mal configurées, ce qui entraîne l’affectation par défaut des requêtes à la mauvaise ferme. Pour résoudre ce problème, validez la configuration du Dispatcher, mettez à jour les alias d’hôte virtuel, renommez les fichiers de batterie pour corriger la commande, consultez les en-têtes client et vérifiez les paramètres CDN pour un mappage de domaine correct.

Description description

Environnement

Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites, environnement de production utilisant le réseau CDN Akamai avec des certificats de domaine et plusieurs domaines personnalisés.

Problème/Symptômes

  • Les journaux Dispatcher affichent des avertissements tels que : Aucune ferme ne correspond à l’hôte « localhost », la dernière ferme de serveurs « publishfarm » a été sélectionnée.
  • La configuration du Dispatcher semble donner la priorité aux fermes activées dans l’ordre alphabétique inverse.
  • Les liens symboliques des fichiers dans les répertoires enabled_vhosts et enabled_farms sont manquants.
  • Certains alias de serveur requis, tels que localhost, 127.0.0.1 sont absents de la configuration de l’hôte virtuel.

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

  1. Valider la configuration Dispatcher :

    • Utilisez l’outil de validation de Dispatcher localement pour identifier les erreurs ou avertissements dans la configuration actuelle.
    • Assurez-vous que tous les fichiers des répertoires enabled_vhosts et enabled_farms sont des liens symboliques.

  2. Mettre à jour la configuration de l’hôte virtuel : vérifier que les entrées de l’hôte virtuel incluent tous les alias de serveur nécessaires : ServerAlias "*example.com" "*.local" "localhost" "127.0.0.1" "*.adobeaemcloud.net" "*.adobeaemcloud.com"

  3. Renommer les fermes activées : Supprimez les préfixes numériques (par exemple, 00_, 01_) des noms de fichiers de fermes activées, car ils peuvent entraîner des problèmes d’ordre alphabétique inverse lors de la sélection des fermes.

  4. Activer la journalisation du débogage : définissez les journaux du Dispatcher sur le mode de débogage et capturez des extraits de journal liés à la sélection de la batterie ou aux occurrences d’erreur pour une analyse plus approfondie.

  5. Vérifier les règles d’en-tête client : Inspectez les règles d’en-tête client (par exemple, clientheaders.any et default_clientheaders.any) pour les valeurs d’espace réservé codées en dur telles que 'localhost'. Remplacez-les par des mappages appropriés pour les requêtes entrantes.

  6. Tester les modifications localement : déployez la configuration mise à jour sur une instance Dispatcher locale et validez la fonctionnalité avant d’appliquer les modifications à la production.

  7. Déployer la configuration mise à jour : une fois validée, déployez la configuration Dispatcher mise à jour à l’aide de vos outils de pipeline.

  8. Vérification des paramètres du réseau CDN :

    • Assurez-vous que le réseau CDN est correctement configuré pour utiliser les noms de domaine du client.
    • Vérifiez que l’en-tête X-Forwarded-Host est correctement défini et ne contient pas de valeurs d’espace réservé telles que 'localhost'.

  9. Tester à nouveau le routage de domaine : après le déploiement, testez chaque domaine personnalisé pour confirmer que les requêtes sont correctement acheminées vers leurs fermes respectives.

  10. Surveiller les journaux après le déploiement : continuez à surveiller les journaux Dispatcher après le déploiement pour identifier les anomalies ou les problèmes récurrents.

Lectures connexes

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f