Documentação

Correção de problemas de roteamento de domínio do cliente no AEM as a Cloud Service

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

O roteamento de domínio do cliente no Adobe Experience Manager as a Cloud Service (AEMaaCS) falha quando os farms do dispatcher são configurados incorretamente, fazendo com que as solicitações assumam o padrão do farm errado. Para resolver isso, valide a configuração do dispatcher, atualize aliases de host virtual, renomeie arquivos do farm para corrigir a ordenação, revise os cabeçalhos do cliente e verifique as configurações de CDN para obter o mapeamento de domínio correto.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites, ambiente de produção usando o Akamai CDN com certificados de domínio e vários domínios personalizados.

Problema/Sintomas

  • Os logs do Dispatcher exibem avisos como: Nenhum farm corresponde ao host 'localhost', o último farm selecionado 'publishfarm'.
  • A configuração do Dispatcher parece priorizar os farms ativados em ordem alfabética inversa.
  • Os symlinks para arquivos nos diretórios enabled_vhosts e enabled_farms estão ausentes.
  • Certos aliases de servidor necessários, como localhost, 127.0.0.1, estão ausentes da configuração do host virtual.

Resolução resolution

Para resolver esse problema, siga estas etapas:

  1. Validar a configuração do Dispatcher:

    • Use a ferramenta de validação do Dispatcher localmente para identificar erros ou avisos na configuração atual.
    • Verifique se todos os arquivos nos diretórios enabled_vhosts e enabled_farms são symlinks.

  2. Atualizar Configuração de Host Virtual: Confirme se as entradas de host virtual incluem todos os aliases de servidor necessários: ServerAlias "*example.com" "*.local" "localhost" "127.0.0.1" "*.adobeaemcloud.net" "*.adobeaemcloud.com"

  3. Renomear Farms Habilitados: Remova prefixos numéricos (por exemplo, 00_, 01_) dos nomes de arquivo de farm habilitados, pois eles podem causar problemas de ordem alfabética inversa durante a seleção do farm.

  4. Habilitar Log de Depuração: Defina logs do Dispatcher para o modo de depuração e capture trechos de log relacionados à seleção do farm ou a ocorrências de erro para análise adicional.

  5. Revisar Regras de Cabeçalho do Cliente: Inspecionar regras de cabeçalho do cliente (por exemplo, clientheaders.any e default_clientheaders.any) para valores de espaço reservado codificados, como 'localhost'. Substitua-os pelos mapeamentos apropriados para as solicitações recebidas.

  6. Testar Alterações Localmente: Implante a configuração atualizada em uma instância do Dispatcher local e valide a funcionalidade antes de aplicar as alterações à produção.

  7. Implantar Configuração Atualizada: Depois de validada, implante a configuração do Dispatcher atualizada usando suas ferramentas de pipeline.

  8. Verificar Configurações de CDN:

    • Verifique se a CDN está configurada corretamente para usar nomes de domínio do cliente.
    • Valide se o cabeçalho X-Forwarded-Host está definido adequadamente e não contém valores de espaço reservado como 'localhost'.

  9. Testar Novamente o Roteamento de Domínio: Após a implantação, teste cada domínio personalizado para confirmar se as solicitações são roteadas corretamente para seus respectivos farms.

  10. Monitorar logs após a implantação: Continue monitorando os logs do Dispatcher após a implantação para identificar qualquer anomalia ou problema recorrente.

Leituras relacionadas

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