Como Instalar Ruby on Rails no Ubuntu 24.04

Ruby on Rails ou RoR ou Rails é um framework de aplicação web Ruby com arquitetura MVC (Model-View-Controller), bem como filosofias de design como Não Repita a Si Mesmo (DRY), Convenção sobre Configuração (CoC) e padrão de registros ativos. É um framework web de pilha completa para construir aplicações web de nível empresarial.

Neste tutorial, vamos guiá-lo pelo processo de instalação do Ruby on Rails no Ubuntu 24.04, criando o primeiro projeto Rails, configurando o PostgreSQL como o banco de dados para seu projeto Rails e gerando um scaffold com o comando ‘rails’.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

• Um servidor Ubuntu 24.04.
• Um usuário não-root com privilégios de administrador sudo.

Instalando Dependências

Para instalar o Ruby on Rails no seu sistema Ubuntu, você deve instalar dependências como Ruby, Node.js, PostgreSQL (opcional para banco de dados), Git e pacotes de desenvolvimento adicionais. Esses pacotes estão disponíveis no repositório padrão do Ubuntu, e você pode instalá-los usando o APT.

Para começar, atualize seu repositório Ubuntu com o seguinte comando:

sudo apt update

Agora instale as dependências para Ruby on Rails com o comando abaixo. Com isso, você instalará Ruby, PostgreSQL, Node.js, git e alguns pacotes de desenvolvedor.

sudo apt install ruby ruby-dev postgresql libpq-dev nodejs yarnpkg git zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev libffi-dev

Digite Y para prosseguir com a instalação.

Após a instalação ser concluída, verifique a versão do Ruby e do Node.js com o seguinte:

ruby -v  
node -v

Você pode ver abaixo que Ruby 3.2 e Node.js 18.19 estão instalados.

Em seguida, execute o comando abaixo para configurar o Yarn como gerenciador de pacotes do Node.js com o comando abaixo. Isso criará um novo comando ‘ yarn ‘ e você verá a versão do Yarn.

sudo ln -s /usr/bin/yarnpkg /usr/bin/yarn  
yarnpkg -v

Por último, verifique o status do serviço PostgreSQL com o seguinte:

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

O servidor PostgreSQL será iniciado na inicialização, e o status do PostgreSQL será ‘ ativo (exited) ‘.

Criando Usuário PostgreSQL

Após as dependências serem instaladas, você criará um novo usuário PostgreSQL para seu projeto Rails. Este usuário deve ser capaz de fazer login e criar um novo banco de dados no PostgreSQL.

Faça login no servidor PostgreSQL com o comando abaixo.

sudo -u postgres psql

Execute as seguintes consultas para criar um novo usuário PostgreSQL ‘ appuser ‘ com a senha ‘ AppuserPassword ‘. Este usuário poderá criar um banco de dados e função no PostgreSQL.

CREATE USER appuser WITH PASSWORD 'AppuserPassword';  
ALTER USER appuser CREATEDB CREATEROLE;

Agora digite quit ou pressione Ctrl+d para sair do PostgreSQL.

Em seguida, execute o seguinte comando para fazer login no PostgreSQL com o usuário ‘ appuser ‘. Digite sua senha quando solicitado.

su - postgres  
psql -U appuser -h 127.0.0.1 -d postgres

Após fazer login, verifique o status da conexão PostgreSQL com o seguinte:

\conninfo

Você pode ver abaixo que o novo usuário ‘ appuser ‘ pode se conectar ao servidor PostgreSQL com a autenticação por senha através de localhost ou 127.0.0.1.

Instalando Ruby on Rails

Nesta seção, você instalará a versão mais recente do Ruby on Rails no ambiente específico do usuário. Portanto, você precisa configurar o diretório padrão GEM_HOME sob seu usuário.

Primeiro, faça login no seu usuário com o seguinte comando:

su - user

Crie um novo diretório ~/.gem e adicione a variável de ambiente GEM_HOME através do arquivo ~/.bashrc. Com isso, todos os gems do Ruby serão instalados no diretório ~/.gem.

mkdir -p ~/.gem  
echo 'export GEM_HOME=$HOME/.gem' >> $HOME/.bashrc

