Runtime di .NET

Panoramica

La funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo, oltre a pacchetti aggiuntivi, supporto per le lingue e la libreria Functions Framework che supporta e richiama la funzione. Questo ambiente è identificato dalla versione della lingua ed è noto come ambiente di runtime.

Per informazioni sui runtime in generale e per sapere quale versione di Ubuntu utilizzato da ogni runtime .NET, consulta la sezione sull'esecuzione delle funzioni di Cloud Run encoder-decoder.

Per iniziare a utilizzare .NET nelle funzioni Cloud Run, consulta la guida rapida.

Pacchetto di modelli

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

  1. Installa .NET SDK.

  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# (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 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 .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 che utilizza la versione 1 di .NET Functions Framework, modifica il file del 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

Le funzioni Cloud Run supportano diverse versioni di .NET, elencate nella pagina Supporto del runtime. Quando esegui il deployment 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 usando il parametro --runtime. Il flag --entry-point specifica nome completo della classe. Ad esempio:

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

FLAGS... si riferisce agli argomenti passati durante il primo del deployment della funzione. Per ulteriori informazioni sui argomenti facoltativi, vedi Esegui il deployment utilizzando Google Cloud CLI.

Console

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

Preparazione della funzione

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

La libreria che richiama la funzione è il Framework di funzioni .NET.

Per iniziare rapidamente a utilizzare le funzioni .NET su Cloud Run, consulta il Guida rapida.

Struttura del codice sorgente

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

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