Ambiente di runtime Go

Il runtime Go è lo stack software responsabile dell'installazione del codice del servizio web e delle relative dipendenze e dell'esecuzione del servizio.

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

runtime: goVERSION

dove VERSION sono i numeri di versione di Go MAJOR e MINOR. Ad esempio, per utilizzare l'ultima versione di Go, Go 1.25, specifica 125.

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

Versione di Go

L'ultima versione di Go supportata è la 1.25. Il runtime 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 aggiorna automaticamente la versione principale.

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

Dipendenze

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

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 con altre API Google Cloud.

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