Ruby: Plataforma de desenvolvimento

Configure o seu ambiente de desenvolvimento para um fluxo de trabalho fluido e eficiente

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

A Stackhero disponibiliza uma solução Ruby cloud pronta a usar, que oferece várias vantagens, 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 maior segurança.

Desfrute de backups automáticos, atualizações com um clique e uma estrutura de preços simples, transparente e previsível.

Obtenha performance otimizada e segurança reforçada graças a uma infraestrutura privada e dedicada.

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

Uma plataforma de desenvolvimento bem preparada torna o seu trabalho mais rápido, agradável e fiável.

Este guia ajuda-o a escolher entre desenvolvimento local e remoto, explica como instalar Ruby com asdf e mostra como iniciar um novo projeto Ruby.

Escolher o seu ambiente de desenvolvimento: local ou remoto

Pode executar projetos Ruby de duas formas: num ambiente local no seu computador ou na cloud, utilizando um serviço pronto a usar como o Code-Hero. Cada abordagem tem as suas vantagens, por isso escolha a que melhor se adapta ao seu fluxo de trabalho.

O desenvolvimento local é ideal se prefere trabalhar offline. Tudo fica instalado na sua própria máquina, mas a configuração e manutenção exigem mais tempo, especialmente se está a começar a programar ou precisa de várias ferramentas. É responsável por atualizações, backups e segurança, e está limitado pelos recursos do seu computador. Aceder ao seu trabalho a partir de outro dispositivo pode também ser um desafio.

O desenvolvimento remoto com o Code-Hero oferece-lhe um ambiente pré-configurado pronto em segundos. Inclui uma versão personalizada do Visual Studio Code e suporte integrado para ferramentas como Git, Docker, Ruby, Rails, entre outras. Os servidores cloud normalmente disponibilizam mais CPU, RAM e armazenamento do que máquinas locais. Como tudo corre no browser, pode trabalhar a partir de qualquer dispositivo ou sistema operativo.

Ferramentas integradas como Docker e Traefik facilitam a utilização de TLS e domínios reais (por exemplo, https://your-project.you.your-company.dev). Isto aproxima-se bastante de ambientes de produção reais, permitindo-lhe testar webhooks (de GitHub, Slack, Stripe, etc.), gerir CORS e desenvolver com serviços semelhantes aos de produção sem configuração adicional.

Escolha a opção que corresponde ao seu fluxo de trabalho, competências e necessidades do projeto:

Desenvolvimento local:
- ✅ Funciona offline: Não requer ligação à internet
- ❌ Recursos limitados: Restrito ao desempenho do seu computador
- ❌ Configuração manual: Instala e configura as ferramentas por si
- ❌ Manutenção contínua: Atualizações e backups são da sua responsabilidade
Desenvolvimento remoto (em Code-Hero):
- ✅ Pronto instantaneamente: Todas as ferramentas já instaladas e configuradas
- ✅ Alto desempenho: Utiliza servidores cloud dedicados e potentes
- ✅ Trabalhe em qualquer lugar: Aceda ao seu ambiente a partir de qualquer dispositivo
- ✅ Integrações em tempo real: Domínios HTTPS integrados para webhooks e serviços de terceiros
- ❌ Requer internet: Necessita de ligação à rede

Desenvolver em Ruby: configuração remota

Um ambiente remoto elimina a configuração manual e acelera o seu primeiro commit. O Code-Hero corre em servidores de alto desempenho, permitindo-lhe focar-se em desenvolver funcionalidades em vez de configurar ferramentas. Obtém um workspace novo e pronto a usar para cada projeto, e a configuração demora apenas alguns segundos.

Se estiver a utilizar o Code-Hero, pode avançar para Criar um projeto Ruby. Para desenvolvimento local, continue a ler.

Desenvolver em Ruby: configuração local

Um ambiente Ruby local dá-lhe controlo total, mas exige alguns passos adicionais. Instala o Ruby, dependências e ferramentas manualmente.

Instalar Ruby com asdf

O asdf é um gestor de versões flexível para várias linguagens, incluindo Ruby, Node.js, Python e PHP. Facilita manter projetos em versões diferentes e evita conflitos entre ferramentas.

Para começar, instale o asdf seguindo o guia oficial de instalação.

Depois de instalado, pode verificar se o asdf está a funcionar executando:

asdf version

Se aparecer um número de versão, o asdf está corretamente instalado.

Para instalar a versão mais recente do Ruby:

asdf plugin add ruby https://github.com/asdf-vm/asdf-ruby.git
asdf install ruby latest
asdf global ruby latest

Verifique se o Ruby está a funcionar:

ruby --version

Isto confirma que o Ruby está pronto a ser utilizado.

Criar um projeto Ruby

Depois de instalar o Ruby:

asdf install ruby latest \
  && asdf global ruby latest

Instale o Rails:

gem install rails

Crie a sua aplicação (substitua my_app pelo nome do seu projeto):

rails new my_app
cd my_app
asdf local ruby latest

Inicie o servidor Rails:

bin/rails server

Ruby on Rails welcome screen

Estes passos dão-lhe um ponto de partida limpo para o seu projeto, e o asdf garante que utiliza sempre a versão correta do Ruby.

Por predefinição, o Rails cria um repositório Git local para o seu projeto, mas não está ligado a nenhum serviço de alojamento remoto.

Para controlo de versões fiável e backups, pode ligar o seu repositório a um serviço como GitHub, GitLab ou Bitbucket. A Stackhero disponibiliza um serviço GitLab cloud que corre em infraestrutura dedicada, garantindo-lhe privacidade e segurança na Europa ou nos EUA.

Configuração especial para Code-Hero

Se estiver a trabalhar no Stackhero Code-Hero, ajuste a configuração do Rails para acesso remoto. Abra o ficheiro config/environments/development.rb e adicione esta linha mesmo antes do último end, substituindo <XXXXXX>.stackhero-network.com pelo hostname do seu servidor Code-Hero:

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

Hosts configurations example

Depois, inicie o servidor, ouvindo em todas as interfaces de rede:

bin/rails server -b 0.0.0.0