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 Jataí (entre na lista de espera)

2. Instalação

Instale a CLI do Jataí via RubyGems (requer Ruby >= 3.1):

$ gem install jatai

Verifique a instalação:

$ jatai --version
jatai 0.7.1

3. Login

Autentique-se com sua conta Jataí:

$ jatai 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
$ jatai init
Stack detectado: Rails
Confirmar stack Rails? (Y/n) y
Nome do app: meu-app-rails
Hex: (Use ↑/↓ e Enter)
‣ Hex Base — R$ 29/mês (1 grátis por time)
  Hex Escala 1 — R$ 59/mês
  Hex Escala 2 — R$ 119/mês
Arquivo .jatai.yml criado com sucesso!
Branch: main
Banco: PG Base provisionado automaticamente no `jatai up`.
Execute `jatai up` para criar e fazer deploy do app.

Dica: O Jataí detecta automaticamente o stack do seu projeto (Rails, Node.js, estático ou Docker). Não há pergunta de região — enquanto a plataforma opera em região única, o .jatai.yml recebe br-se1 sozinho — nem de banco: o PostgreSQL vem junto no jatai up.

O Hex é a unidade computacional do Jataí: o degrau de CPU e memória do seu app. O primeiro Hex Base do time não é cobrado — e isso é isenção de cobrança, não teto de criação: você pode criar quantos apps Base quiser, os demais custam R$ 29 cada. Dá para trocar de degrau depois com jatai scale.

5. Deploy

Execute o deploy com um único comando:

$ jatai 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.jataiapp.com.br

6. Verificar

Confira o status da sua aplicação:

$ jatai status
App: meu-app-rails
  Slug:    meu-app-rails
  Stack:   rails
  Status:  active
  Região:  br-se1
  Hex:     Hex Base
  Banco:   PG Base
  URL:     https://meu-app-rails.jataiapp.com.br

Acompanhe os logs em tempo real:

$ jatai 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? Troque de Hex ou adicione réplicas — cada réplica é um Hex inteiro, e o comando mostra o custo antes de aplicar:

$ jatai scale --preset escala_1 --replicas 2
Hex: Hex Escala 1
Réplicas: 2
CPU: 500m  |  RAM: 1Gi
Custo estimado: R$ 118.00/mês
Confirmar escalonamento? (Y/n) y
Escalonamento aplicado com sucesso!

O Hex Base roda com 1 réplica; o Hex Escala 1 vai até 5 e o Hex Escala 2 até 10. O escalonamento é manual — o automático por CPU e memória ainda está por vir.

8. Próximos passos