Ruby: Introdução

Introdução ao Ruby on Rails

👋 Bem-vindo à documentação do Stackhero!

A Stackhero oferece uma solução Ruby cloud pronta a usar que proporciona uma série de benefícios, incluindo:

Implemente a sua aplicação em segundos com um simples git push.

Utilize o seu próprio nome de domínio e beneficie da configuração automática de certificados HTTPS para uma segurança reforçada.

Desfrute de tranquilidade com backups automáticos, atualizações com um clique, e preços simples, transparentes e previsíveis.

Obtenha desempenho ótimo e segurança robusta graças a uma VM privada e dedicada.

Poupe tempo e simplifique a sua vida: só leva 5 minutos para experimentar a solução de Ruby cloud hosting da Stackhero!

Bem-vindo ao guia de introdução ao Ruby on Rails. Neste guia, será apresentado a um dos frameworks de aplicações web mais populares, projetado para simplificar e acelerar o seu processo de desenvolvimento.

Ruby on Rails (frequentemente chamado apenas de Rails) é um framework de aplicação web do lado do servidor construído com Ruby. Segue o padrão arquitetónico model-view-controller (MVC) e adota os princípios Convention over Configuration (CoC) e Don't Repeat Yourself (DRY). Estas características tornam o Rails uma opção poderosa, eficiente e flexível para o desenvolvimento web.

Abaixo, guiamos você através dos passos essenciais para lançar um novo projeto Ruby on Rails. Aprenderá a instalar Ruby e Rails, configurar o seu primeiro projeto e até mesmo construir uma aplicação simples "Hello World". Orientações adicionais são fornecidas para diferentes ambientes de desenvolvimento, incluindo o uso da plataforma online Stackhero Code-Hero.

Compreender a diferença entre Ruby e Rails

Ruby é uma linguagem de programação dinâmica e open-source semelhante a PHP, JavaScript ou Python. Enfatiza a simplicidade e produtividade com uma sintaxe elegante que é fácil de ler e escrever.

Rails é um framework robusto de aplicação web do lado do servidor que funciona em Ruby. Oferece uma abordagem estruturada e padronizada para construir aplicações web, fornecendo ferramentas e bibliotecas para simplificar tarefas comuns de desenvolvimento.

Muitos desenvolvedores escolhem Ruby on Rails em vez de usar apenas Ruby porque o seu framework abrangente agiliza o desenvolvimento e aumenta a produtividade.

Configurar um projeto Ruby

Iniciar um novo projeto Ruby é simples. Siga estes passos para começar:

Primeiro, certifique-se de ter a versão mais recente do Ruby instalada no seu sistema. Pode verificar isso executando o seguinte comando no seu terminal:
```
asdf install ruby latest \
  && asdf global ruby latest
```
Se ainda não instalou asdf, precisará fazê-lo antes de prosseguir. Consulte a documentação oficial do asdf para instruções detalhadas de instalação.

Alternativamente, pode usar Stackhero Code-Hero, uma solução de desenvolvimento online onde todas as ferramentas necessárias estão pré-instaladas. Esta plataforma permite que comece a programar imediatamente sem instalação manual.
Em seguida, instale o Rails. O Rails é distribuído como um RubyGem, o que torna a instalação simples:
```
gem install rails
```
Depois, crie uma nova aplicação Rails chamada my_app e especifique a versão do Ruby usando estes comandos:
```
rails new my_app
cd my_app
asdf local ruby latest
```
Para lançar o servidor Rails, execute o seguinte comando:
```
bin/rails server
```
Tela de boas-vindas do Ruby on Rails

Estes passos criam um novo projeto Ruby enquanto definem a versão apropriada do Ruby. Isto estabelece uma base sólida para o desenvolvimento da sua aplicação.

Importante: Ao executar o comando rails new, um repositório Git local é automaticamente criado para o seu projeto Ruby. No entanto, ainda não está ligado a um serviço de controlo de versão remoto.

Para um controlo de versão adequado e segurança de dados, é aconselhável conectar o seu projeto a um serviço de hospedagem como GitLab, GitHub ou Bitbucket.

Se precisar de um serviço de hospedagem de repositório, a Stackhero oferece um serviço cloud GitLab que pode ser configurado em apenas 2 minutos.

Caso especial com Stackhero Code-Hero

Ao usar uma solução de desenvolvimento online como Stackhero Code-Hero, precisa ajustar o seu ficheiro config/environments/development.rb. Adicione a seguinte configuração perto da palavra-chave final end. Substitua <XXXXXX>.stackhero-network.com pelo nome real do seu servidor:

config.hosts << "<XXXXXX>.stackhero-network.com"

Exemplo de configuração de hosts

Finalmente, inicie o servidor Rails com este comando:

bin/rails server -b 0.0.0.0

Este comando garante que o servidor Rails seja acessível a partir de qualquer endereço IP, o que é especialmente útil ao trabalhar remotamente via Stackhero Code-Hero.

Criar a sua primeira aplicação "hello world" com Ruby on Rails

Vamos percorrer o processo de criação de uma simples aplicação "Hello World" usando Ruby on Rails.

Primeiro, configure uma nova rota para a sua aplicação. Abra o ficheiro config/routes.rb e defina uma rota raiz que aponte para a ação hello#index:
```
Rails.application.routes.draw do
  root "hello#index"
end
```
Em seguida, gere o controlador Hello para gerir a lógica desta rota. Execute o seguinte comando no seu terminal:
```
bin/rails generate controller Hello index --skip-routes
```
Com esta configuração, qualquer pedido feito ao caminho URL / será gerido pelo HelloController.
Para exibir a mensagem "Hello World", crie uma visualização. Abra o ficheiro em app/views/hello/index.html.erb e substitua qualquer conteúdo existente pelo seguinte código:
```
<h1>Hello World!</h1>
```
Finalmente, inicie o servidor Rails executando o comando abaixo no seu terminal. Depois, conecte-se ao seu URL de desenvolvimento (por exemplo, http://<XXXXXX>.stackhero-network.com:3000) para ver a sua aplicação:
```
bin/rails server -b 0.0.0.0
```
Primeira página "Hello World" em Ruby on Rails

Parabéns. Acabou de criar a sua primeira aplicação Ruby on Rails!

Gerir variáveis de ambiente

As variáveis de ambiente são essenciais para proteger dados sensíveis, como chaves de API e senhas de bases de dados.

O gem dotenv-rails oferece uma maneira conveniente de gerir variáveis de ambiente no seu ambiente de desenvolvimento. Aqui estão os passos:

Adicione o gem ao seu Gemfile nos grupos apropriados:

# Gemfile
gem 'dotenv-rails', groups: [:development, :test]

Instale o gem executando:
```
bundle install
```
Crie um ficheiro .env na raiz do seu projeto e defina as suas variáveis de ambiente. Por exemplo:
```
RAILS_ENV=development
```
Para proteger os seus dados sensíveis, certifique-se de que o ficheiro .env está excluído do seu repositório Git. Adicione a seguinte linha ao seu .gitignore:
```
echo '.env*' >> .gitignore
```

Após completar estes passos, reinicie o seu servidor Rails. As variáveis de ambiente definidas no ficheiro .env estarão agora automaticamente acessíveis na sua aplicação.

Variáveis de ambiente para a sua plataforma de desenvolvimento