Como Instalar Ruby on Rails no Debian 12

Ruby on Rails ou RoR é um framework de aplicação web gratuito e de código aberto escrito em Ruby e lançado sob a licença MIT. Rails é um framework web de pilha completa para construir facilmente aplicações de nível empresarial. Rails vem com diferentes ferramentas que permitem aos desenvolvedores criar facilmente tanto aplicações frontend quanto backend. Ruby on Rails também possui recursos de segurança integrados, como proteção contra ataques comuns, como injeção de SQL, XSS e CSRF.

Ruby on Rails fornece uma estrutura padrão para o banco de dados, renderização de templates HTML, um serviço web e uma página web. Ele segue a arquitetura de modelo-visão-controlador (MVC) e também utiliza filosofias de design bem conhecidas, como Não Repita a Si Mesmo (DRY), Convenção sobre Configuração (CoC) e padrão de registros ativos. Ruby on Rails foi projetado para ser rápido e fácil de usar e aprender. Alguns sites notáveis desenvolvidos com Rails incluem Twitch, Airbnb, Github, Soundcloud, etc.

Neste guia, vamos orientá-lo na instalação do Ruby on Rails no servidor Debian 12. Você instalará o Ruby on Rails com um servidor de banco de dados PostgreSQL e o gerenciador de versões Rbenv Ruby. Você também criará um scaffold, a estrutura básica do projeto Rails.

Pré-requisitos

Antes de começar, confirme se você tem:

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

Instalando Dependências

No primeiro passo, você instalará algumas dependências básicas em seu servidor Debian. Isso inclui o servidor de banco de dados PostgreSQL que será usado como o banco de dados para seu projeto Rails, o node.js e o gerenciador de pacotes Yarn que será usado pelo Rails para compilar ativos estáticos.

Para começar, atualize e atualize seu índice de pacotes executando o comando apt update abaixo.

sudo apt update

Em seguida, instale as dependências usando o seguinte comando apt install. Isso inclui o servidor de banco de dados PostgreSQL, driver libpq, Node.js, Yarn, Git e algumas bibliotecas e ferramentas do sistema.

sudo apt install 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 software-properties-common libffi-dev

Digite y para confirmar e prosseguir com a instalação.

Uma vez que as dependências estão instaladas, verifique o status do servidor PostgreSQL usando o seguinte comando. Isso garantirá que o PostgreSQL esteja em execução e habilitado em sua máquina Debian.

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Se o PostgreSQL estiver habilitado, você deve obter a saída habilitada. Quando o PostgreSQL estiver em execução, você deve obter a saída ativa (em execução) ou ativa (saída).

Por fim, verifique o Node.js e o gerenciador de pacotes Yarn executando o comando abaixo.

node --version  
yarnpkg --version

Neste exemplo, Node.js 18 e Yarn 1.22 estão instalados.

Instalando Rbenv

Após instalar as dependências de pacotes, o próximo passo é instalar o Rbenv, o gerenciador de versões Ruby para sistemas operacionais semelhantes ao Unix. Com o Rbenv, você pode gerenciar facilmente o ambiente de suas aplicações Ruby, além de poder instalar várias versões do Ruby em seu sistema.

Faça login no seu usuário usando o seguinte comando.

su - user

Baixe o código-fonte do rbenv e o plugin ruby-build via o comando git abaixo.

git clone https://github.com/rbenv/rbenv.git ~/.rbenv  
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

Agora execute o seguinte comando para adicionar um PATH personalizado ao seu shell.

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc  
echo 'eval "$(rbenv init -)"' >> ~/.bashrc  
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc

Recarregue sua configuração ~/.bashrc para aplicar as mudanças. Após executar o comando, sua instalação do rbenv deve ser ativada.

source ~/.bashrc

Verifique o rbenv executando o comando rbenv abaixo. Se a instalação do rbenv for bem-sucedida, você deve ver os comandos/opções disponíveis do rbenv.

rbenv commands

Instalando Ruby via Rbenv

Com o Rbenv instalado, você pode agora instalar o Ruby em seu sistema. Com o Rbenv, você instalará o Ruby apenas em seu ambiente atual, o que não afeta todo o sistema. Você instalará o Ruby 3.2.2 em seu ambiente de usuário atual.

Execute o comando rbenv install abaixo para instalar o Ruby 3.2.2 em seu sistema.

rbenv install 3.2.2

Durante a instalação, você deve ver isso:

Uma vez que o Ruby esteja instalado, execute o seguinte comando para definir a versão padrão do Ruby como 3.2.2.

rbenv global 3.2.2

Por fim, verifique a versão do Ruby em seu sistema usando o comando abaixo.

ruby -v

Se tudo correr bem, você deve ver que o Ruby 3.2.2 está instalado.

Instalando Ruby on Rails

Neste ponto, seu sistema está configurado e pronto para instalar o Ruby on Rails em sua máquina Debian. Neste exemplo, você instalará o Ruby on Rails 7.0 e verificará a lista de versões disponíveis do Rails no site oficial.

Execute os comandos gem abaixo para instalar o bundler e, em seguida, instalar o Ruby on Rails 7.0.7.2.

gem install bundler  
gem install rails -v 7.0.7.2

Durante a instalação, você deve ver uma saída como a seguinte:

Agora execute o comando rebenv abaixo para rehash e recarregar seu ambiente atual.

rbenv rehash

Por fim, execute o comando rails abaixo para garantir que o Ruby on Rails esteja instalado.

