Il runtime .NET

Nota: alcuni runtime.NET hanno raggiunto il termine del supporto. Non puoi eseguire nuovamente il deployment delle versioni che utilizzano i runtime dopo la data di fine del supporto. Ti consigliamo di eseguire l'upgrade della tua app per utilizzare la versione più recente di .NET.

Il runtime .NET è lo stack software responsabile dell'installazione del codice e delle dipendenze dell'applicazione, nonché dell'esecuzione dell'applicazione nell'ambiente flessibile.

Versioni .NET

.NET 8 viene creato utilizzando buildpacks. Per l'elenco completo delle versioni .NET supportate e della relativa versione di Ubuntu, consulta la pianificazione del supporto del runtime.

Per utilizzare una versione .NET supportata, devi:

• Aggiorna il file del progetto con la versione di .NET che vuoi utilizzare.

  <Project Sdk="Microsoft.NET.Sdk.Web">
  
    <PropertyGroup>
      <TargetFramework>net8.0</TargetFramework>
      <Nullable>enable</Nullable>
      <ImplicitUsings>enable</ImplicitUsings>
    </PropertyGroup>
  
    <ItemGroup>
      <None Update="app.yaml">
        <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
      </None>
    </ItemGroup>
  
  </Project>
  

  Per ulteriori informazioni, consulta Eseguire la migrazione da ASP.NET Core 3.1 a 6.0.

• Installa gcloud CLI versione 420.0.0 o successive. Puoi aggiornare gli strumenti CLI eseguendo il comando gcloud components update. Per visualizzare la versione installata, puoi eseguire il comando gcloud version.

• Specifica l'impostazione operating_system nel file app.yaml:

    runtime: aspnetcore
    env: flex
  
    runtime_config:
        operating_system: "ubuntu22"
  

• Se vuoi, puoi specificare una versione di runtime includendo l'impostazione runtime_version nel file app.yaml. Per impostazione predefinita, App Engine utilizza la versione .NET LTS più recente se l'impostazione runtime_version non è specificata. Ad esempio, il file app.yaml ha il seguente aspetto quando specifichi .NET 8 su Ubuntu 22:

    runtime: aspnetcore
    env: flex
  
    runtime_config:
        runtime_version: "8"
        operating_system: "ubuntu22"
  

Versioni precedenti dell'ambiente di runtime

Avviso: il supporto di .NET versione 3 e precedenti è terminato. App Engine ti impedisce di eseguire il deployment delle applicazioni che utilizzano runtime che hanno raggiunto il termine del supporto. Ti consigliamo di eseguire la migrazione dell'app in modo da utilizzare una versione supportata di .NET o un runtime personalizzato.

Per scegliere come target una versione specifica dell'SDK .NET, aggiorna il file del progetto. Per ulteriori informazioni, consulta Eseguire la migrazione da ASP.NET Core 3.1 a 6.0.

Se vuoi utilizzare GKE o altri host Docker, devi creare un Dockerfile che copi il codice dell'applicazione e installi le dipendenze. Per ulteriori informazioni, consulta Ambienti di runtime personalizzati.

Per eseguire il deployment dell'app .NET, esegui i comandi seguenti dalla directory radice in cui si trova l'app:

    dotnet restore
    dotnet publish -c Release
    gcloud app deploy

Supporto di altri runtime .NET

Se devi utilizzare una versione di .NET non supportata, puoi creare un runtime personalizzato e selezionare un'immagine di base valida con la versione di .NET di cui hai bisogno.

Per le immagini di base fornite da Google o per le immagini di base Docker .NET, consulta Creare runtime personalizzati.

Proxy HTTPS e di inoltro

App Engine termina la connessione HTTPS al bilanciatore del carico e inoltra la richiesta alla tua applicazione. Le applicazioni possono esaminare X-Forwarded-Proto per verificare se il protocollo originale era HTTP o HTTPS.

Alcune applicazioni devono anche accertarsi dell'indirizzo IP dell'utente. Questa opzione è disponibile nell'intestazione X-Forwarded-For standard.

Estensione del runtime

Il runtime .NET in un ambiente flessibile può essere utilizzato per creare un runtime personalizzato. I runtime personalizzati vengono configurati tramite un Dockerfile.

Puoi personalizzare Dockerfile e .dockerignore come preferisci. Infine, dovrai specificare runtime: custom anziché runtime: aspnetcore in app.yaml. Per ulteriori informazioni, consulta Personalizzazione del runtime .NET.

Variabili di ambiente

Le seguenti variabili di ambiente vengono impostate dall'ambiente di runtime:

Variabile di ambiente	Descrizione
GAE_INSTANCE	Il nome dell'istanza corrente.
GAE_MEMORY_MB	La quantità di memoria disponibile per la procedura di richiesta.
GAE_SERVICE	Il nome del servizio specificato nel file app.yaml dell'applicazione oppure, se non è specificato alcun nome del servizio, viene impostato su default.
GAE_VERSION	L'etichetta della versione dell'applicazione corrente.
GOOGLE_CLOUD_PROJECT	L'ID progetto associato alla tua applicazione, visibile nella console Google Cloud
PORT	La porta che riceverà le richieste HTTP.

Puoi impostare variabili di configurazione aggiuntive con appsettings.json.

Server dei metadati

Ogni istanza della tua applicazione può utilizzare il server metadati di Compute Engine per eseguire query sulle informazioni sull'istanza, tra cui il nome dell'host, l'indirizzo IP esterno, l'ID istanza, i metadati personalizzati e le informazioni sull'account di servizio. App Engine non ti consente di impostare metadati personalizzati per ogni istanza, ma puoi impostare metadati personalizzati a livello di progetto e leggerli dalle istanze App Engine e Compute Engine.

Questa funzione di esempio utilizza il server dei metadati per recuperare l'indirizzo IP esterno dell'istanza:

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Metadata-Flavor", new[] { "Google" });
response = await client.GetStringAsync(
    "http://metadata.google.internal/computeMetadata/v1/instance/network-interfaces/0/access-configs/0/external-ip");