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 scoprire quale versione di Ubuntu viene utilizzata da ciascun runtime .NET, consulta l'ambiente di esecuzione di Cloud Run Functions.

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 l'SDK.NET.

  2. Installa il pacchetto del modello:

    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 impostati per impostazione predefinita su .NET Core 3.1. La versione 2 supporta .NET 6 e versioni successive, con i modelli impostati per impostazione predefinita su .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

Cloud Run 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 del 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 di classe completamente qualificato (FQN). Ad esempio:

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

FLAGS... si riferisce agli argomenti passati durante il primo deployment della funzione. Per ulteriori informazioni sugli argomenti obbligatori e facoltativi, consulta Eseguire il deployment utilizzando l'interfaccia a riga di comando Google Cloud.

Console

Se utilizzi la console Google Cloud, consulta la guida introduttiva alla 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 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 .NET nelle funzioni Cloud Run, consulta la guida rapida.

Struttura del codice sorgente

Affinché le funzioni Cloud Run trovino la definizione della tua funzione, ogni 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