Runtime di .NET

Panoramica

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

Cloud Functions supporta i seguenti runtime .NET:

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

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

Pacchetto di modelli

Il pacchetto del modello ti aiuta a creare nuove funzioni. Per utilizzarla:

  1. Installa l'SDK.NET.

  2. Installa il pacchetto del modello:

    dotnet new install Google.Cloud.Functions.Templates

Sono disponibili modelli per i tre tipi di funzioni in C# (impostazione predefinita), 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 del framework .NET Functions

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

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

Seleziona il runtime

Devi specificare un runtime .NET per eseguire la funzione quando ne esegui il deployment. Questo runtime deve corrispondere al framework di destinazione nel file di progetto (MyFunction.csproj o simile). Per specificare il tuo runtime .NET:

gcloud

Se utilizzi Google Cloud CLI, specifica il runtime usando 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 altri parametri di deployment, consulta Deployment utilizzando lo strumento gcloud.

Console

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

Preparazione di funzioni

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

La libreria che richiama la tua funzione è il framework delle funzioni.NET.

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

Struttura del codice sorgente

Per fare in modo che Cloud Functions trovi la definizione della tua funzione, ogni runtime deve avere determinati requisiti di strutturazione per il codice sorgente. Per ulteriori informazioni, consulta la sezione Scrivere funzioni Cloud Functions.

Specifica delle dipendenze

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

Passaggi successivi