Configurazione di un ambiente di sviluppo Ruby

Questo tutorial mostra come preparare la macchina locale per lo sviluppo con Ruby, incluso lo sviluppo di app Ruby eseguite su Google Cloud. Segui questo tutorial per installare Ruby e gli strumenti pertinenti.

Leggi la guida rapida per Ruby Google Cloud per avere una panoramica di Ruby e scoprire i modi per eseguire le app Ruby su Google Cloud.

Obiettivi

  • Installa Ruby.
  • Installa Bundler.
  • Installa un editor (facoltativo).
  • Installa Google Cloud CLI.
  • Installa le librerie client di Cloud per Ruby.
  • Configurare l'autenticazione.

Installare Ruby

Le istruzioni di installazione di Ruby variano in base al sistema operativo. Segui la guida per il sistema operativo che utilizzi sulla tua macchina di sviluppo locale. Questo tutorial si applica alle versioni di Ruby stabili e non alla fine del ciclo di vita (EOL) elencate su Ruby-lang.

macOS

Ti consigliamo di utilizzare rbenv per gestire le installazioni di Ruby su macOS. rbenv gestisce più installazioni di versioni di Ruby sulla tua macchina e un plug-in rbenv denominato ruby-build aggiunge il supporto a rbenv per installare una versione specifica di Ruby.

Sebbene macOS includa una versione di Ruby per impostazione predefinita, è consigliabile eseguire un'installazione separata delle ultime versioni di Ruby per rimanere aggiornato ed evitare conflitti con l'utilizzo della versione predefinita del sistema operativo.

  1. Installa XCode.

  2. Installa gli strumenti a riga di comando di XCode utilizzando il seguente comando in un terminale:

    xcode-select --install

  3. Installa homebrew seguendo le istruzioni riportate nella home page di Homebrew.

  4. Installa rbenv utilizzando homebrew, seguendo le istruzioni riportate nel file Readme di rbenv. L'installazione di Homebrew include il plug-in ruby-build.

Scopri di più su come utilizzare rbenv e ruby-build per installare diverse versioni di Ruby.

Linux

Ti consigliamo di utilizzare rbenv per gestire le installazioni di Ruby sulle distribuzioni Linux. rbenv gestisce più installazioni di versioni di Ruby sulla tua macchina e un plug-in rbenv denominato ruby-build aggiunge il supporto a rbenv per installare una versione specificata di Ruby.

  1. Installa rbenv sulla tua distribuzione Linux utilizzando il rbenv readme.

  2. Installa il plug-in ruby-build per rbenv seguendo le istruzioni riportate nel ruby-build readme.

Scopri di più sull'utilizzo di rbenv e ruby-build per installare diverse versioni di Ruby.

Windows

Per Windows, consigliamo una delle seguenti opzioni:

Installa Bundler

Bundler è una gem Ruby che gestisce le dipendenze delle gem del progetto definite in un file denominato Gemfile. Gli esempi Ruby nella documentazione di Google Cloudutilizzano i file Gemfile per specificare le gem e le versioni richieste.

  1. Installa Bundler.

    gem install bundler

  2. Installa le dipendenze di gem definite in Gemfile.

    bundle install

  3. Esegui il tuo progetto Ruby utilizzando solo le gemme definite nel tuo Gemfile.

    bundle exec ruby app.rb

Scopri di più sulla creazione di un Gemfile leggendo la documentazione di Bundler.

Installa un editor

Gli editor più utilizzati (senza un ordine particolare) per sviluppare app Ruby includono, a titolo esemplificativo:

Questi editor (a volte con l'aiuto di plug-in) offrono tutto, dall'evidenziazione della sintassi, all'IntelliSense e al completamento del codice, fino a funzionalità di debug completamente integrate, massimizzando l'efficacia dello sviluppo in Ruby.

Installa gcloud CLI

gcloud CLI è un insieme di strumenti per Google Cloud. Contiene gcloud e bq, che puoi utilizzare per accedere a Compute Engine, Cloud Storage, BigQuery e altri prodotti e servizi dalla riga di comando. Puoi eseguire questi strumenti in modo interattivo o nei tuoi script automatizzati.

Ad esempio, ecco un semplice comando che esegue il deployment di un'app web Ruby nell'ambiente flessibile di App Engine. Dopo il deployment, App Engine tenta di avviare l'app con bundle exec ruby app.rb -p 8080:

gcloud app deploy

Scopri come eseguire il deployment di un'app Ruby on Rails nell'ambiente flessibile di App Engine.

Installa la libreria client di Cloud per Ruby

La libreria client di Cloud per Ruby è il modo idiomatico per gli sviluppatori Ruby di integrarsi con i servizi Google Cloud. Puoi installare il pacchetto per una singola API, ad esempio Cloud Storage:

gem install google-cloud-storage

Puoi anche utilizzare Bundler e aggiungere la gemma alle dipendenze Gemfile, ad esempio:

bundle add google-cloud-storage

Configura l'autenticazione

Per utilizzare le librerie client di Cloud in un ambiente di sviluppo locale, configura Credenziali predefinite dell'applicazione.

Se utilizzi una shell locale, crea credenziali di autenticazione locali per il tuo account utente: 

gcloud auth application-default login

Non è necessario eseguire questa operazione se utilizzi Cloud Shell.

Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per l'utilizzo delle librerie client.

Passaggi successivi