​
Criar Distribuição Cloudfront

Navegue atéCloudfrontdentro do console AWS e clique emCreate distribution

Para o domínio de origem, insira[SUBDOMAIN].mintlify.devonde[SUBDOMAIN]é o subdomínio único do projeto. Clique emUse: [SUBDOMAIN].mintlify.dev

ParaCache key and origin requests, selecioneCaching Optimized.

E paraWeb Application Firewall (WAF), habilite as proteções de segurança

As configurações restantes devem ser padrão. Clique emCreate distribution.

​
Adicionar Origem Padrão

Após criar a distribuição, navegue até a abaOrigins.

Queremos encontrar uma URL de staging que espelhe onde está o domínio principal (example.com). Isso é altamente variável dependendo de como sua página inicial está hospedada.

Por exemplo, se sua página inicial está hospedada no Webflow, você pode usar a URL de staging do Webflow. Ela se pareceria com.webflow.io.

Se você usa Vercel, você usa o domínio.vercel.appdisponível para cada projeto.

Se você não tem certeza de como obter uma URL de staging para sua página inicial,contact supporte ficaremos felizes em ajudar

Uma vez que você tenha a URL de staging, a nossa, por exemplo, émintlify-landing-page.vercel.app, crie uma nova Origem e adicione-a como oOrigin domain.

Neste ponto, você deve ter duas Origens - uma com[SUBDOMAIN].mintlify.appe outra com a URL de staging.

​
Definir Comportamentos

Comportamentos no Cloudfront permitem controle sobre a lógica de subpaths. Em alto nível, estamos procurando criar a seguinte lógica.

  • Se um usuário chegar em /docs, vá para[SUBDOMAIN].mintlify.dev
  • Se um usuário chegar em qualquer outra página, vá para a página inicial atual

Vamos criar três comportamentos clicando no botãoCreate behavior.

​
/docs/*

O primeiro comportamento deve ter um Padrão de caminho de /docs/* com Origem e grupos de origem apontando para a .mintlify.dev URL (no nosso caso acme.mintlify.dev)

Para Política de cache, selecione CachingOptimized e crie o comportamento.

​
/docs

O segundo comportamento deve ser o mesmo que o primeiro, mas com um Padrão de caminho de /docs e Origem e grupos de origem apontando para a mesma .mintlify.dev URL.

​
Default (*)

Por último, vamos editar o comportamento Default (*).

Vamos alterar a Origem e grupos de origem do comportamento padrão para a URL de staging (no nosso caso mintlify-landing-page.vercel.app).

Clique em Save changes.

​
Visualizar Distribuição

Agora você pode testar se sua distribuição está configurada corretamente indo para a aba General e visitando a URL do Nome de domínio da distribuição.

Todas as páginas devem estar direcionando para sua página principal, mas se você adicionar /docs à URL, você deve ver que está indo para a instância de documentação do Mintlify.

​
Conectando com o Route53

Agora, vamos trazer a funcionalidade da distribuição Cloudfront para o seu domínio principal.

Para esta seção, você também pode consultar o guia oficial da AWS sobre Configurando o Amazon Route 53 para rotear o tráfego para uma distribuição CloudFront

Navegue até Route53 dentro do console AWS e clique no Hosted zone para o seu domínio principal. Clique em Create record

Alternar Alias e depois Rotear tráfego para a opção Alias to CloudFront distribution.

Clique em Create records.

Pode ser necessário remover o registro A existente, se houver um atualmente.

E pronto! Você deve ser capaz de ter sua documentação servida em /docs para o seu domínio principal.