Skip to main content
Build the future with Agentforce at TDX in San Francisco or on Salesforce+ on March 5–6. Register now.

Configurar aliases do nome de host

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:
  • Descrever a estrutura de arquivos e a sintaxe de alias de nomes de host.
  • Listar três etapas a serem cumpridas para configurar e registrar os nomes do DNS e do domínio.
  • Explicar por que você deve configurar um alias de host para o nome de host da instância atual.

URLs significativas

Um alias de nome de host é uma maneira de definir nomes alternativos para a URL existente de um site. Brandon Wilson, anunciante da Cloud Kicks, usa o Business Manager para criar esses alias — URLs curtas e significativas para os mecanismos de pesquisa externos indexarem. Ele também cria arquivos de alias para que, quando um comprador digitar uma URL em seu navegador, o Salesforce B2C Commerce possa enviá-lo para sites localizados ou de conteúdo específico.

Os arquivos de alias dizem ao B2C Commerce como processar redirecionamentos de URL, se eles são estáticos ou dinâmicos e se eles usam estruturas de URL padronizadas para direcionar os compradores de URLs antigas (legadas) para novas. Tanto mapeamentos estáticos quanto dinâmicos fazem um redirecionamento 301 (um redirecionamento permanente de uma URL para outra).

Mapeamentos estáticos lidam com URLs individuais, enquanto mapeamentos dinâmicos são para o manuseio de um conjunto de URLs que correspondem a um padrão específico. Por exemplo, você pode usar um mapeamento estático para uma única página de formulário Entre em contato conosco e um mapeamento dinâmico para um conjunto de páginas de produtos. Para configurar o mapeamento dinâmico, você precisa de um identificador, como a ID do produto na URL legada das páginas do produto. (Caso contrário, você precisa criar mapeamentos estáticos individuais para cada página de produto individual.)

Brandon começa configurando um alias de nome de host para o nome de host atual no qual a loja virtual é executada. Ele configura o endereço www.cloudkicks.com na lista de alias, por exemplo, para que os compradores possam acessar sua loja virtual sem digitar toda a URL.

http://www.cloudkicks.com/on/demandware.store/Sites-MY-Site/default/Home-Show

Se ele não configurar a URL básica da loja virtual, ele está na verdade restringindo o número de compradores que chegam em seu site. Os compradores terão que inserir toda a URL da página de boas-vindas ou de destino, ou obterão o temido erro 404 (página não encontrada). Os mecanismos de pesquisa só veem essa URL longa se alguém publicar um link que a contenha.

O mapeamento da SEO pode ser https://www.cloudkicks.com/homepage.

Com alias de nomes de host, uma URL longa e complicada converte-se em uma URL simples e fácil de pesquisar.

DNS (Domain Name Service, Serviço de nome de domínio) e nomes de domínio

Os detalhes da conexão importam. Brandon pede a Vijay Lahiri, o desenvolvedor, para ajudá-lo a fazer as conexões certas. Vijay também ajuda Brandon a criar seu arquivo de alias de nome de host.

Vijay Lahiri, desenvolvedor da Cloud Kicks

Vijay configura e registra o DNS e os nomes de domínio envolvidos para que ele possa usá-los em aliases.

Veja as etapas que ele segue.

  1. Comprar um domínio.
  2. Configurar o DNS para esse domínio e definir um nome de host.
  3. Obter de uma autoridade de certificação um certificado TLS (Transport Layer Security, Segurança de camada de transporte) contendo o nome (ou vários nomes).
  4. Adicionar o nome do host ao seu arquivo de alias de nome de host como parte de uma regra.
  5. Incluir os parâmetros de configuração do alias de nome do host.
Dica

Dica

Se seu host estiver listado no Business Manager (site > Ferramentas do comerciante > SEO > Aliases), e o site tiver apenas uma localidade, crie links fáceis de pesquisar para a página inicial. Não são necessárias mais informações para determinar a localidade.

