{"id":45439,"date":"2024-08-09T16:11:26","date_gmt":"2024-08-09T19:11:26","guid":{"rendered":"\/tutoriais\/?p=45439"},"modified":"2025-12-18T11:35:51","modified_gmt":"2025-12-18T14:35:51","slug":"como-instalar-ruby-on-rails-no-ubuntu","status":"publish","type":"post","link":"\/br\/tutoriais\/como-instalar-ruby-on-rails-no-ubuntu\/","title":{"rendered":"Como instalar Ruby on Rails no Ubuntu"},"content":{"rendered":"

O Ruby on Rails é um framework incrível que vem com uma série de ferramentas para tornar o desenvolvimento de sites e aplicações muito mais eficiente. Ele oferece vários modelos de código e bibliotecas que permitem adicionar novas funcionalidades sem ter que começar do zero.<\/p>

No entanto, para quem está começando, a instalação do Ruby on Rails pode ser um desafio. É necessário preparar o ambiente de hospedagem e instalar algumas dependências, tudo isso usando diferentes comandos.<\/p>

Neste artigo, vamos mostrar como instalar o Ruby on Rails em um servidor virtual privado (VPS). Além disso, vamos guiar você na criação de uma aplicação Rails e compartilhar algumas dicas valiosas para aproveitar ao máximo esse framework. <\/p>

\"\"<\/a><\/figure>

\n\n\n\n\n\n\n<\/p>

<\/p>

\n\n\n

\n \n \n <\/svg>\n

\n O Que é Ruby on Rails?\n <\/p>\n <\/div>\n

Ruby on Rails é um framework para desenvolvimento web que utiliza a linguagem de programação Ruby. Ele vem com diversos kits de ferramentas, bibliotecas e modelos de código que ajudam a acelerar o desenvolvimento. Baseado na popular arquitetura Model-View-Controller (MVC), o Ruby on Rails é extremamente flexível e serve para uma variedade de aplicações para a internet, desde sites simples até sistemas de gerenciamento de conteúdo (CMS).<\/p><\/div>\n\n\n\n<\/p>

Como Instalar Ruby on Rails no Ubuntu<\/strong><\/h2>

Nesta seção, vamos te guiar no processo de instalação do Ruby on Rails em um servidor privado virtual com Ubuntu 22.04<\/strong>. Antes de mais nada, verifique se você já tem um plano de hospedagem VPS<\/strong><\/a> rodando esse sistema operacional.<\/p>

1. Prepare o Seu Servidor Ubuntu<\/strong><\/h3>

Para preparar o ambiente Rails, comece se conectando ao seu VPS com um cliente SSH, como o PuTTY<\/strong><\/a> ou o Terminal. Se você é cliente da Hostinger, pode usar o terminal do navegador para acessar seu servidor e executar comandos Linux<\/strong><\/a> remotamente.<\/p>

Para facilitar a configuração, mantenha seu sistema limpo, livre de bloatware e arquivos desnecessários. Softwares desnecessários no seu servidor podem diminuir o desempenho e causar conflitos, afetando a funcionalidade.<\/p>

Os usuários da hospedagem VPS da Hostinger têm a liberdade de escolher quais softwares instalar, além de terem a opção de um sistema operacional mais enxuto, podendo criar um ambiente de hospedagem simples e fácil de configurar.<\/p>

\"\"<\/a><\/figure>

Você pode encontrar o endereço IP do servidor e as credenciais de login SSH acessando o Painel de Controle<\/strong> do VPS<\/strong> da Hostinger → Gerenciar <\/strong>→ Acesso SSH<\/strong>. Em vez de root, recomendamos usar outras contas de superusuário para evitar modificações acidentais que possam prejudicar o sistema.<\/p>

\n
\"Localização<\/figure>\n<\/div>

Depois de se conectar, atualize o repositório do Ubuntu para garantir que você esteja instalando a versão mais recente do pacote. Use o seguinte comando:<\/p>

sudo apt update && sudo apt upgrade<\/pre>
2. Instale Ruby no Ubuntu<\/strong><\/h3>
Para rodar o Ruby on Rails, você precisa de linguagem de programação Ruby, um compilador de código e de um runtime de JavaScript. Dependendo da sua aplicação, pode ser necessário instalar pacotes adicionais, como Redis<\/strong><\/a> ou Readline.<\/p>
Neste tutorial, vamos mostrar como instalar tudo o que você precisa usando o APT.<\/p>
Para instalar o Ruby, execute o seguinte comando:<\/p>
sudo apt install ruby-full -y<\/pre>
Agora, verifique se o Ruby foi instalado corretamente usando:<\/p>
sudo ruby -v<\/pre>
\n
\"Terminal<\/figure>\n<\/div>
Se o terminal retornar um erro “Command not found<\/strong>“, isso significa que o Ruby não foi instalado corretamente. Caso o terminal mostre o número da versão do Ruby, você pode continuar e instalar outros pacotes essenciais.<\/p>
Com base nas suas necessidades, você pode escolher quais softwares instalar. No nosso tutorial, vamos instalar o pacote build-essential<\/strong>, o controle de versão Git<\/strong>, o banco de dados PostgreSQL<\/strong>, a biblioteca SSL e a compressão zlib<\/strong>:<\/p>
sudo apt install -y build-essential git-core libssl-dev zlib1g-dev postgresql postgresql-server-dev-all<\/pre>
\n\n\n        
\n            
\n                \n                    \n                <\/svg>\n                
\n                    Sugestão de Leitura                <\/p>\n            <\/div>\n            
Dê uma olhada no nosso guia sobre como instalar o PostgreSQL no Ubuntu<\/a> e descubra como configurar um banco de dados padrão e um usuário Postgres.<\/p>\n                    <\/div>\n        \n\n\n\n<\/p>
Verifique se esses pacotes estão instalados corretamente conferindo suas versões. Para o build-essential<\/strong>, use o comando grep<\/strong>:<\/p>
apt list --installed | grep build-essential<\/pre>
\n
\"O<\/figure>\n<\/div>
Em seguida, execute o comando abaixo para instalar o runtime de JavaScript Node.js<\/strong> e o gerenciador de pacotes Yarn<\/strong>, que são necessários para habilitar o pipeline de ativos:<\/p>
sudo apt install -y nodejs yarn<\/pre>
Recomendamos usar a versão mais recente para garantir a melhor compatibilidade, segurança e funcionalidade. Se tiver dúvidas, consulte as páginas de notas do desenvolvedor.<\/p>
3. Instale Rails no Ubuntu<\/strong><\/h3>
\n\n\n        
\n            
\n                \n                    \n                <\/svg>\n                
\n                    Dica de especialista                <\/p>\n            <\/div>\n            
Os planos de hospedagem VPS Rails da Hostinger<\/a> permitem que você instale o Ubuntu 22.04 64bit com Rails\/OpenLiteSpeed em apenas um clique. Cada pacote vem com um terminal no navegador e um Assistente de IA para te ajudar.<\/p>\n                    <\/div>\n        \n\n\n\n<\/p>
Vamos instalar o Ruby on Rails utilizando o RubyGem, que é o gerenciador de pacotes oficial para Ruby.  Esse é o melhor jeito de garantir que você sempre tenha a versão mais recente do framework, com atualizações frequentes.<\/p>
O RubyGem também torna todo o processo de instalação, remoção e gerenciamento das Ruby gems muito mais prático. Ele cuida das dependências e bibliotecas Ruby, facilitando bastante a administração do seu projeto.<\/p>
Normalmente, o RubyGem já vem pré-instalado com a linguagem Ruby. Para conferir se está disponível no seu sistema, consulte o número da versão:<\/p>
gem -v<\/pre>
Se precisar instalar manualmente, você também pode fazer isso pelo APT com o comando:<\/p>
sudo apt install rubygems -y<\/pre>
Não se esqueça de instalar outros pacotes essenciais para o desenvolvimento, como o Bundler<\/strong> e o gerenciador de versões rbenv<\/strong>. Basta executar o seguinte comando:<\/p>
sudo gem install bundler && sudo apt install rbenv -y<\/pre>
Se você vai hospedar várias aplicações, pode precisar de diferentes versões do Ruby. Em vez de configurar manualmente, defina uma versão padrão para todo o sistema usando o plugin ruby-build<\/strong> e o rbenv<\/strong>.<\/p>
Por exemplo, para definir a versão padrão do Ruby como 2.2.3<\/strong> com um comando rbenv<\/strong>, use:<\/p>
rbenv global 2.2.3<\/pre>
Depois de instalar todos os pré-requisitos, execute este comando gem<\/strong> para iniciar a instalação do Rails:<\/p>
sudo gem install rails<\/pre>
Verifique a versão para garantir que o Rails foi instalado corretamente.<\/p>
Se você estiver usando o VPS da Hostinger, a instalação do Rails é ainda mais fácil e rápida. Basta seguir estes passos:<\/p>
    \n
  1. Faça login no hPanel<\/strong><\/a> e clique em VPS<\/strong> no menu superior.<\/li>\n\n\n\n
  2. Selecione seu Plano VPS<\/strong>.<\/li>\n\n\n\n
  3. Vá para a barra lateral → SO e Painel<\/strong> → Sistema operacional <\/strong>.<\/li>\n\n\n\n
  4. Na janela Mudar SO<\/strong> clique em Aplicação <\/strong>.<\/li>\n\n\n\n
  5. Selecione Ubuntu 22.04 com OpenLiteSpeed and Rails<\/strong>.<\/li>\n\n\n\n
  6. Clique em Mudar SO<\/strong>.
    <\/li>\n<\/ol>
    \n
    \"Menu<\/figure>\n<\/div>
    \n\n    
    \n        \n            \n                \n            <\/svg>\n            Warning        <\/span>\n        
    \n            Atenção!<\/b> Reinstalar o sistema operacional do seu VPS apagará todos os seus dados. Antes de prosseguir, não se esqueça de criar um backup se quiser manter seus arquivos.        <\/p>\n    <\/div>\n\n    \n\n\n\n<\/p>
    4. Configure um Ambiente de Desenvolvimento<\/strong><\/h3>
    Depois de preparar sua área de hospedagem, é hora de configurar o ambiente de desenvolvimento Rails. Os passos podem variar de acordo com o sistema operacional, mas aqui vamos focar no Windows.<\/p>
    \n\n\n        
    \n            
    \n                \n                    \n                <\/svg>\n                
    \n                    Dica de especialista                <\/p>\n            <\/div>\n            
    Os passos para configurar um ambiente de desenvolvimento Ubuntu para Ruby on Rails são semelhantes aos da área de hospedagem.<\/p>\n                    <\/div>\n        \n\n\n\n<\/p>
    Instalando um Editor de Código ou IDE<\/strong><\/p>
    Para escrever e depurar o código da sua aplicação Rails, você vai precisar de um editor de texto ou de um ambiente de desenvolvimento integrado (IDE). Escolha o software com o qual você se sinta mais confortável.<\/p>
    Se estiver em dúvida, dê uma olhada no nosso artigo sobre os melhores editores de código<\/strong><\/a>. Recomendamos escolher um editor que ofereça recursos como destaque de sintaxe e preenchimento automático, pois isso pode tornar o desenvolvimento mais eficiente e reduzir erros.<\/p>
    Neste tutorial, vamos usar o Visual Studio Code (VSCode)<\/strong><\/a>. Esse IDE gratuito possui diversos plugins que podem aumentar sua produtividade, como o depurador de código Ruby VSCode rdbg<\/strong>.<\/p>
    Instalando Ruby no Windows<\/strong><\/p>
    Seu ambiente de desenvolvimento precisa das mesmas dependências do servidor de hospedagem. No entanto, em vez de usar comandos como no Linux, os usuários de Windows precisam baixar o pacote de instalação diretamente do site oficial do rubyinstaller<\/strong><\/a>. Recomendamos escolher a versão mais recente do Ruby com devkit.<\/p>
    Dê um duplo clique no arquivo executável e siga as instruções para completar a instalação do Ruby. Esse processo também vai configurar o gerenciador de pacotes RubyGem e o servidor web WEBrick. O WEBrick é um servidor de desenvolvimento Rails que permite que você hospede sua aplicação diretamente na sua máquina para testes.<\/p>
    Instalando Rails no Windows<\/strong><\/p>
    Os passos para instalar o Rails no Windows são semelhantes aos de outros sistemas operacionais. Abra o Prompt de Comando<\/strong>, PowerShell<\/strong> ou o Terminal do VSCode<\/strong> como administrador e execute o seguinte comando gem<\/strong>:<\/p>
    gem install rails<\/pre>
    Isso configurará o framework da web e suas dependências. Para garantir que o software foi instalado corretamente, verifique a versão do Rails com o comando:<\/p>
    rails -v<\/pre>
    \"Terminal<\/figure>
    Instalando Controle de Versão Git<\/strong><\/p>
    O Git facilita o envio de código e arquivos do seu computador para o ambiente ao vivo. Embora o VPS da Hostinger suporte outros métodos, como SFTP<\/strong><\/a>, o Git é mais eficiente.<\/p>
    Baixe a versão mais recente do Git no site oficial<\/strong><\/a> e complete a instalação. Abra a aplicação Git Bash<\/strong> no menu iniciar e execute o seguinte comando para verificar a versão:<\/p>
    git version<\/pre>
    Depois, configure um repositório Git para armazenar o código do seu projeto e a documentação. Escolha uma plataforma que atenda às suas necessidades e ao seu fluxo de trabalho, como GitHub ou BitBucket.<\/p>
    \"Git<\/figure>
    5. Crie Sua Primeira Aplicação Rails<\/strong><\/h3>
    Para começar a criar sua aplicação Rails, abra o terminal do VSCode<\/strong> pressionando o atalho Ctrl +`<\/strong>. Em seguida, navegue até o diretório do seu projeto usando o comando cd<\/strong>:<\/p>
    cd D:\\Project<\/pre>
    Crie os arquivos e pastas necessários para o projeto Rails com o seguinte comando, substituindo rails_app<\/strong> pelo nome que você escolher para sua aplicação:<\/p>
    rails new rails_app<\/pre>
    A pasta da aplicação inclui vários diretórios, cada um com uma função específica.  Por exemplo, a pasta app\/<\/strong> contém os principais componentes da sua aplicação, enquanto a pasta config\/<\/strong> armazena os arquivos de configuração. Para mais detalhes sobre a estrutura do Rails, consulte o guia de início<\/strong><\/a> (disponível em inglês).<\/p>
    Vá para a pasta principal da aplicação com o comando cd<\/strong> e inicie o projeto com:<\/p>
    rails server --binding=0.0.0.0<\/pre>
    Insira localhost:3000 <\/strong>no seu navegador. Se a tela de boas-vindas do Rails aparecer, você pode começar a programar sua aplicação e mover os arquivos para o seu servidor usando comandos Git.<\/p>
    \"Tela<\/figure>
    Depois de mover os arquivos para o seu VPS, conecte-se a ele via SSH. Navegue até a pasta do projeto e execute o mesmo comando para iniciar a aplicação:<\/p>
    rails server --binding=0.0.0.0<\/pre>
    Acesse vpsipaddress:3000<\/strong> no navegador para ver sua aplicação em funcionamento.  Para parar a aplicação, pressione Ctrl + C<\/strong> na linha de comando. Execute o mesmo comando para reiniciá-la.<\/p>
    Melhores Práticas de Ruby on Rails<\/strong><\/h2>
    Esta seção explorará as melhores práticas para a instalação do Ruby on Rails para ajudá-lo a otimizar o processo.<\/p>
    Gerencie Versões com o Gerenciador de Versões Ruby (RVM)<\/strong><\/p>
    Hospedar várias aplicações com diferentes versões do Ruby em um único servidor pode causar incompatibilidades. O RVM resolve esse problema, permitindo que você gerencie várias instalações do Ruby através de uma interface de linha de comando.<\/p>
    Com o RVM, você pode instalar, gerenciar e alternar entre diferentes versões de Ruby com facilidade.  Além disso, o RVM oferece gerenciamento de gemsets<\/strong>, que são ambientes isolados para instalações de gems.<\/p>
    No VPS da Hostinger, você pode instalar o RVM para configurar um ambiente adequado para suas aplicações. Isso não só garante a funcionalidade, mas também simplifica o desenvolvimento, pois você não precisa gerenciar vários servidores.<\/p>
    Melhore o Desenvolvimento com Gems e Pacotes Essenciais<\/strong><\/p>
    No Rails, gems são pacotes adicionais que ampliam a funcionalidade do framework e simplificam diversas tarefas.  Você pode instalar essas gems usando o gerenciador de dependências Bundler.<\/p>
    Para adicionar uma gem ao seu projeto, insira a seguinte linha no seu gemfile<\/strong>:<\/p>
    gem 'gem_name'<\/pre>
    Depois, instale o pacote com o comando bundle<\/strong>:<\/p>
    bundle install gem_name<\/pre>
    Existem muitas gems com diferentes propósitos.  Por exemplo, o Devise<\/strong> é ideal para configurar a autenticação de usuários nas suas aplicações,  enquanto o Paperclip<\/strong> ou CarrierWave<\/strong> são ótimos para habilitar o upload de arquivos.<\/p>
    Use Controle de Versão com Git<\/strong><\/p>
    Um sistema de controle de versão é essencial no desenvolvimento de software, pois permite acompanhar as mudanças no projeto.  Além de oferecer um ponto de restauração para resolver problemas, o controle de versão facilita a integração contínua e a implantação (CI\/CD), automatizando o processo.<\/p>
    O Git é um sistema de controle de versão que ajuda os desenvolvedores a otimizar suas tarefas e melhorar a colaboração.  Com o Git, é possível trabalhar em um projeto simultaneamente, mas de forma isolada, permitindo um fluxo de trabalho mais eficiente.<\/p>
    Você pode usar comandos simples do Git para enviar arquivos para um servidor remoto e criar ramos de desenvolvimento isolados.<\/p>
    Junte-se à Comunidade Ruby on Rails<\/strong><\/p>
    Ruby é uma das linguagens de programação de servidor mais usadas, até mais famosa que o JavaScript<\/strong><\/a>.  Por causa disso, o framework Rails conta com uma grande comunidade de usuários.<\/p>
    Isso é ótimo para quem está começando, pois permite encontrar soluções de forma rápida para qualquer dificuldade com o framework. Há diversos fóruns online onde você pode buscar respostas e tirar dúvidas.<\/p>
    O Rails tem um fórum oficial<\/u><\/strong><\/a> (disponível em inglês) bastante ativo. Além disso, você pode participar de fóruns não oficiais, como os de provedores de cursos de Rails, como o GoRails<\/strong><\/a> (disponível em inglês), ou plataformas populares como o Reddit.<\/p>
    Mantenha-se Atualizado<\/strong><\/p>
    Instalar a versão mais recente do Ruby e do Rails garante que sua aplicação tenha as últimas correções de segurança. As atualizações também costumam incluir correções de bugs e compatibilidade com novos softwares, o que melhora a estabilidade do seu ambiente de hospedagem.<\/p>
    Usar as versões mais recentes do Rails e do Ruby também garante suporte contínuo para resolver problemas. Para se manter atualizado, assine newsletters de desenvolvimento web, participe de fóruns e confira as notas de lançamento<\/strong><\/a> (disponíveis em inglês).<\/p>
    Se você gerencia várias aplicações, uma ferramenta como o RVM pode facilitar bastante. Por exemplo, você pode listar todas as versões disponíveis do Ruby com este comando:<\/p>
    rvm list<\/pre>
    Conclusão<\/strong><\/h2>
    Ruby on Rails é um framework muito conhecido para desenvolver aplicações para web. Ele oferece uma variedade de bibliotecas, modelos e ferramentas que ajudam os desenvolvedores a adicionar novas funcionalidades ao software sem precisar começar do zero.<\/p>
    Nesse artigo, mostramos como instalar o Ruby on Rails no Ubuntu:<\/p>