Como usar Ruby on Rails na hospedagem compartilhada GeHost

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 meuapp criada.
• 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.

1. Abra seu terminal (ou Putty, se for Windows).
2. Conecte-se ao servidor via SSH com suas credenciais (usuário e senha da GeHost).
3. Navegue até a pasta do seu app: cd public_html/meuapp.
4. 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 Pumafile na 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.ru está no lugar certo.
• Se o Pumafile está com os caminhos corretos.
• Se o public/ tem o arquivo index.html ou index.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!