Como usar Ruby on Rails na hospedagem compartilhada GeHost
Olá, viajante do mundo digital! Se você está aqui, é porque quer colocar seu app Ruby on Rails para funcionar no mundo — e com a GeHost, isso é possível, mesmo em hospedagem compartilhada. Sim, mesmo sem servidor dedicado, você pode rodar seu projeto com um toque de sabedoria e paciência. Vamos juntos nessa jornada, passo a passo, como um verdadeiro Sensei da GeHost.
Antes de começar: entenda o que é Ruby on Rails
Ruby on Rails é um framework de desenvolvimento web poderoso, feito para criar aplicações rápidas e elegantes. Ele é popular por ser "bem pensado" — ou seja, com boas práticas embutidas. Na GeHost, mesmo em hospedagem compartilhada, ele pode ser usado com algumas configurações especiais.
Dica do Sensei: Ruby on Rails exige um ambiente com Ruby, Rails, e alguns pacotes extras. Na GeHost, isso é possível porque oferecemos suporte a ambientes personalizados via Shell (SSH) e Gerenciador de Aplicações. Vamos lá!
Passo 1: Acesse o cPanel
Para começar, faça login no seu cPanel. Esse é o portão de entrada para tudo que você precisa no seu espaço na GeHost.
Passo 2: Acesse o Gerenciador de Arquivos
Depois de logado, localize e clique em Gerenciador de Arquivos no grupo "Arquivos".
Passo 3: Crie a estrutura da sua aplicação
No Gerenciador de Arquivos, navegue até a pasta public_html (ou a pasta do seu domínio). Crie uma nova pasta com o nome do seu projeto (ex: meuapp).
- Clique em Novo → Pasta.
- Digite o nome (ex:
meuapp). - Confirme.
Passo 4: Envie seu código Rails
Seu projeto Ruby on Rails precisa estar pronto localmente. Com ele pronto, faça o upload via Gerenciador de Arquivos:
- Selecione a pasta
meuappcriada. - Clique em Upload.
- Arraste e solte todos os arquivos do seu projeto (Gemfile, config/, app/, public/, etc.).
⚠️ Importante: Não envie o diretório tmp/, log/ ou db/ com arquivos de banco de dados. Isso pode causar conflitos.
Passo 5: Instale as dependências com o Bundler (via SSH)
Como a hospedagem compartilhada não tem acesso direto a comandos como gem install, você precisa usar o SSH para instalar as dependências.
- Abra seu terminal (ou Putty, se for Windows).
- Conecte-se ao servidor via SSH com suas credenciais (usuário e senha da GeHost).
- Navegue até a pasta do seu app:
cd public_html/meuapp. - Execute:
bundle install
Isso vai instalar todas as gemas do seu projeto. Se algo der errado, verifique se o Gemfile está correto e se você tem acesso ao gem no servidor.
Passo 6: Configure o servidor de aplicação (Puma)
Rails geralmente usa o servidor Puma em produção. Você precisa configurar um arquivo de configuração:
- Crie um arquivo chamado
Pumafilena raiz do seu projeto (ex:public_html/meuapp/Pumafile). - Coloque o seguinte conteúdo:
workers 2 threads 1, 4 bind 'unix:///tmp/puma.sock' pidfile '/tmp/puma.pid'
Isso define que o Puma usará 2 workers e 1 a 4 threads, e se comunicará via socket.
Passo 7: Crie o arquivo de inicialização (config.ru)
Para o servidor web (Apache) saber como iniciar seu app, você precisa de um arquivo chamado config.ru na raiz do projeto.
Exemplo de conteúdo:
require_relative 'config/environment' run Rails.application
Salve esse arquivo na pasta do seu projeto.
Passo 8: Acesse seu app no navegador
Pronto! Agora, acesse seu site pelo navegador:
- http://seu-domínio.com/meuapp
Se tudo estiver certo, você verá sua aplicação Rails rodando!
Dica do Sensei: Se aparecer um erro 500 ou "Internal Server Error", verifique:
- Se o
config.ruestá no lugar certo.- Se o
Pumafileestá com os caminhos corretos.- Se o
public/tem o arquivoindex.htmlouindex.php— se sim, ele pode estar sobrescrevendo o Rails.
Passo 9: (Opcional) Use o Gerenciador de Aplicações (apenas se disponível)
Alguns planos da GeHost incluem o Gerenciador de Aplicações. Se tiver acesso, ele pode automatizar parte do processo:
- Localize no cPanel: Gerenciador de Aplicações.
- Selecione Ruby on Rails.
- Escolha o domínio e a pasta.
- Configure o caminho do app e o arquivo
config.ru. - Salve.
Se disponível, isso simplifica muito a vida!
Conclusão: Você é um mestre!
Parabéns, viajante! Você acaba de colocar seu primeiro app Ruby on Rails em produção, mesmo em hospedagem compartilhada. Isso exige paciência, atenção e um toque de coragem — e você teve tudo isso.
Se precisar de ajuda, o suporte da GeHost está aqui para te guiar. Basta nos chamar com um “Sensei, preciso de ajuda com meu Rails!” — e nós respondemos com carinho.
Até a próxima aventura no mundo do código!