Ruby Runtime Environment

Il runtime Ruby ti consente di eseguire la tua app in App Engine in un ambiente sandbox. Questo documento spiega i dettagli dell'ambiente di runtime Ruby, inclusi gli header forniti al codice e altre informazioni per eseguire il deployment dell'applicazione su App Engine.

Specifica il runtime Ruby per App Engine nell'ambiente standard nel file app.yaml:

runtime: rubyVERSION

dove VERSION sono i numeri di versione di Ruby MAJOR e MINOR. Ad esempio, per utilizzare l'ultima versione di Ruby, Ruby 4.0, specifica 40.

Per altre versioni di Ruby supportate e la versione di Ubuntu corrispondente alla tua versione di Ruby, consulta la pianificazione del supporto di runtime.

Versione di Ruby

L'ultima versione di Ruby supportata è la 4.0. Il runtime Ruby utilizza l'ultima release stabile della versione specificata nel file app.yaml. App Engine esegue automaticamente l'aggiornamento alle nuove versioni delle patch, ma non aggiorna automaticamente la versione secondaria.

Ad esempio, la tua applicazione potrebbe essere implementata in Ruby 2.6.0 e aggiornata automaticamente alla versione 2.6.1 in un'implementazione successiva, ma non verrà aggiornata automaticamente a Ruby 2.7.

Dipendenze

Per saperne di più sulla dichiarazione e sulla gestione delle dipendenze, consulta Specifica delle dipendenze.

Avvio dell'applicazione

Il runtime avvia l'applicazione utilizzando entrypoint definito in app.yaml. Il punto di ingresso deve avviare un processo che risponde alle richieste HTTP sulla porta definita dalla variabile di ambiente PORT. Ad esempio:

entrypoint: bundle exec rails server -p $PORT

La maggior parte delle applicazioni web utilizza un server web supportato da Rack, ad esempio Puma, Unicorn o Thin.

Devi aggiungere il server come dipendenza nel file di configurazione Gemfile della tua applicazione. Il runtime installerà tutte le dipendenze prima che venga chiamato il punto di ingresso.

source "https://rubygems.org"

gem "rack"
gem "puma"

Un punto di ingresso di esempio che utilizza Puma per un'applicazione Rails:

entrypoint: bundle exec rails server Puma -p $PORT

Un punto di ingresso di esempio che utilizza Puma per qualsiasi applicazione Rack:

entrypoint: bundle exec rackup -s Puma -p $PORT

Per le applicazioni che possono gestire le richieste senza un server Rack, puoi semplicemente eseguire uno script Ruby:

entrypoint: bundle exec ruby app.rb

Variabili di ambiente

Le seguenti variabili di ambiente vengono impostate dal runtime:

Variabile di ambiente Descrizione
GAE_APPLICATION L'ID della tua applicazione App Engine. Questo ID ha il prefisso "region code~", ad esempio "e~" per le applicazioni di cui è stato eseguito il deployment in Europa.
GAE_DEPLOYMENT_ID L'ID del deployment corrente.
GAE_ENV L'ambiente App Engine. Imposta su standard.
GAE_INSTANCE L'ID dell'istanza su cui è attualmente in esecuzione il servizio.
GAE_MEMORY_MB La quantità di memoria disponibile per il processo dell'applicazione, in MB.
GAE_RUNTIME Il runtime specificato nel file app.yaml.
GAE_SERVICE Il nome del servizio specificato nel file app.yaml. Se non viene specificato alcun nome del servizio, viene impostato su default.
GAE_VERSION L'etichetta della versione attuale del servizio.
GOOGLE_CLOUD_PROJECT L'ID progetto Google Cloud associato alla tua applicazione.
PORT La porta che riceve le richieste HTTP.
NODE_ENV (disponibile solo nel runtime Node.js) Imposta su production quando il servizio viene implementato.

Puoi definire variabili di ambiente aggiuntive nel file app.yaml, ma i valori sopra indicati non possono essere sostituiti, ad eccezione di NODE_ENV.

Proxy HTTPS e di forwarding

App Engine termina le connessioni HTTPS al bilanciatore del carico e inoltra le richieste alla tua applicazione. Alcune applicazioni devono determinare l'IP e il protocollo della richiesta originale. L'indirizzo IP dell'utente è disponibile nell'intestazione standard X-Forwarded-For. Le applicazioni che richiedono queste informazioni devono configurare il framework web in modo che consideri attendibile il proxy.

Filesystem

Il runtime include una directory /tmp scrivibile, mentre tutte le altre directory hanno accesso in sola lettura. La scrittura su /tmp occupa la memoria di sistema. Per saperne di più, consulta la documentazione relativa a TempDir e TempFile.

Server di metadati

Ogni istanza della tua applicazione può utilizzare il server metadati di App Engine per eseguire query sulle informazioni relative all'istanza e al tuo progetto.

Puoi accedere al server di metadati tramite i seguenti endpoint:

  • http://metadata
  • http://metadata.google.internal

Le richieste inviate al server dei metadati devono includere l'intestazione della richiesta Metadata-Flavor: Google. Questa intestazione indica che la richiesta è stata inviata con l'intenzione di recuperare i valori dei metadati.

La tabella seguente elenca gli endpoint in cui puoi effettuare richieste HTTP per metadati specifici:

Endpoint dei metadati Descrizione
/computeMetadata/v1/project/numeric-project-id Il numero di progetto assegnato al tuo progetto.
/computeMetadata/v1/project/project-id L'ID progetto assegnato al tuo progetto.
/computeMetadata/v1/instance/region La regione in cui è in esecuzione l'istanza.
/computeMetadata/v1/instance/service-accounts/default/aliases
/computeMetadata/v1/instance/service-accounts/default/email L'email del account di servizio predefinito assegnato al tuo progetto.
/computeMetadata/v1/instance/service-accounts/default/ Elenca tutti i service account predefiniti per il tuo progetto.
/computeMetadata/v1/instance/service-accounts/default/scopes Elenca tutti gli ambiti supportati per i service account predefiniti.
/computeMetadata/v1/instance/service-accounts/default/token Restituisce il token di autenticazione che può essere utilizzato per autenticare l'applicazione in altre API Google Cloud.

Ad esempio, per recuperare l'ID progetto, invia una richiesta a http://metadata.google.internal/computeMetadata/v1/project/project-id.