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

← artigos aws · devops · react · angular 5 min

Deploy de app Angular/React para o S3 via GitHub Actions

Atualizado em

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.

Busca por node.js nos workflows do GitHub Actions, com uma seta apontando pro workflow Node.js

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:

yaml
# 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 test

Explicando 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:

yaml
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 build

Agora 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:

yaml
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-app

A 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

App publicado no S3