Quick Start

Coloque sua aplicacao no ar em menos de 5 minutos.

1. Pre-requisitos

  • Ruby 3.x ou Node.js 18+ instalado na sua maquina
  • Git instalado e configurado
  • Uma conta Brasa (crie gratis aqui)

2. Instalacao

Instale a CLI do Brasa via RubyGems:

$ gem install brasa

Verifique a instalacao:

$ 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 ate o diretorio do seu projeto e inicialize:

$ cd meu-app-rails
$ brasa init
Detectado: Ruby on Rails 8.0
Nome do app: meu-app-rails
Regiao: br-south-1 (Sao 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 unico comando:

$ brasa up
Empacotando aplicacao...
Enviando para Magalu Cloud...
Construindo imagem... OK
Iniciando containers... OK
Deploy concluido!

Sua aplicacao esta no ar: https://meu-app-rails.usebrasa.com.br

6. Verificar

Confira o status da sua aplicacao:

$ brasa status
App: meu-app-rails
Status: running
Instancias: web.1 (healthy)
URL: https://meu-app-rails.usebrasa.com.br
Ultimo deploy: ha 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 instancias:

$ brasa scale web=2
Escalando web para 2 instancias... OK
web.1: running
web.2: starting...

8. Proximos passos