Ambiente di runtime Go

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

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

runtime: goVERSION

dove VERSION è il numero di versione di Go MAJOR e MINOR. Ad esempio, per utilizzare la versione più recente di Go, Go 1.23 (anteprima), specifica 123.

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

Il runtime Go utilizza la release stabile più recente della versione specificata nel file app.yaml. App Engine si aggiorna automaticamente alle nuove revisioni delle patch, ma non aggiorna automaticamente la versione principale.

Ad esempio, l'applicazione potrebbe essere dipiattaforma nella versione secondaria Go 1.13.1 e aggiornata automaticamente alla versione 1.13.2 in un successivo dipiattaforma, ma non verrà aggiornata automaticamente alla versione principale Go 1.14.

Dipendenze

Per ulteriori informazioni su come dichiarare e gestire le dipendenze, consulta Specificare le 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 è 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 runtime 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 di Node.js) Imposta su production quando il servizio viene disegnato.

Puoi definire variabili di ambiente aggiuntive nel file app.yaml, ma i valori sopra indicati non possono essere sostituiti, tranne per 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 nell'intestazione X-Forwarded-For standard. Le applicazioni che richiedono queste informazioni devono configurare il proprio framework web in modo che attenda 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 ulteriori informazioni, consulta la documentazione di TempDir e TempFile.

Server dei metadati

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

Puoi accedere al server dei 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 i service account predefiniti.
/computeMetadata/v1/instance/service-accounts/default/token Restituisce il token di autenticazione che può essere utilizzato per autenticare la tua applicazione ad altre API Google Cloud.

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