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 e Google Cloud per avere una panoramica di Ruby e scoprire come eseguire 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.

Installa 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 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 specificata di Ruby.

Sebbene macOS includa una versione di Ruby per impostazione predefinita, è meglio eseguire un'installazione separata delle ultime versioni di Ruby per rimanere al passo con gli aggiornamenti ed evitare conflitti con l'utilizzo della versione predefinita da parte 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 nel file README di rbenv. L'installazione di Homebrew include il plug-in ruby-build.

Scopri di più sull'utilizzo di rbenv e ruby-build per installare versioni diverse 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 file README di rbenv.

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

Scopri di più sull'utilizzo di rbenv e ruby-build per installare versioni diverse 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 di Ruby nella documentazione di Google Cloudutilizzano i file Gemfile per specificare le gemme e le versioni richieste.

  1. Installa Bundler.

    gem install bundler

  2. Installa le dipendenze 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ù diffusi (in nessun ordine particolare) utilizzati 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 di 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 le Credenziali predefinite dell'applicazione.

Crea credenziali di autenticazione locali per il tuo account utente: 

gcloud auth application-default login

Se viene restituito un errore di autenticazione, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.

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

(Facoltativo) Osservabilità

Google Cloud Observability include servizi di osservabilità che ti aiutano a comprendere il comportamento, l'integrità e le prestazioni delle tue applicazioni Ruby. Per saperne di più, consulta Google Cloud Observability per Ruby.

Passaggi successivi