Questo tutorial mostra come preparare la tua macchina locale per lo sviluppo di Ruby, compreso lo sviluppo di app Ruby eseguite su Google Cloud. Segui questo tutorial per installare Ruby e strumenti pertinenti.
Leggi la Guida rapida per Ruby e Google Cloud per avere una panoramica di Ruby e scoprire come eseguire le app Ruby su Google Cloud.
Obiettivi
- Installa Ruby.
- Installa Bundler.
- (Facoltativo) Installa un editor.
- Installa l'interfaccia a riga di comando di Google Cloud.
- Installa le librerie client di Cloud per Ruby.
Installa Ruby
Le istruzioni di installazione di Ruby variano in base al sistema operativo. Segui la guida relativa al sistema operativo che utilizzi sulla macchina di sviluppo locale. Questo tutorial si applica alle versioni Ruby stabili e non di fine vita (EOL) elencate su Ruby-lang.
macOS
Consigliamo di utilizzare
rbenv
per gestire le installazioni Ruby su macOS. rbenv
gestisce più installazioni di versioni Ruby sulla tua macchina e un plug-in rbenv denominato ruby-build
aggiunge il supporto di 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 aggiornata ed evitare conflitti con l'uso della versione predefinita del sistema operativo.
- Installa XCode.
Installa gli strumenti a riga di comando di XCode utilizzando il seguente comando in un terminale:
xcode-select --install
Installa
homebrew
seguendo le istruzioni riportate nella home page del birrificio.Installa
rbenv
utilizzandohomebrew
, seguendo le istruzioni riportate nel legno rbenv. L'installazione di homebrew include il plug-inruby-build
.
Scopri di più sull'utilizzo di rbenv e ruby-build
per installare versioni diverse di Ruby.
Linux
Consigliamo di utilizzare
rbenv
per gestire le installazioni Ruby sulle distribuzioni Linux. rbenv
gestisce più installazioni di versioni di Ruby sul tuo computer e un plug-in rbenv
denominato ruby-build
aggiunge il supporto di rbenv
per installare una versione specificata di Ruby.
Installa
rbenv
sulla tua distribuzione Linux utilizzandorbenv
readme.Installa il plug-in
ruby-build
perrbenv
utilizzando le istruzioni fornite nel legge diruby-build
.
Scopri di più sull'utilizzo di rbenv
e su ruby-build
per installare versioni diverse di Ruby.
Windows
Per Windows, consigliamo uno dei seguenti sistemi operativi:
Installa bundler
Bundler è una gemma Ruby che gestisce le dipendenze delle gemme del progetto definite in un file denominato Gemfile
. Gli esempi di Ruby nella documentazione di Google Cloud utilizzano file Gemfile
per specificare gemme e versioni richieste.
Installa Bundler.
gem install bundler
Installa le dipendenze
gem
definite nellaGemfile
.bundle install
Esegui il tuo progetto Ruby solo utilizzando le gemme definite nel tuo
Gemfile
.bundle exec ruby app.rb
Scopri di più sulla creazione di un Gemfile
con la
documentazione del bundle.
Installa un editor
Gli editor popolari (in ordine particolare) utilizzati per sviluppare le app Ruby includono, a titolo esemplificativo:
- Sublime Text di Jon Skinner
- Atom di GitHub
- RubyMine di JetBrains
- Vim di Vim Editor
Questi editor (a volte con l'aiuto dei plug-in) ti offrono tutto, da evidenziazione di sintassi, intelligence e completamento del codice a funzionalità di debug completamente integrate, massimizzando l'efficacia dello sviluppo Ruby.
Installa l'interfaccia a riga di comando gcloud
L'interfaccia a riga di comando gcloud
è un insieme di strumenti per Google Cloud. Contiene gcloud
, gsutil
e bq
, che puoi utilizzare per accedere a Compute Engine, Cloud Storage, BigQuery e ad altri prodotti e servizi dalla riga di comando. Puoi eseguire questi strumenti in modo interattivo o nei tuoi script automatizzati.
Ad esempio, questo è 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.
Installare la libreria client Cloud per Ruby
La Cloud Client Library per Ruby è il modo idiomatico per integrare gli sviluppatori Ruby con i servizi Google Cloud. Puoi installare il pacchetto per una singola API, ad esempio Cloud Storage, ad esempio:
gem install google-cloud-storage
Puoi anche utilizzare Bundler e aggiungere la gemma alle dipendenze di Gemfile
, ad esempio:
bundle add google-cloud-storage
Autenticazione
Per utilizzare la libreria client Cloud per Ruby, devi prima autenticarti. Completa i passaggi della guida introduttiva all'autenticazione.