Ricardo Mello. Engenheiro full-stack sênior, pirado em performance e AI

← artigos aws · frontend · devops 4 min

O guia definitivo para hospedar uma SPA Angular/React com S3, Route 53 e CloudFront

Atualizado em

Escrito em 2023. Algumas coisas aqui podem ter mudado.

O combo S3 + CloudFront é uma ótima opção para hospedagem de aplicações Angular e React. Como dito antes nesse post, uma SPA é simplesmente um monte de arquivos HTML, CSS e JS que rodam no browser, então qualquer servidor de arquivos cumpre a responsa de hospedar esse tipo de aplicação.

O S3 (Simple Storage Service) é um serviço de armazenamento de objetos que pode ser usado para armazenar e recuperar qualquer quantidade de dados de qualquer lugar na web.

O CloudFront, por sua vez, é uma rede de entrega de conteúdo (CDN) que entrega dados, vídeos, aplicativos e APIs com segurança, baixa latência e alta velocidade de transferência. Ao usar o CloudFront com o S3, você pode melhorar o desempenho e a confiabilidade do seu site ou aplicativo distribuindo seu conteúdo globalmente para reduzir a latência, melhorar o tempo de carregamento das páginas e a quantidade de acessos ao bucket.

Pré-requisitos

Antes de começar, precisamos seguir o passo a passo para a criação do bucket no S3, e caso você queira ter deploys automatizados, configurar o GitHub Actions pra atualizar o bucket automaticamente, Por último, vamos configurar o CloudFront e o Route 53.

Importante: embora uma infinidade de artigos e tutoriais (incluindo o meu anterior) ensine, não é uma boa prática deixar o bucket público em produção. Logo, o CloudFront se torna super necessário, principalmente em ambientes corporativos.

Reconfigurando o bucket

Depois de seguir o passo a passo do tutorial anterior, vamos tornar o bucket privado novamente. Vá na aba permissions do seu bucket, remova a policy do tutorial anterior e marque a opção Block all public access. O resultado deve ser esse:

Bucket privado e com policy removida

Criando a distribuição

Vá para o painel do CloudFront na AWS e clique em Create Distribution. Na criação de distribuição, iremos preencher alguns campos:

  • Origin domain: selecione o bucket com a sua aplicação
  • Origin access: selecione a opção Origin access control settings (recommended), que irá deixar o bucket acessível somente para o CloudFront.
  • Ainda em Origin Access: clique em Create Control Setting, e em seguida em create.
  • Default root object: preencha index.html
  • Clique em Create Distribution.

Após a criação você verá um aviso dizendo que a policy do bucket precisa ser atualizada. O processo é bem simples: clique em Copy Policy no próprio aviso, que irá deixar a policy na sua área de transferência, depois em Go to S3 bucket, e cole o conteúdo em Bucket Policy.

Aviso de que a Bucket Policy precisa ser alterada

Voltando à sua distribuição do CloudFront, você verá o link onde ela foi publicada. A essa altura o seu app já estará rodando nesse link mesmo com bucket privado.

Minha distribuição do CloudFront

Configuração do domínio

Também é possível configurar um domínio personalizado no Route 53. Caso você ainda não tenha uma zona configurada, você tem duas opções:

Com a hosted zone criada, basta navegar até ela e clicar em Create Record para criar um novo registro, e setar como Alias to CloudFront Distribution e apontar para a URL da sua distribuição como no print abaixo:

Exemplo de criação de domínio personalizado no Route 53

Depois, precisamos voltar no painel do CloudFront > sua distribution > settings e:

  • Adicione o seu domínio como alternate domain name
  • Crie um certificado
    • Atenção: pro CloudFront, o certificado do ACM tem que ser criado na região us-east-1 (N. Virginia), não importa onde estejam o bucket e o resto da sua infra. Se você criar em outra região, ele simplesmente não aparece na lista. Confere a região no canto superior do console antes de pedir
    • Clique em Request certificate
    • Selecione Request a public certificate na janela que vai abrir
    • Insira o seu domínio em Fully qualified domain name
    • Clique em Request
    • Na lista de certificados, clique no certificado recém-criado
    • Em Domains, vá em Create records in Route 53 e confirme a operação
    • Aguarde o certificado ficar com o status Issued (pode levar alguns minutos)
  • Selecione o certificado que você acabou de criar

Configuração do CloudFront com o domínio novo

O pulo do gato

Tanto o Angular quanto o React possuem o conceito de rota, o que significa que elas são tratadas no frontend. Se o usuário der um F5 ou tentar abrir uma rota diferente do seu app, o CloudFront vai tentar buscar essa rota no S3 e retornar um erro porque ele não vai encontrar nenhum objeto na rota solicitada.

A solução é redirecionar as requests para o index.html. Para isso, vá em Error Pages > Create Custom Error Response e crie a configuração abaixo:

Custom Error Response configurada como http error = 403, customize error = yes, response page path = /index.html, http response code = 200: OK

Essa config redireciona todos os erros 403 para o index.html e retorna Http 200 (OK) para o browser. Assim, independente da rota que o usuário acessar, o CloudFront vai retornar o frontend e o próprio frontend é quem vai gerenciar se aquela rota existe ou não, além de realizar os redirecionamentos caso necessário, que é o comportamento correto.

GG

Agora temos a aplicação publicada, com o bucket seguro e em uma rede de alta disponibilidade que vai acelerar o carregamento independente da localização do usuário.

Print da página publicada