Runtime di .NET

Panoramica

La funzione Cloud Functions viene eseguita in un ambiente costituito da una versione del sistema operativo più pacchetti aggiuntivi, supporto delle lingue e la libreria del framework di Functions che supporta e richiama la tua funzione. Questo ambiente è identificato dalla versione del linguaggio ed è noto come runtime.

Per informazioni sui runtime in generale e per sapere quale versione di Ubuntu viene utilizzata da ciascun runtime .NET, vedi l'ambiente di esecuzione di Cloud Functions.

Per iniziare a utilizzare .NET su Cloud Functions, consulta la guida rapida.

Pacchetto di modelli

Il pacchetto modello consente di creare nuove funzioni. Per utilizzarla:

  1. Installa l'SDK.NET.

  2. Installa il pacchetto del modello:

    dotnet new install Google.Cloud.Functions.Templates

I modelli vengono forniti per i tre tipi di funzioni in C# (valore 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 ulteriori informazioni, vedi:

Seleziona una versione di .NET Functions Framework

Versioni diverse di .NET Functions Framework supportano runtime differenti. La versione 1 supporta .NET Core 3.1 e versioni successive, con i modelli predefiniti a .NET Core 3.1. La versione 2 supporta .NET 6 e versioni successive, con i modelli predefiniti a .NET 6.

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

Seleziona il runtime

Cloud Functions supporta diverse versioni di .NET, elencate nella pagina Supporto 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:

gcloud

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

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

Per ulteriori parametri di deployment, consulta Eseguire il deployment utilizzando Google Cloud CLI.

Console

Se utilizzi la console Google Cloud, consulta la guida rapida della console Google Cloud per istruzioni dettagliate.

Preparazione delle funzioni

Puoi preparare una funzione direttamente dalla console Google Cloud o scriverla sulla tua macchina locale e caricarla. Per preparare la macchina locale allo sviluppo di .NET, consulta Configurazione di un ambiente di sviluppo .NET.

La libreria che richiama la tua funzione è .NET Functions Framework.

Per iniziare rapidamente a utilizzare .NET su Cloud Functions, consulta la guida rapida.

Struttura del codice sorgente

Per consentire a Cloud Functions di trovare la definizione della tua funzione, ogni runtime ha determinati requisiti di strutturazione per il codice sorgente. Per ulteriori informazioni, consulta Scrittura di funzioni Cloud Functions.

Specifica delle dipendenze

Puoi specificare le dipendenze per la funzione aggiungendole a un file di progetto. Per ulteriori informazioni, consulta Specifica delle dipendenze in .NET.

Passaggi successivi