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 apps 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 para Ruby e Google Cloud para ter uma visão geral do Ruby e aprender a executar apps 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.
  • Configure a autenticação.

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ê está usando na sua máquina de desenvolvimento local. 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 suas instalações do Ruby no macOS. O rbenv gerencia várias instalações de versões do Ruby na sua máquina, e um plug-in do rbenv chamado ruby-build adiciona suporte ao 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 diferentes versões do Ruby.

Linux

Recomendamos usar rbenv para gerenciar suas instalações do Ruby em distribuições Linux. O rbenv gerencia várias instalações de versões do Ruby na sua máquina, e um plug-in do rbenv chamado ruby-build adiciona suporte ao rbenv para instalar uma 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

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

  1. Instalar 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.

Instalar a CLI gcloud

A CLI gcloud é um conjunto de ferramentas para Google Cloud. Ele contém gcloud e bq, que podem ser usados para acessar o Compute Engine, o Cloud Storage, o BigQuery e outros produtos e serviços na linha de comando. Essas ferramentas podem ser executadas de maneira interativa ou nos scripts automatizados.

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

gcloud app deploy

Saiba como 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 de os desenvolvedores Ruby se integrarem aos serviços 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

Configurar a autenticação

Para usar as bibliotecas de cliente do Cloud em um ambiente de desenvolvimento local, configure o Application Default Credentials.

Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário: 

gcloud auth application-default login

Não é necessário fazer isso se você estiver usando o Cloud Shell.

Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

Para mais informações, consulte Autenticar para usar bibliotecas de cliente.

A seguir