Configurazione di un ambiente di sviluppo Ruby

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

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

Obiettivi

  • Installa Ruby.
  • Installa Bundler.
  • Installa un editor (facoltativo).
  • Installa Google Cloud CLI.
  • Installa le librerie client Cloud per Ruby.
  • Configura 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 macchina di sviluppo locale. Questo tutorial si applica alle versioni Ruby stabili e non in fase di fine 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 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, è preferibile eseguire un'installazione separata delle versioni più recenti 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ù 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 macchina e un plug-in rbenv denominato ruby-build aggiunge il supporto a rbenv per installare una versione specifica di Ruby.

  1. Installa rbenv sulla tua distribuzione Linux utilizzando il rbenv file README.

  2. Installa il plug-in ruby-build per rbenv utilizzando le istruzioni riportate nel ruby-build file README.

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

Windows

Per Windows, ti consigliamo una delle seguenti opzioni:

Installa Bundler

Bundler è un gem Ruby che gestisce le dipendenze dei gem del progetto definite in un file denominato Gemfile. Gli esempi Ruby nella documentazione di Google Cloud's utilizzano i file Gemfile per specificare i gem e le versioni richieste.

  1. Installa Bundler.

    gem install bundler

  2. Installa le dipendenze gem definite in Gemfile.

    bundle install

  3. Esegui il progetto Ruby solo utilizzando i gem definiti in 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 (senza un ordine particolare) utilizzati per sviluppare app Ruby includono, a titolo esemplificativo:

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

Installa gcloud CLI

La 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 Cloud per Ruby

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

gem install google-cloud-storage

Puoi anche utilizzare Bundler e aggiungere il gem alle dipendenze Gemfile, ad esempio:

bundle add google-cloud-storage

Configura l'autenticazione

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

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

gcloud auth application-default login

Non devi 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ù, vedi Autenticazione per l'utilizzo delle librerie client.

Passaggi successivi