Il runtime .NET

La tua funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo con pacchetti aggiuntivi, supporto dei linguaggi e la libreria .NET Functions Framework che supporta e richiama la tua funzione. Questo ambiente è identificato dalla versione del linguaggio ed è noto come ID runtime.

Preparazione della funzione

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

Runtime .NET e immagini di base supportati

Runtime ID runtime Stack Immagine di base runtime
.NET 10
(anteprima)		 dotnet10
  • google-24 (predefinito)
  • google-24-full
    		•
  • google-24/dotnet10
  • google-24-full/dotnet10
    		•
    .NET 8 dotnet8
  • google-22 (predefinito)
  • google-22-full
    		•
  • google-22/dotnet8
  • google-22-full/dotnet8
    		•
    .NET 6 dotnet6
  • google-22 (predefinito)
  • google-22-full
    		•
  • google-22/dotnet6
  • google-22-full/dotnet6
    		•
    .NET Core 3 dotnet3 google-18-full google-18-full/dotnet3

    Pacchetto di template

    Il pacchetto di template ti aiuta a creare nuove funzioni. Per utilizzarlo:

    1. Installa l'SDK.NET.

    2. Installa il pacchetto di template:

      dotnet new install Google.Cloud.Functions.Templates

    I template sono forniti per i tre tipi di funzioni in C# (il linguaggio predefinito), F# e Visual Basic. Quando crei un nuovo progetto da un template, specifica -lang f# per creare un progetto F# o -lang vb per creare un progetto Visual Basic.

    Seleziona il 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). Puoi selezionare uno dei runtime .NET supportati per la tua funzione durante il deployment.

    Puoi selezionare una versione del runtime utilizzando la console Google Cloud o gcloud CLI. Fai clic sulla scheda per visualizzare le istruzioni sull'utilizzo dello strumento che preferisci:

    gcloud

    Specifica l'immagine di base.NET per la tua funzione utilizzando il flag --base-image durante il deployment della funzione. Ad esempio:

    gcloud run deploy FUNCTION \
    --source . \
    --function FUNCTION_ENTRYPOINT \
    --base-image dotnet8

    Sostituisci:

    • FUNCTION con il nome della funzione di cui stai eseguendo il deployment. Puoi omettere completamente questo parametro, ma ti verrà chiesto il nome se lo ometti.

    • FUNCTION_ENTRYPOINT con l'entry point della funzione nel codice sorgente. Questo è il codice che Cloud Run esegue quando viene eseguita la funzione. Il valore di questo flag deve essere un nome di funzione o un nome di classe completo esistente nel codice sorgente.

    Per istruzioni dettagliate sul deployment di una funzione utilizzando gcloud CLI, consulta Esegui il deployment di funzioni in Cloud Run.

    Console

    Puoi selezionare una versione del runtime quando crei o aggiorni una funzione Cloud Run nella console Google Cloud . Per istruzioni dettagliate sul deployment di una funzione, consulta Esegui il deployment di funzioni in Cloud Run.

    Per selezionare un runtime nella console Google Cloud quando crei una funzione:

    1. Nella console Google Cloud , vai alla pagina Cloud Run:

      Vai a Cloud Run

    2. Fai clic su Scrivi una funzione.

    3. Nell'elenco Runtime, seleziona una versione del runtime .NET.

    4. Fai clic su Crea e attendi che Cloud Run crei il servizio utilizzando una revisione segnaposto.

    5. La console ti reindirizzerà alla scheda Origine, dove potrai visualizzare il codice sorgente della funzione. Fai clic su Salva e ridistribuisci.

    Per istruzioni dettagliate sull'aggiornamento della versione del runtime dopo il deployment della funzione, consulta Eseguire nuovamente il deployment del nuovo codice sorgente.

    Struttura del codice sorgente

    Affinché Cloud Run Functions trovi la definizione della tua funzione, il codice sorgente deve seguire una struttura specifica. Per saperne di più, consulta Scrivi funzioni Cloud Run.

    Specifica delle dipendenze

    Le funzioni Cloud Run .NET utilizzano file di progetto Microsoft Build Engine (MSBuild), che sono fondamentali per il processo di build e deployment. Puoi specificare le dipendenze per la tua funzione in un file di progetto. Per C# l'estensione del file è .csproj, per F# è .fsproj, mentre per Visual Basic è .vbproj.

    Per saperne di più sulle dipendenze e su altri tipi di personalizzazione, consulta Personalizzazione tramite le classi Functions Startup.