O DNS e os nomes de domínio são exigentes. Cada certificado que Vijay instala requer um endereço IP exclusivo. O primeiro certificado compartilha o endereço IP com o nome de host do B2C Commerce. Por exemplo, se o nome de host do B2C Commerce for production.realm.web.cloudkicks.net e o endereço IP for 100.100.100.1, o primeiro certificado que ele instala recebe o endereço IP 100.100.100.1. Se ele instalar um segundo certificado, receberá 100.100.100.2 como seu endereço IP.

Certifique-se de que seu DNS esteja atualizado com os endereços IP do nome de host correspondentes.

Rede de entrega de conteúdo incorporado (CDN)

Se você usar o recurso de CDN incorporado, não configure um endereço IP fixo para seu servidor DNS. Em vez disso, quando você indicar o registro DNS do nome de host para o CDN incorporado no Business Manager, crie um registro de nome canônico (CNAME). Os registros CNAME são usados para relacionar o alias de um nome com outro.

O que tem dentro de um arquivo do alias de nome de host?

O arquivo de alias do nome de host contém os nomes de host/domínios compatíveis com uma loja virtual do B2C Commerce. Ele também contém os pipelines acionados (executados automaticamente) para URLs específicas. Este arquivo é necessário para um lançamento de instância de produção. Uma instância de produção pode ter vários endereços IP que fornecem conteúdo de loja virtual diferente para vários domínios por site ou vários sites por território.

Os arquivos de alias usam o formato de notação de objeto JavaScript ( JSON). Vijay certifica-se de que o arquivo de alias de Brandon inclua o host https adequado, que reflete o nome do host. Por exemplo, Vijay mapeia www.cloudkicks.com assim.

{ "__version": "1",
 "settings": {
     "http-host": "www.cloudkicks.com",
     "https-host": "www.cloudkicks.com"
     }
}

Instância específica

Uma instância do B2C Commerce é uma infraestrutura de aplicativos que inclui servidores Web, de aplicativos e de banco de dados. Comerciantes como o Cloud Kicks normalmente recebem instâncias de preparação, produção e desenvolvimento no grupo de instâncias primárias (PIG), juntamente com sandboxes para desenvolvimento de código no grupo de instância secundária (SIG).

Cada instância tem seu próprio arquivo de alias, de modo que esses arquivos não estão incluídos na replicação de dados. Isso garante que uma replicação de dados contendo dados de gerenciamento de URL do site não substitua a produção com as configurações da preparação.

Dica

Dica

Se você configurar nomes de host no arquivo de aliases, não defina a configuração HTTP/HTTPS obsoleta no Business Manager (Administração > Sites > site > Configurações). Esta configuração é replicada e pode substituir o nome do host de produção, causando resultados inesperados.

Vijay edita o arquivo de alias em cada instância para torná-los todos iguais.

Para seus hosts do cloudkicks.net, ele usa a URL "-" no alias, assim.

{ "__version": "1",
 "settings": {
     "http-host": "development-realm-cloudkicks.demandware.net",
     "https-host": "development-realm-cloudkicks.demandware.net"
     }
} 

A instância de produção

O nome de host da instância de produção é exclusivo na medida em que é semelhante ao production-realm-cloudkicks.demandware.net, com um endereço IP como 100.100.100.1. Este nome de host é um nome de domínio totalmente qualificado (FQDN). Ele tem um recurso de caminhos de site com comportamento /s/siteID/ que permite que esse nome de host navegue em cada site da loja virtual sem configurações de alias, como por exemplo: >production-realm-cloudkicks.demandware.net/s/CKSite/mens.

Vijay usa esse nome de host para acessar o Business Manager e conectar-se ao Visual Studio Code, WebDav e outras conexões de desenvolvimento. Embora ele possa usar este nome de host para ver a loja virtual, seus compradores não devem usá-lo, porque não é a melhor prática para SEO e não promove a publicidade da marca.

Veja aqui um exemplo de um arquivo de alias em uma instância de produção.

{
    "__version": "1",
    "www.cloudkicks.com" : [{"pipeline": "Home-Show" }],
    "production-realm-cloudkicks.demandware.net" : [{"pipeline": "Home-Show" }],
    "cloudkicks.com": [{"host": "www.cloudkicks.com", "path":"/"}]
} 

Cada arquivo de alias de produção tem que incluir o endereço production.cloudkicks.demandware.net para a instância de produção e o endereço do nome de host DNS. O endereço production.cloudkicks também pode incluir o território ou o nome do parceiro que está implementando o site.

