Back-End

4 mar, 2008

Instalação do Ruby on Rails no Windows XP

Publicidade

Olá amigos. Hora de colocar a mão na massa!

Sei que o foco do iMasters é mais avançado, mas muitos fóruns e artigos que são encontrados na web não dão o suporte necessário ao usuário iniciante. Vou procurar atendê-los neste artigo, para darmos sequência aos nossos estudos. Veremos quais são as principais dificuldades.

Teoricamente, o que os sites divulgam é uma instalação fácil (e realmente é), mas às vezes surgem “probleminhas”, e devemos saber como proceder.

Mostrarei a instalação por etapas. No primeiro momento, irei detalhar a instalação do Ruby e do Rails. Em outra oportunidade irei complementar com a instalação do bando de dados, que por minha opção, utilizaremos o MySQL.

Serei cuidadoso em explicar as possíveis complicações com a instalação e teste de funcionamento, pois a maiorias dos artigos encontrados na internet não os abordam. Preparado?

Pois bem. Instalaremos:

  • Ruby
  • Rails framework

1ª Etapa: Instalando o Ruby

Para iniciarmos a instalação, precisamos obviamente do software de instalação do Ruby: http://rubyforge.org/frs/?group_id=167

Entre e baixe a última versão do Ruby para Windows.

Enquanto baixa… Empolgue-se ainda mais 🙂

Vídeo no YouTube

Por mais difícil que seja, desligue-se do que acabara de ver, e vamos voltar ao procedimento de instalação 😛

Baixou o programa? Então execute-o para iniciar a instalação:

Após abrir, clique em “Next>”.

Fig.1: Janela de boas vindas do RubyFig.1: Janela de boas vindas do Ruby

Se estiver de acordo com os termos de licença, clique em “I Agree“.

Fig.2: Licença para usoFig.2: Licença para uso

Na escolha dos componentes que serão instalados, mantenha o padrão (Ruby, SciTE e Enable RubyGems marcados). Clique em “Next>” para continuar.

Fig.3: Escolhendo componentes de instalaçãoFig.3: Escolhendo componentes de instalação

Agora escolha a pasta de destino. Preferencialmente, mantenha “c:\ruby\” e clique em “Next>”.

Fig.4: Selecionando pasta de destino.Fig.4: Selecionando pasta de destino.

Escolha o nome do atalho para sua aplicação. Em seguida clique em “Install“.

Fig.5: Colocando nome para atalhoFig.5: Colocando nome para atalho.

Instalando…

Fig.6: Progresso de instalação.Fig.6:Progresso de instalação.

Instalação completa!

Fig.7: Instalação concluída.Fig.7: Instalação concluída.

Finalizando o instalador.

Fig.8: Finalizando janela de instalação.Fig.8: Finalizando janela de instalação.

2ª Etapa: Instalando o Rails

Agora iremos instalar o Rails e suas dependências. Para isso, precisamos do Prompt de comando do Windows aberto.

Iniciar > Todos os programas > Acessórios > Prompt de comando

Ou simplesmente:

Iniciar > Executar > cmd

Fig.9: Executar.Fig.9: Executar.

O gem é um gerenciador de pacotes/plugins/engine do ruby. Ele instalará o Rails e suas dependências automaticamente.

Para isso digite: gem install rails -include-dependecies

Fig.10: Instalando o RailsFig.10: Instalando o Rails

O gem é, normalmente, reconhecido em qualquer diretório, mas às vezes apenas no diretório que se encontra (“c:\ruby\bin“), evitando isso:

Fig.11: gem não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes.Fig.11: gem não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes.

Aceite todos os frameworks e dependências, colocando “y” de YES se perguntar.

Fig.12: Iniciando a instalação do rails.Fig.12: Iniciando a instalação do rails.

Fim de instalação!

Fig.13: Instalação concluídaFig.13: Instalação concluída

Uma forma de certificar a instalação, é verificando a versão de ambos os softwares (Ruby e o Rails).

Para isso, digite no Prompt de comando:

ruby -v

logo em seguida:

rails -v

Fig.14: Verificando versões.Fig.14: Verificando versões.

Que tal agora testarmos o funcionamento do servidor?

Vamos então criar um projeto para testá-lo. Pode ser o nome que quiser. Escolhi “projeto”. Digite no Prompt de comando:

rails projeto

Fig.15: Criando projeto para teste.Fig.15: Criando projeto para teste.

Em seguida, entre no diretório criado:

cd projeto

Dentro da pasta, inicialize o servidor (WEBrick) com o seguinte comando:

ruby script\server

Fig.16: Inicializando o servidor.Fig.16: Inicializando o servidor.

Mantenha o Prompt de comando aberto com a execução do servidor. Se fechar não funcionará. Abra seu browser. Acesse o servidor pelo http://localhost:3000/.

Se tudo der certo, aparecerá:

Fig.17: Sucesso no teste do servidor.Fig.17: Sucesso no teste do servidor.

Se não….

Fig.18: Falha no teste do servidor.Fig.18: Falha no teste do servidor.

Obs.: Será necessário rever os passos para detectar o erro.

Então é isso pessoal!

Qualquer dúvida, comente com o respectivo e-mail para contato.

Até a próxima!