rails version  
rails -h

Se a instalação for bem-sucedida, você deve ver sua versão atual do Rails e a página de ajuda do comando rails.

Criando o Primeiro Projeto Rails

Nesta seção, você aprenderá como criar seu primeiro projeto com Ruby on Rails. Você usará o PostgreSQL como o banco de dados padrão para seu projeto Rails. Para conseguir isso, você deve completar o seguinte:

• Preparar o usuário do PostgreSQL para a aplicação.
• Criar o primeiro projeto Rails.

Preparar Usuário do Banco de Dados

Primeiro, você deve criar um novo usuário PostgreSQL que será usado para sua aplicação Rails. Este usuário deve ter privilégios para criar bancos de dados e usuários.

Volte para sua conta de usuário e faça login no servidor PostgreSQL usando o comando abaixo.

sudo su  
sudo -u postgres psql

Agora crie um novo usuário bob com a senha p4sswordbob. Em seguida, atribua novos privilégios para criar um banco de dados e funções ao usuário bob.

CREATE USER bob WITH PASSWORD 'p4sswordbob';  
ALTER USER bob CREATEDB CREATEROLE;

Verifique a lista de usuários e privilégios em seu servidor PostgreSQL usando o comando abaixo.

du

Você deve ver o usuário bob com privilégios CREATEDB e CREATEROLE.

Digite \q para sair do servidor PostgreSQL.

Por fim, faça login no seu usuário e execute o seguinte comando psql para fazer login no servidor PostgreSQL como o novo usuário bob.

su - user  
psql -U bob -h 127.0.0.1 -d postgres

Uma vez conectado ao servidor PostgreSQL, execute a seguinte consulta para verificar suas informações de conexão.

\conninfo

Você deve ver que está conectado ao servidor PostgreSQL como o usuário bob.

Digite \q para sair do servidor PostgreSQL.

Criando Projeto Rails

Após criar um usuário PostgreSQL, você pode agora começar a criar um novo projeto Rails via a utilidade de linha de comando rails.

Para criar um novo projeto rails, execute o comando rails abaixo. Neste exemplo, você criará um novo projeto testapp com o banco de dados padrão PostgreSQL.

rails new testapp -d postgresql

A saída do comando deve ser parecida com isto:

Após o projeto ser criado, o novo diretório ~/testapp também será criado. Mova-se para o diretório ~/testapp e abra a configuração do banco de dados config/database.yml usando seu editor de texto preferido.

cd testapp/  
nano config/database.yml

Altere as configurações padrão do banco de dados para desenvolvimento, teste e produção. Certifique-se de inserir seu nome de usuário e senha do PostgreSQL.

development:  
  <<: *default  
  database: testapp_development  
  
  # O papel de banco de dados especificado está sendo usado para conectar ao postgres.  
  # Para criar papéis adicionais no postgres, veja `$ createuser --help`.  
  # Quando deixado em branco, o postgres usará o papel padrão. Este é  
  # o mesmo nome que o usuário do sistema operacional que executa o Rails.  
  username: bob  
  
  # A senha associada ao papel postgres (nome de usuário).  
  password: p4sswordbob  
  
  # Conectar em um socket TCP. Omitido por padrão, uma vez que o cliente usa um  
  # socket de domínio que não precisa de configuração. O Windows não tem  
  # sockets de domínio, então descomente estas linhas.  
  host: localhost  
  
  # A porta TCP que o servidor escuta. Padrão para 5432.  
  # Se seu servidor estiver em uma porta diferente, altere conforme necessário.  
  port: 5432

Salve e saia do arquivo quando terminar.

Agora execute o comando rails abaixo para migrar o banco de dados. Isso criará automaticamente um novo banco de dados para seu projeto testapp.

rails db:setup  
rails db:migrate

Abaixo você deve ver a saída durante a migração do banco de dados do projeto testapp.

Após o banco de dados ser migrado, execute o comando rails abaixo para executar o projeto testapp. Isso executará o testapp dentro do seu endereço IP na porta 3000.

rails server -b 192.168.10.15

Na saída a seguir, você deve ver que o testapp está em execução.

Agora abra seu navegador web favorito e visite o endereço IP do seu servidor seguido da porta 3000, como http://192.168.10.15:3000/. Se sua instalação for bem-sucedida, você deve ver a página index.html padrão do Ruby on Rails.

Pressione Ctrl+c para encerrar sua aplicação Rails.

Scaffold Rails para Kit Inicial

Um scaffold é uma maneira automática de gerar a estrutura básica de um projeto Rails, que inclui um controlador, um modelo e uma visão.

Execute o comando rails abaixo para criar um scaffold books com três campos title, author e publication_year.

rails g scaffold books title:string author:string publication_year:integer

Agora migre o banco de dados para aplicar as mudanças usando o comando rails abaixo.

rails db:migrate

Em seguida, execute seu projeto Rails executando o comando rails server abaixo.

rails server -b 192.168.10.15

Uma vez que o testapp esteja em execução, verifique o scaffold de livros via o caminho da URL /books, como http://192.168.10.15:3000/books. Se tudo correr bem, você deve ver o scaffold gerado como o seguinte:

Agora você pode inserir novos dados no scaffold de livros como o seguinte:

Conclusão

Em conclusão, você completou a instalação do Ruby on Rails com o servidor de banco de dados PostgreSQL e Rbenv no servidor Debian 12. Você também aprendeu como gerar scaffolds para estruturas básicas para o projeto Rails.