Quick Start

Coloque sua aplicação no ar em menos de 5 minutos.

1. Pré-requisitos

  • Ruby 3.x ou Node.js 18+ instalado na sua máquina
  • Git instalado e configurado
  • Uma conta Brasa (crie grátis aqui)

2. Instalação

Instale a CLI do Brasa via RubyGems:

$ gem install brasa

Verifique a instalação:

$ brasa --version
brasa 0.2.0

3. Login

Autentique-se com sua conta Brasa:

$ brasa login
Email: seu@email.com
Senha: ********
Autenticado com sucesso!

4. Criar seu primeiro app

Navegue até o diretório do seu projeto e inicialize:

$ cd meu-app-rails
$ brasa init
Detectado: Ruby on Rails 8.0
Nome do app: meu-app-rails
Região: br-south-1 (São Paulo)
App criado com sucesso!

Dica: O Brasa detecta automaticamente o stack do seu projeto (Rails, Node.js, etc.) e configura o ambiente adequadamente.

5. Deploy

Execute o deploy com um único comando:

$ brasa up
Empacotando aplicação...
Enviando para Magalu Cloud...
Construindo imagem... OK
Iniciando containers... OK
Deploy concluído!

Sua aplicação está no ar: https://meu-app-rails.usebrasa.com.br

6. Verificar

Confira o status da sua aplicação:

$ brasa status
App: meu-app-rails
Status: running
Instâncias: web.1 (healthy)
URL: https://meu-app-rails.usebrasa.com.br
Último deploy: há 2 minutos

Acompanhe os logs em tempo real:

$ brasa logs --tail
2025-01-15T10:30:00 web.1 | Started GET "/" for 200
2025-01-15T10:30:01 web.1 | Completed 200 OK in 45ms

7. Escalar

Precisa de mais capacidade? Escale suas instâncias:

$ brasa scale web=2
Escalando web para 2 instâncias... OK
web.1: running
web.2: starting...

8. Próximos passos