Formato de arquivo do alias

É assim que um arquivo de alias se parece.

{"__version": "1",
"settings": {
    "http-host": "httphostname",
    "https-host": "httpshostname",
    "job-hostnames":
    {
       "default":"www.my-default-host.com",
       "de":"www.my-de-host.com",
       "en":"www.my-en-host.com"
        },
    "site-path": "sitepath",
    "default" : "defaultValue",
    "site-path-trailing-slash" : "yes", }
"hostName1": [
    { mappingRule1 },
    { mappingRuleN }
],
"hostNameN": [
    { mappingRule1 },
    { mappingRuleN }
]
}

Vijay e Brandon agora estão prontos para verificar os parâmetros de versão, de configurações e de hostName.

Versão

O parâmetro de versão é obrigatório e tem que ser 1. Ele indica a versão da sintaxe do arquivo, não a versão do arquivo. Se você alterá-lo para outro número, o B2C Commerce ignora todas as entradas.

Configurações

Vijay e Brandon decidem usar as configurações de nomes de hosts de trabalho apenas dentro do contexto de trabalho do B2C Commerce. Dessa forma, um trabalho em execução na instância de preparação pode gerar URLs com os nomes de host usados na instância de produção. O mapeamento pode ser específico do local e seguir uma contingência de localidade país/idioma/padrão. Eles podem usar o nome de host na seção de configurações ou na seção de regras, mas não em ambos. Brandon decide usá-lo na seção de regras, para que ele possa mapear várias localidades a um nível granular.

hostName

O parâmetro de hostName é o nome de host da URL nomeada. Brandon configura vários nomes de host, permitindo que o site manuseie solicitações para todos eles.

Configurar aliases do nome de host

Brandon quer direcionar o tráfego do antigo site legado para o novo site desse jeito.

De Para
eu.cloudkicks.com/fr/ cloudkicks.com/ck_fr/

Neste módulo, pressupomos que você é um anunciante de B2C Commerce com as devidas autorizações para executar essas tarefas. Se você não for um anunciante de B2C, tudo bem. Continue lendo para saber como seu anunciante executaria essas etapas em uma instância de sandbox. Não tente seguir nossas etapas em seu Trailhead Playground. O B2C Commerce não está disponível no Trailhead Playground.

Se você tem uma instância de sandbox do B2C Commerce, pode experimentar essas etapas em sua sandbox. Se você não tem uma sandbox, pergunte ao seu gerente se existe alguma que possa usar.

Veja como configurar aliases do nome de host.

  1. Abra o Business Manager.
  2. Selecione o site > Ferramentas do comerciante > SEO > URLs do site > Aliases. Página de configuração de aliases do Business Manager.
  3. Na página Aliases, especifique os nomes de domínio cloudkicks.com e eu.cloudkicks.com.
    {
        "__version": "1",
        "cloudkicks.com": [{
            "locale": "fr_FR",
            "if-site-path": "ck-fr"
           }
        ],
        "eu.cloudkicks.com": [{
            "locale": "fr_FR",
            "if-site-path": "fr"
           },
           {
            "host": "cloudkicks.com"
           }
        ]
    }
  4. Teste se suas regras são um JSON válido em uma ferramenta de depuração como o validador JSONlint.
  5. Quando tiver certeza que suas regras são válidas, copie o texto para o editor e clique em Aplicar.

Agora, quando um comprador navega para eu.cloudkicks.com/fr/, o B2C Commerce o encaminha automaticamente para cloudkicks.com/ck-fr/.

Próximas etapas

Nesta unidade, você aprendeu o que um arquivo de alias contém e como configurar um. Na próxima unidade, você aprenderá por que pontos de entrada duplicados são um problema e como evitá-los. Você também aprenderá sobre regras de mapeamento de URLs.

Compartilhe seu feedback do Trailhead usando a Ajuda do Salesforce.

Queremos saber sobre sua experiência com o Trailhead. Agora você pode acessar o novo formulário de feedback, a qualquer momento, no site Ajuda do Salesforce.

Saiba mais Continue compartilhando feedback