Ruby Runtime Environment

Il runtime Ruby ti consente di eseguire l'app in App Engine in un ambiente sandbox. Questo documento spiega i dettagli delle proprietà dell'ambiente di runtime, incluse le intestazioni fornite al tuo codice e altre le informazioni necessarie per eseguire correttamente il deployment dell'applicazione su App Engine.

Specifica il runtime Ruby per App Engine nella nel dominio File app.yaml:

runtime: rubyVERSION

Dove VERSION indica i numeri di versione Ruby MAJOR e MINOR. Ad esempio, per utilizzare la versione più recente di Ruby, Ruby 3.3, specifica 33.

Per le altre versioni Ruby supportate e la versione Ubuntu corrispondente per il tuo Versione Ruby, consulta la pianificazione del supporto del runtime.

Versione Ruby

Il runtime Ruby utilizza l'ultima release stabile della versione specificato nel file app.yaml. App Engine automaticamente alle nuove versioni delle patch, ma non aggiornerà automaticamente una versione secondaria.

Ad esempio, il deployment della tua applicazione potrebbe essere eseguito su Ruby 2.6.0 aggiornato automaticamente alla versione 2.6.1 in un deployment successivo, ma verrà aggiornato automaticamente a Ruby 2.7.

Dipendenze

Per ulteriori informazioni sulla dichiarazione e la gestione delle dipendenze, consulta Specifica delle dipendenze.

Avvio dell'applicazione

Il runtime avvia l'applicazione utilizzando il entrypoint definito in app.yaml. Il punto di contatto 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 come Puma, Unicorn o Sottile.

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

source "https://rubygems.org"

gem "rack"
gem "puma"

Un esempio di punto di contatto che utilizza puma per un'applicazione Rails:

entrypoint: bundle exec rails server Puma -p $PORT

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

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

Per le applicazioni in grado di gestire le richieste senza un server rack, è sufficiente eseguire uno script ruby:

entrypoint: bundle exec ruby app.rb

Variabili di ambiente

Le seguenti variabili di ambiente sono impostate dal runtime:

Variabile di ambiente Descrizione
GAE_APPLICATION L'ID della tua applicazione App Engine. Questo ID è preceduto da "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. Impostato 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 di applicazione, in MB.
GAE_RUNTIME Il tempo di esecuzione specificato nel file app.yaml.
GAE_SERVICE Il nome del servizio specificato nel file app.yaml. Se non viene specificato alcun nome di servizio, viene impostato su default.
GAE_VERSION L'etichetta della versione corrente 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 disegnato.

Puoi definisci altre variabili di ambiente nel file app.yaml, ma non è possibile eseguire l'override dei valori precedenti, ad eccezione di NODE_ENV.

Proxy HTTPS e di inoltro

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 in l'intestazione X-Forwarded-For standard. Applicazioni che lo richiedono le informazioni devono configurare il framework web per considerare attendibile il proxy.

Filesystem

Il runtime include una directory /tmp scrivibile, con tutte le altre directory che hanno accesso di sola lettura. La scrittura in /tmp occupa memoria di sistema. Per maggiori informazioni informazioni, consulta TempDir e TempFile documentazione.

Server dei metadati

Ogni istanza dell'applicazione può utilizzare il server metadati di App Engine per eseguire query sulle informazioni sull'istanza e sul 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 inviare richieste HTTP per metadati specifici:

Endpoint dei metadati Descrizione
/computeMetadata/v1/project/numeric-project-id Il numero di progetto assegnato al progetto.
/computeMetadata/v1/project/project-id L'ID progetto assegnato al 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'indirizzo email dell'account di servizio predefinito assegnato al progetto.
/computeMetadata/v1/instance/service-accounts/default/ Elenca tutti gli account di servizio predefiniti per il progetto.
/computeMetadata/v1/instance/service-accounts/default/scopes Elenca tutti gli ambiti supportati per gli account di servizio 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.