Creazione di un'app Ruby nell'ambiente standard di App Engine

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base all'area geografica selezionata al momento della creazione dell'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici paese e provincia di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL di App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Questa guida rapida mostra come eseguire il deployment di un'app di esempio in App Engine.

Costi

L'esecuzione di questa guida non prevede costi. L'esecuzione di questa applicazione di esempio da sola non supera la quota gratuita.

Questa guida rapida mostra come creare una piccola applicazione App Engine che visualizza un breve messaggio.

Prima di iniziare

  1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  4. Attiva Cloud Build API.

    Abilita l'API

  5. Installa Google Cloud CLI.

  6. Per initialize gcloud CLI, esegui questo comando: 

    gcloud init
    7.

  7. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  8. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  9. Attiva Cloud Build API.

    Abilita l'API

  10. Installa Google Cloud CLI.

  11. Per initialize gcloud CLI, esegui questo comando: 

    gcloud init
    12.

Prerequisiti aggiuntivi

  1. Inizializza la tua app App Engine con il tuo progetto e scegli la relativa area geografica:

    gcloud app create --project=[YOUR_PROJECT_ID]

    Quando richiesto, seleziona l'area geografica in cui vuoi trovare l'applicazione App Engine.

  2. Installa i seguenti prerequisiti:

Località App Engine

App Engine è a livello di regione, il che significa che l'infrastruttura che esegue le tue app si trova in una regione specifica e Google la gestisce in modo che sia disponibile in modo ridondante in tutte le zone all'interno di quella regione.

Soddisfare i requisiti di latenza, disponibilità o durabilità sono fattori principali per selezionare la regione in cui vengono eseguite le app. In genere, puoi selezionare l'area geografica più vicina agli utenti della tua app, ma devi prendere in considerazione le località in cui è disponibile App Engine e le località degli altri prodotti e servizi Google Cloud utilizzati dall'app. L'utilizzo di servizi in più località può influire sulla latenza dell'app e sui relativi pricing.

Non puoi modificare la regione di un'app dopo averla impostata.

Se hai già creato un'applicazione App Engine, puoi visualizzarne la regione in uno dei seguenti modi:

Questa guida rapida illustra una semplice app Ruby, scritta con il framework web Sinatra, di cui puoi eseguire il deployment in App Engine. Anche se in questo esempio viene utilizzato Sinatra, puoi utilizzare altri framework come Ruby on Rails.

scarica l'app Hello World

Abbiamo creato una semplice applicazione Hello World per App Engine in modo che tu possa comprendere rapidamente il deployment di un'app in Google Cloud.

  1. Clona il repository dell'app di esempio Hello World nella tua macchina locale.

    git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples

    In alternativa puoi scaricare l'esempio come file ZIP ed estrarlo.

  2. Passa alla directory che contiene il codice campione.

    cd ruby-docs-samples/appengine/hello_world

Esegui Hello World sulla tua macchina locale

In questo esempio viene utilizzato Bundler per eseguire l'app Hello World sul computer locale:

  1. Se non hai già installato il linguaggio di programmazione per il tuo runtime, scarica e installa Ruby.

    Scaricare e installare Ruby

  2. Installa Bundler:

    gem install bundler

  3. Installa le dipendenze per questo progetto:

    bundle install

  4. Avvia un server web locale.

    bundle exec ruby app.rb -p 8080

  5. Nel browser web, inserisci:

    http://localhost:8080

Nella pagina viene visualizzato il messaggio Hello World dell'app di esempio. Nella finestra del terminale, premi Ctrl+C per uscire dal server web.

Esegui il deployment di Hello World ed eseguilo su App Engine

Per eseguire il deployment dell'applicazione nell'ambiente standard di App Engine:

  1. Esegui il deployment dell'app Hello World eseguendo questo comando dalla directory hello_world: 

    gcloud app deploy

    Scopri di più sui flag facoltativi.

    Flag del comando gcloud comuni

    • Includi il flag --version per specificare un ID che identifichi in modo univoco la versione dell'app, altrimenti ne verrà generata una automaticamente. Esempio: --version [YOUR_VERSION_ID]
    • Includi il flag --project per specificare un ID progetto Google Cloud alternativo a quello che hai inizializzato come predefinito nello strumento gcloud. Esempio: --project [YOUR_PROJECT_ID]

    Esempio:

    gcloud app deploy --version pre-prod-5 --project my-sample-app

    Per scoprire di più sul deployment della tua app dalla riga di comando, consulta Test e deployment dell'app . Per un elenco di tutti i flag dei comandi, consulta il riferimento gcloud app deploy.

  2. Avvia il browser per visualizzare l'app all'indirizzo https://PROJECT_ID.REGION_ID.r.appspot.com 

    gcloud app browse
    dove PROJECT_ID rappresenta l'ID del tuo progetto Google Cloud.

Questa volta, la pagina che mostra il messaggio Hello World viene recapitata da un server web in esecuzione su un'istanza App Engine.

Complimenti! Hai eseguito il deployment della tua prima app App Engine nell'ambiente standard di App Engine.

Consulta le sezioni seguenti per informazioni sulla pulizia e per i link ai possibili passaggi successivi che puoi intraprendere.

Esegui la pulizia

Per evitare addebiti, puoi eliminare il tuo progetto Google Cloud per interrompere la fatturazione per tutte le risorse utilizzate all'interno di quel progetto.

  1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

  2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
  3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

Impara a conoscere l'intera piattaforma

Ora che sai come sviluppare ed eseguire il deployment delle app di App Engine, puoi esplorare il resto di Google Cloud. Hai già installato Google Cloud CLI, che ti offre gli strumenti per interagire con prodotti come Cloud SQL, Cloud Storage, Firestore e altri ancora.

Scopri di più sull'ambiente standard di App Engine

Ecco alcuni argomenti per aiutarti a continuare la tua conoscenza di App Engine: