Escrito em 2023. Algumas coisas aqui podem ter mudado.
Há um tempo atrás eu escrevi esse post sobre como criar e publicar uma aplicação Angular no S3. Como ambos os frameworks usam a pasta dist, basta seguir os mesmos passos no React.
Agora, nós vamos usar o GitHub Actions pra automatizar o nosso deploy e atualizar o ambiente automaticamente a cada commit na branch principal.
E se você chegou até aqui mas ainda não entendeu muito bem porque publicar uma SPA no S3 ao invés de um nginx ou apache da vida, a resposta é simples: é tudo HTML, CSS e JS. Uma SPA tem um monte de JS incorporado, regras de interface, libs, etc. mas no fim disso tudo o código é executado no browser, então a gente só precisa de um servidor de arquivos pra fazer a mágica acontecer.
Repo
Dessa vez vamos usar um app react como exemplo, e se você é do team Angular pode usar esse repo como base.
Criando a Action
No seu repositório, vá para a aba actions pra criar o seu primeiro workflow. Digite Node.js na caixa de pesquisa, procure por essa action aqui e clique em Configure.

Importante: GitHub Actions é o nome da ferramenta. Dentro dela, nós configuramos os workflows. Um workflow é um conjunto de instruções pra fazer o que você quiser com o seu projeto: rodar testes, buildar a aplicação, fazer o deploy ou tudo isso junto, se você consegue fazer no terminal é possível fazer via GitHub Actions. Ainda tem uma série de comandos predefinidos pra te ajudar no marketplace.
Após clicar em Configure, o GitHub vai gerar um workflow padrão para uma aplicação node:
# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
name: Node.js CI
on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]
jobs:
build:
runs-on: ubuntu-latest
strategy:
matrix:
node-version: [18.x, 20.x, 22.x]
steps:
- uses: actions/checkout@v7
- name: Use Node.js ${{ matrix.node-version }}
uses: actions/setup-node@v7
with:
node-version: ${{ matrix.node-version }}
cache: 'npm'
- run: npm ci
- run: npm run build --if-present
- run: npm testExplicando o arquivo acima, ele é executado tanto em pushes quanto PRs para a branch main. Roda no ubuntu e executa nas versões 18, 20 e 22 do node. Como a gente não precisa suportar várias versões, eu vou fixar numa só: a 24.x, que é LTS. Essa é a parte de configuração do workflow.
E aqui vai um detalhe importante: pra CI, rodar em PR faz todo sentido, mas esse workflow vai fazer deploy. Se ele continuar rodando em pull_request, qualquer PR aberto pra main publica em produção um código que nem foi revisado ainda. Por isso eu vou deixar só o push na main, que é quando o PR já foi mergeado.
Nas steps, que são as etapas, o actions/checkout baixa o repositório, enquanto o setup-node instala o nodejs. Com o node instalado, rodamos o npm ci pra instalar as dependências, depois o build e os testes. Como a nossa aplicação não tem testes, eu vou remover essa última linha.
A essa altura, o seu arquivo deve estar assim:
name: Deploy React app to S3
on:
push:
branches: [ "main" ]
jobs:
build-and-deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- name: Use Node.js 24.x
uses: actions/setup-node@v7
with:
node-version: 24.x
cache: 'npm'
- run: npm ci
- run: npm run buildAgora que já temos o script de build, é hora de publicar no S3. Eu criei um bucket com o nome de my-react-s3-app usando as configurações do tutorial anterior. Com o bucket pronto, fica faltando configurar as credenciais da AWS e subir os arquivos.
Com isso, o meu arquivo final ficou assim:
name: Deploy React app to S3
on:
push:
branches: [ "main" ]
permissions:
id-token: write # necessário pro OIDC
contents: read
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- name: Use Node.js 24.x
uses: actions/setup-node@v7
with:
node-version: 24.x
cache: 'npm'
- run: npm ci
- run: npm run build
- name: Setup AWS credentials
uses: aws-actions/configure-aws-credentials@v6
with:
role-to-assume: ${{ secrets.AWS_ROLE_ARN }}
aws-region: ${{ secrets.AWS_REGION }}
- name: Deploy to S3
run: aws s3 sync dist/ s3://my-react-s3-appA step Setup AWS credentials faz o workflow assumir uma role da AWS com permissão no S3. Na primeira versão desse post eu usava a access key e a secret de um usuário IAM guardadas nas secrets, mas hoje o recomendado é usar OIDC: o GitHub troca um token temporário por credenciais que expiram sozinhas, e não fica nenhuma chave de longa duração dando sopa pra vazar ou pra você lembrar de rotacionar. É por isso que o workflow precisa da permissão id-token: write. Tanto o ARN da role quanto a region do meu app estão em secrets, assim eu não deixo nenhuma informação sensível no repositório.
Você pode ver como configurar o OIDC e a role na AWS nesse link e você pode encontrar mais informações sobre as secrets aqui. Para criar as secrets basta ir no seu repositório no GitHub > Settings > Secrets and Variables > Actions.
E por último, mas não menos importante, a task Deploy to S3 sobe os arquivos pro nosso bucket. Após fazer o push para o repositório, a aplicação fica disponível automaticamente em alguns segundos. Você pode acessar o meu app nesse link
