Il runtime Ruby consente di eseguire l'app in App Engine in un dell'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 l'ultima versione di Ruby, Ruby 3.3 (anteprima), 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 criterio entrypoint
definito in
app.yaml
. Il punto di ingresso deve avviare un processo
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 nell'elemento Gemfile
dell'applicazione
di configurazione del deployment. 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 ingresso 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 dal prefisso "region code~" ad esempio "e~" per le applicazioni distribuite in Europa. |
GAE_DEPLOYMENT_ID |
L'ID del deployment attuale. |
GAE_ENV |
L'ambiente App Engine. Impostata 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 richiesta, 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 viene eseguito il deployment del servizio. |
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 forwarding
App Engine termina le connessioni HTTPS al bilanciatore del carico
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
accessibile in scrittura, con tutte le altre directory
con accesso di sola lettura. La scrittura su /tmp
occupa memoria di sistema. Per ulteriori informazioni
informazioni, consulta TempDir
e TempFile
documentazione.
Server metadati
Ogni istanza dell'applicazione può utilizzare il server di metadati di App Engine per eseguire query sulle informazioni sull'istanza e sul 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 per i quali è possibile effettuare richieste HTTP metadati specifici:
Endpoint metadati | Descrizione |
---|---|
/computeMetadata/v1/project/numeric-project-id |
Il numero del progetto assegnato al tuo 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 tuo 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
.