Como configurar um ambiente de desenvolvimento do Ruby

Neste tutorial, mostramos como preparar sua máquina local para o desenvolvimento em Ruby, incluindo o desenvolvimento de aplicativos do Ruby executados no Google Cloud Platform (GCP). Siga este tutorial para instalar o Ruby e as ferramentas relevantes.

Leia o Guia de início rápido sobre Ruby e GCP para ter uma visão geral do Ruby e saber como executar aplicativos do Ruby no GCP.

Objetivos

  • Instalar o Ruby.
  • Instalar o Bundler.
  • Instalar um editor (opcional).
  • Instalar o SDK do Cloud.
  • Instalar a biblioteca de cliente do Cloud para Ruby.

Instalar o Ruby

As instruções de instalação do Ruby variam de acordo com o sistema operacional. Siga o guia do sistema operacional que você usa na máquina local de desenvolvimento. Este tutorial aplica-se às versões estáveis e que não atingiram o fim da vida útil (EOL, na sigla em inglês) do Ruby listadas em Ruby-lang.

macOS

Recomendamos usar o rbenv para gerenciar as instalações do Ruby no macOS. O rbenv gerencia várias instalações de versão do Ruby na sua máquina, e há um plug-in denominado ruby-build que agrega compatibilidade ao rbenv para instalar uma versão específica do Ruby.

Por padrão, o macOS inclui uma versão do Ruby. No entanto, é melhor executar uma instalação separada das versões mais recentes do Ruby para se manter atualizado e evitar conflitos com o uso da versão padrão do sistema operacional.

  1. Instale o XCode.
  2. Instale as ferramentas de linha de comando do XCode usando o seguinte comando em um terminal:

    xcode-select --install
    
  3. Instale o homebrew seguindo as instruções na página inicial desse gerenciador.

  4. Instale o rbenv usando o homebrew e seguindo as instruções no arquivo rbenv readme. A instalação do gerenciador inclui o plug-in ruby-build.

Saiba mais sobre como usar o rbenv e o ruby-build para instalar versões diferentes do Ruby.

Linux

Recomendamos usar o rbenv para gerenciar as instalações do Ruby em distribuições do Linux. O rbenv gerencia várias instalações de versão do Ruby na sua máquina, e há um plug-in do rbenv denominado ruby-build que agrega compatibilidade ao rbenv para instalar uma versão específica do Ruby.

  1. Instale o rbenv na sua distribuição do Linux seguindo o arquivo rbenv readme.

  2. Instale o plug-in ruby-build para rbenv seguindo as instruções no arquivo ruby-build readme.

Saiba mais sobre como usar o rbenv e o ruby-build para instalar versões diferentes do Ruby.

Windows

Para o Windows, recomendamos uma das seguintes opções:

Instalar o Bundler

Bundler é uma gem do Ruby que gerencia as dependências de gem do projeto definidas em um arquivo denominado Gemfile. As amostras do Ruby na documentação do GCP usam arquivos Gemfile para especificar as gems e versões necessárias.

  1. Instale o Bundler.

    gem install bundler
    
  2. Instale as dependências de gem definidas no Gemfile.

    bundle install
    
  3. Execute o projeto do Ruby usando somente gems definidas no Gemfile.

    bundle exec ruby app.rb
    

Saiba mais sobre como criar um Gemfile na documentação do Bundler.

Instalar um editor

Os editores conhecidos usados para desenvolver aplicativos Ruby incluem, sem limitação nem ordem específica:

Esses editores, às vezes com a ajuda de plug-ins, oferecem tudo para maximizar a eficácia de desenvolvimento em Ruby, desde destaque de sintaxe, IntelliSense e preenchimento de código até recursos de depuração totalmente integrados.

Instalar o SDK do Cloud

O SDK do Cloud é um conjunto de ferramentas para o GCP. Ele contém gcloud, gsutil e bq, que podem ser usados para acessar o Compute Engine, o Cloud Storage, o BigQuery e outros produtos e serviços por meio da linha de comando. Execute essas ferramentas interativamente ou nos scripts automatizados.

Por exemplo, veja abaixo um comando simples que implanta um aplicativo da Web em Ruby no ambiente flexível do App Engine. Após a implantação, o App Engine tenta iniciar o aplicativo com bundle exec ruby app.rb -p 8080:

gcloud app deploy

Aprenda a implantar um aplicativo Ruby on Rails no ambiente flexível do App Engine.

Instalar a biblioteca de cliente do Cloud para Ruby

A biblioteca de cliente do Cloud para Ruby é a maneira idiomática para que os desenvolvedores de Ruby se integrem aos serviços do GCP. É possível instalar o pacote para uma API individual, como o Cloud Storage. Por exemplo:

gem install google-cloud-storage

Também é possível usar o Bundler e adicionar a gem às dependências do Gemfile. Por exemplo:

bundle add google-cloud-storage

Autenticação

Para usar a biblioteca de cliente do Cloud para Ruby, primeiro é necessário realizar uma autenticação. Complete as etapas em Primeiros passos na autenticação.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…