Ambiente di runtime Go

Il runtime di Go è lo stack software che installa il codice del servizio web e le relative dipendenze ed esegue il servizio.

Il runtime di Go per App Engine nell'ambiente standard è dichiarato nel app.yaml file:

runtime: goVERSION

Dove VERSION sono i numeri di versione MAJOR e MINOR di Go. Ad esempio, per utilizzare l'ultima versione di Go, Go 1.27 (anteprima), specifica 127.

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

Versione di Go

L'ultima versione di Go supportata è la 1.27 (anteprima). Il runtime di Go utilizza l'ultima release stabile della versione specificata nel file app.yaml. App Engine esegue automaticamente l'aggiornamento alle nuove revisioni delle patch, ma non esegue automaticamente l'aggiornamento della versione principale.

Ad esempio, la tua applicazione potrebbe essere sottoposta a deployment nella versione secondaria Go 1.13.1 e aggiornata automaticamente alla versione 1.13.2 in un deployment successivo, ma non verrà aggiornata automaticamente alla versione principale Go 1.14.

Dipendenze

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

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 sottoposte a 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 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 corrente del servizio.
GOOGLE_CLOUD_PROJECT L'ID Google Cloud progetto associato alla tua applicazione.
PORT La porta che riceve le richieste HTTP.
NODE_ENV (disponibile solo nel runtime di Node.js) Impostato su production quando il servizio viene sottoposto a deployment.

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

Proxy HTTPS e di forwarding

App Engine termina le connessioni HTTPS nel 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 in /tmp occupa la memoria di sistema. Per saperne di più, consulta la documentazione di TempDir e TempFile.

Server di metadati

Ogni istanza della tua applicazione può utilizzare il server di 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 di 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'indirizzo 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.