Runtime di .NET

Panoramica

La tua funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo più pacchetti aggiuntivi, supporto linguistico e la libreria Functions Framework che supporta e richiama la tua funzione. Questo ambiente è identificato dalla versione della lingua ed è noto come runtime.

Per informazioni sui runtime in generale e per scoprire quale versione di Ubuntu utilizza ogni runtime .NET, consulta l'ambiente di esecuzione di Cloud Run Functions.

Pacchetto modello

Il pacchetto di modelli ti aiuta a creare nuove funzioni. Per utilizzarla:

  1. Installa l'SDK.NET.

  2. Installa il pacchetto di modelli:

    dotnet new install Google.Cloud.Functions.Templates

I modelli sono forniti per i tre tipi di funzioni in C# (il linguaggio predefinito), F# e Visual Basic. Quando crei un nuovo progetto da un modello, specifica -lang f# per creare un progetto F# o -lang vb per creare un progetto Visual Basic. Per saperne di più, vedi:

Seleziona una versione di .NET Functions Framework

Versioni diverse di .NET Functions Framework supportano runtime diversi. La versione 1 supporta .NET Core 3.1 e versioni successive, con modelli predefiniti per .NET Core 3.1. La versione 2 supporta .NET 6 e versioni successive, con i modelli impostati su .NET 6 per impostazione predefinita.

Per eseguire l'upgrade di un progetto esistente utilizzando .NET Functions Framework versione 1, modifica il file di progetto (o utilizza Visual Studio) per aggiornare tutte le dipendenze che iniziano con Google.Cloud.Functions all'ultima versione e imposta il framework di destinazione su .NET 6.

Seleziona il runtime

Cloud Run Functions supporta diverse versioni di .NET, elencate nella pagina Supporto del runtime. Quando esegui il deployment della funzione, devi specificare un runtime .NET corrispondente al framework di destinazione nel file di progetto (MyFunction.csproj o simile). Per specificare il runtime .NET:

Se utilizzi Google Cloud CLI, specifica il runtime utilizzando il parametro --runtime. Il flag --entry-point specifica il nome di classe completo (FQN). Ad esempio:

gcloud functions deploy NAME --no-gen2 --entry-point FQN --no-gen2 --runtime dotnet6 --trigger-http

Per altri parametri di deployment, vedi Esegui il deployment di una funzione Cloud Run.

Preparazione della funzione

Puoi scrivere una funzione sulla tua macchina locale e caricarla. Per preparare la macchina locale per lo sviluppo .NET, vedi Configurare un ambiente di sviluppo .NET.

La libreria che richiama la tua funzione è il framework di Functions.NET.

Struttura del codice sorgente

Affinché le funzioni Cloud Run trovino la definizione della tua funzione, ogni runtime ha determinati requisiti di strutturazione per il codice sorgente. Per saperne di più, consulta Scrivere funzioni Cloud Run.

Specifica delle dipendenze

Puoi specificare le dipendenze per la tua funzione aggiungendole a un file di progetto. Per saperne di più, consulta Specifica delle dipendenze in .NET.

Passaggi successivi