Agora execute o comando abaixo para recarregar seu shell atual e verificar a variável de ambiente GEM_HOME. Você verá que GEM_HOME está apontado para o diretório ~/.gem.

source ~/.bashrc  
echo $GEM_HOME

Em seguida, execute o comando gem abaixo para instalar o bundler no seu sistema.

gem install bundler

Depois disso, instale o Ruby on Rails com o seguinte comando gem. Você pode instalar a versão mais recente do Ruby on Rails ou escolher uma versão específica usando a opção -v.

gem install rails  
gem install rails -v 7.1.0

Quando a instalação estiver concluída, verifique a versão do Ruby on Rails com o comando abaixo:

rails --version  
rails --help

Como mostrado abaixo, a versão mais recente do Ruby on Rails 7.1.3 está instalada, e você também pode ver o uso básico do comando ‘ rails ‘.

Criando Projeto com Ruby on Rails e PostgreSQL

Agora que você instalou o Ruby on Rails. Nesta seção, você criará seu primeiro projeto Rails com PostgreSQL como o banco de dados padrão.

Execute o comando ‘rails’ abaixo para criar um novo projeto Rails. Neste exemplo, você criará um novo projeto testapp com o banco de dados padrão PostgreSQL.

rails new testapp -d postgresql

Você pode ver abaixo que a aplicação Rails foi gerada, incluindo o git inicializado.

Agora mude para o diretório ~/testapp e edite o arquivo de configuração do banco de dados ‘ config/database.yml ‘.

cd ~/testapp/  
nano config/database.yml

Altere os detalhes do banco de dados para os ambientes development, test e production como a seguir. O banco de dados para cada ambiente será criado automaticamente durante a migração.

development:  
 <<: *default  
database: testapp_development  
username: appuser  
password: AppuserPassword  
host: localhost  
port: 5432  
  
test:  
 <<: *default  
database: testapp_test  
username: appuser  
password: AppuserPassword  
host: localhost  
port: 5432  
  
production:  
 <<: *default  
database: testapp_production  
username: appuser  
password: <%= ENV["TESTAPP_DATABASE_PASSWORD"] %>

Quando terminar, salve o arquivo e saia.

Em seguida, execute o seguinte comando ‘ rails ‘ para configurar e migrar o banco de dados.

rails db:setup  
rails db:migrate

Após a migração do banco de dados ser concluída, execute seu projeto Rails com o seguinte:

rails server -b 0.0.0.0

Você pode ver abaixo que seu projeto Rails está rodando na porta padrão 3000.

Visite o endereço IP do seu servidor http://192.168.5.30:3000/ usando seu navegador web. Se a instalação do Rails for bem-sucedida, você deve obter o seguinte índice padrão do Rails:

Gerando com Scaffolding

Ruby on Rails fornece uma maneira fácil de construir sua aplicação para iniciantes. Você pode utilizar um scaffold para gerar a estrutura básica de um projeto Rails, que inclui um controlador, um modelo e uma visão.

Execute o seguinte comando para gerar um scaffold para uma aplicação simples ‘ site ‘ com duas entradas de usuário ‘ name ‘ e ‘ url ‘.

rails g scaffold site name:string url:string

Abaixo está o modelo, controlador e visão gerados para sua aplicação Rails.

Após o scaffold ser gerado, execute o seguinte comando para migrar seu banco de dados Rails.

rails db:migrate

Você pode ver abaixo que o banco de dados para Rails foi migrado.

Agora execute seu projeto Rails com o seguinte comando.

rails server -b 0.0.0.0

Por último, visite o endereço IP do seu servidor http://192.168.5.30:3000/sites para acessar a aplicação ‘ site ‘. Você pode enviar um novo nome de dados e url. Então, você pode ver abaixo um exemplo após novos dados serem enviados.

Conclusão

Parabéns! Você terminou a instalação do Ruby on Rails no Ubuntu 24.04. Você criou um projeto Rails com PostgreSQL como o banco de dados. Por último, você também aprendeu como gerar aplicações básicas no Rails usando o recurso de scaffold.