Ambiente di runtime Go

Il runtime di Go è lo stack software responsabile dell'installazione il codice e le sue dipendenze ed eseguire il servizio.

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

runtime: goVERSION

Dove VERSION indica i numeri di versione di Go MAJOR e MINOR. Per Ad esempio, per utilizzare l'ultima versione di Go, Go 1.22, specifica 122.

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

Versione Go

Il runtime Go utilizza l'ultima release stabile della versione è specificato nel file app.yaml. App Engine si aggiorna automaticamente nuove revisioni delle patch, ma non aggiornerà automaticamente la versione principale.

Ad esempio, è possibile che il deployment dell'applicazione sia stato eseguito nella versione secondaria Go 1.13.1 e l'aggiornamento automatico alla versione 1.13.2 in un deployment successivo, non verrà aggiornato 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 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.