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 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.
  • (Facoltativo) Installa un editor.
  • 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 della versione 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 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 da riga di comando di Xcode utilizzando questo 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 della versione 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.

  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-buildfile Leggimi.

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

Windows

Per Windows, ti consigliamo una delle seguenti opzioni:

Installare Bundler

Bundler è una gemma Ruby che gestisce le dipendenze delle gemme del progetto definite in un file denominato Gemfile. Gli esempi 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 di gem definite in Gemfile.

    bundle install
    
  3. Esegui il tuo progetto Ruby utilizzando solo i gem definiti in Gemfile.

    bundle exec ruby app.rb
    

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

Installare 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 di tutto, dall'evidenziazione della sintassi, all'intelligenza artificiale e al completamento del codice, fino a funzionalità di debug completamente integrate, massimizzando l'efficacia dello sviluppo Ruby.

Installa gcloud CLI

gcloud CLI è un insieme di strumenti per Google Cloud. Include gcloud e bq, utili per accedere dalla riga di comando a Compute Engine, Cloud Storage, BigQuery e altri prodotti e servizi. 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 il gem 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 le Credenziali predefinite dell'applicazione.

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.

Per saperne di più, consulta Autenticati per usare le librerie client.

Passaggi successivi