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.
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ê 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. O 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.

Instale o XCode.
Instale as ferramentas de linha de comando do XCode usando o seguinte comando em um terminal:
```
xcode-select --install
```
Instale o homebrew seguindo as instruções na página inicial do homebrew.
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.

Instale rbenv na distribuição do Linux usando o readme do rbenv.
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.

Instalar o Bundler.
```
gem install bundler
```
Instale as dependências gem definidas no Gemfile.
```
bundle install
```
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:

Sublime Text, de Jon Skinner
Atom da GitHub
RubyMine da JetBrains
Vim do editor Vim

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 pela linha de comando. Essas ferramentas podem ser executadas de maneira interativa 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 de 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

Configurar a autenticação

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

If you're using a local shell, then create local authentication credentials for your user account:

gcloud auth application-default login

You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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

A seguir

Consulte a documentação para produtos Google Cloud .
Saiba como implantar o Ruby on Rails no ambiente flexível do Google App Engine.
Clone o repositório de amostras do Ruby do GitHub.
Explore os tutoriais do Ruby enviados pela comunidade.

Como configurar um ambiente de desenvolvimento do Ruby Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.