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:
- .NET Core 6.0 (consigliato)
- .NET Core 3.1 (solo utilizzando Functions Framework v1)
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:
Installa l'SDK.NET.
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:
- La tua prima funzione: C#
- Lingue.NET (per F# e Visual Basic)
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
- Crea la tua prima funzione C# da zero.
- Scopri gli altri linguaggi .NET che puoi utilizzare per scrivere Cloud Functions: F# e Visual Basic.