Como configurar um ambiente de desenvolvimento do Ruby

Neste tutorial, mostramos como preparar sua máquina local para desenvolvimento em Ruby, incluindo como desenvolver aplicativos Ruby que são executados no Google Cloud. Siga este tutorial para instalar o Ruby e as ferramentas relevantes.

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

Objetivos

  • Instalar o Ruby.
  • Instalar o Bundler.
  • Instalar um editor (opcional).
  • Instale a CLI do Google Cloud.
  • Instale as bibliotecas 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 o uso de rbenv para gerenciar suas instalações do Ruby no macOS. rbenv gerencia várias instalações da versão do Ruby na máquina e um plug-in rbenv chamado ruby-build adiciona suporte a rbenv para instalar uma versão especificada 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 do homebrew.

  4. Instale rbenv usando homebrew, seguindo as instruções no readme do rbenv. A instalação do homebrew 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 o uso de rbenv para gerenciar suas instalações do Ruby em distribuições do Linux. O rbenv gerencia várias instalações da versão do Ruby na sua máquina e um plug-in do rbenv chamado ruby-build adiciona compatibilidade com rbenv para instalar um versão especificada do Ruby.

  1. Instale rbenv na distribuição do Linux usando o readme do rbenv.

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

Saiba mais sobre como usar rbenv e ruby-build para instalar diferentes versões 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 Google Cloud usam arquivos Gemfile para especificar as gems e versões necessárias.

  1. Instale o Bundler.

    gem install bundler

  2. Instale as dependências 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 lendo a documentação do Bundle.

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.

Instale a CLI gcloud

A CLI do gcloud é um conjunto de ferramentas para o Google Cloud. 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 a partir da linha de comando de dados. 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 os desenvolvedores do Ruby se integrarem aos serviços do Google Cloud. É 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