Runtime di .NET
Panoramica
La funzione Cloud Functions viene eseguita in un ambiente costituito da una versione del sistema operativo più pacchetti di componenti aggiuntivi, supporto del linguaggio e la libreria di Functions Framework che supporta e richiama la tua funzione. Questo ambiente è identificato dalla versione in lingua ed è noto come runtime.
Per informazioni sui runtime in generale e per sapere quale versione di Ubuntu viene utilizzata da ciascun 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 di modelli consente di creare nuove funzioni. Per utilizzarla:
Installa .NET SDK.
Installa il pacchetto di modelli:
dotnet new install Google.Cloud.Functions.Templates
Vengono forniti modelli per i tre tipi di funzioni in C# (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, consulta:
- La tua prima funzione: C#
- Linguaggi.NET (per F# e Visual Basic)
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 i modelli predefiniti in .NET Core 3.1. La versione 2 supporta .NET 6 e versioni successive, con i modelli predefiniti di .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 tutte le dipendenze che iniziano con Google.Cloud.Functions
alla versione più recente e imposta il framework di destinazione su .NET 6.
Seleziona il runtime
Cloud 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:
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 FLAGS...
FLAGS...
si riferisce agli argomenti passati durante il primo deployment della funzione. Per maggiori informazioni sugli argomenti obbligatori e facoltativi, 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 della funzione
Puoi preparare una funzione direttamente dalla console Google Cloud o scriverla sulla tua macchina locale e caricarla. Per preparare la macchina locale per lo sviluppo di .NET, consulta Configurare un ambiente di sviluppo .NET.
La libreria che richiama la tua funzione è il framework.NET Functions.
Per iniziare rapidamente a utilizzare .NET su Cloud Functions, consulta la Guida rapida.
Struttura del codice sorgente
Affinché Cloud Functions trovi la definizione della tua funzione, ogni runtime ha determinati requisiti di strutturazione per il codice sorgente. Per ulteriori informazioni, consulta 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 Specifica delle dipendenze in .NET.
Passaggi successivi
- Crea la tua prima funzione C# da zero.
- Scopri gli altri linguaggi .NET che puoi usare per scrivere funzioni Cloud Functions: F# e Visual Basic.