Crea ed esegui il deployment di una funzione Cloud Functions HTTP con .NET (1ª generazione.)

Nota: questi contenuti si applicano solo a Cloud Functions (1ª generazione.). Consulta Creare ed eseguire il deployment di una funzione Cloud Functions HTTP con .NET (2ª generazione) per la versione di 2ª generazione di questo documento. Per ulteriori informazioni, consulta il confronto delle versioni di Cloud Functions.

Questa guida illustra il processo di scrittura di una Cloud Function utilizzando il linguaggio di runtime .NET C#. Esistono due tipi di funzioni Cloud Functions:

• Una funzione attivata da HTTP, richiamata dalle richieste HTTP standard.
• Una funzione basata su eventi, che puoi utilizzare per gestire gli eventi dalla tua infrastruttura Cloud, come i messaggi su un argomento Pub/Sub o le modifiche in un bucket Cloud Storage.

Scopri di più: per maggiori dettagli, leggi le informazioni sulle funzioni HTTP e sulle funzioni basate su eventi.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Abilita le API Cloud Functions and Cloud Build.

   Abilita le API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

7. Abilita le API Cloud Functions and Cloud Build.

   Abilita le API

8. Installa e inizializza gcloud CLI.
9. Aggiorna e installa i componenti di gcloud:

   gcloud components update

Nota: hai bisogno di un prompt dei comandi? Puoi usare Cloud Shell. Cloud Shell è un ambiente a riga di comando che include già Google Cloud CLI, quindi non è necessario installarlo. Google Cloud CLI è preinstallato anche sulle macchine virtuali Google Compute Engine.
10. Prepara l'ambiente di sviluppo.

    Vai alla guida alla configurazione di .NET

crea una funzione

Questa sezione descrive come creare manualmente una funzione da zero. In alternativa, puoi utilizzare i modelli forniti dal pacchetto di modelli.

Per creare una funzione:

1. Crea una directory sul tuo sistema locale per il codice della funzione:

   Windows

   mkdir %HOMEPATH%\helloworld
   cd %HOMEPATH%\helloworld
   

   Linux o Mac OS X

   mkdir ~/helloworld
   cd ~/helloworld
   

2. Crea un file denominato Function.cs con i contenuti seguenti:

   using Google.Cloud.Functions.Framework;
   using Microsoft.AspNetCore.Http;
   using System.Threading.Tasks;
   
   namespace HelloWorld;
   
   public class Function : IHttpFunction
   {
       public async Task HandleAsync(HttpContext context)
       {
           await context.Response.WriteAsync("Hello World!", context.RequestAborted);
       }
   }

   Questa funzione di esempio restituisce il saluto "Hello World!"

Specifica delle dipendenze

Il passaggio successivo è impostare le dipendenze. In Cloud Functions puoi configurare due diversi tipi di dipendenze:

• Rendi disponibile il framework di Functions. Questa è l'attività che svolgi in questa sezione.
• Rendi disponibili altre librerie, sia in termini di file di progetto che all'interno del codice tramite l'inserimento delle dipendenze. Per saperne di più, consulta Personalizzazione tramite i corsi di Functions Startup.

Per rendere disponibile il framework di Functions, cambia la directory con la directory helloworld che hai creato in precedenza:

     cd ~/helloworld

Quindi crea un file denominato HelloWorld.csproj con i contenuti seguenti:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Google.Cloud.Functions.Hosting" Version="2.2.1" />
  </ItemGroup>
</Project>

Scopri di più: per maggiori dettagli, leggi come specificare le dipendenze.

esegui il deployment della funzione

Per eseguire il deployment della funzione con un trigger HTTP, esegui questo comando nella directory helloworld:

gcloud functions deploy my-first-function --entry-point HelloWorld.Function --runtime dotnet6 --trigger-http --allow-unauthenticated

dove my-first-function è il nome registrato con cui la funzione sarà identificata nella console Google Cloud e --entry-point specifica il nome completo della classe (FQN) della funzione.

Scopri di più: per maggiori dettagli, leggi come eseguire il deployment di Cloud Functions.

Testa la funzione di cui è stato eseguito il deployment

1. Al termine del deployment della funzione, prendi nota della proprietà httpsTrigger.url o cercala utilizzando il seguente comando:

   gcloud functions describe my-first-function
   

   Dovrebbe avere il seguente aspetto:

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/my-first-function

2. Accedi all'URL dal browser. Dovresti vedere un messaggio Hello World!.

Nota: puoi trovare questo URL anche nella console Google Cloud. Vai alla pagina Panoramica di Cloud Functions e fai clic sul nome della funzione per aprire la relativa pagina Dettagli funzione. Apri la scheda ATTIVATORE per vedere l'URL della funzione.

visualizza i log

I log per Cloud Functions sono visualizzabili utilizzando Google Cloud CLI e nell'interfaccia utente di Cloud Logging.

Utilizzare lo strumento a riga di comando

Per visualizzare i log per la tua funzione con gcloud CLI, utilizza il comando logs read, seguito dal nome della funzione:

gcloud functions logs read my-first-function

L'output dovrebbe essere simile al seguente:

LEVEL  NAME               EXECUTION_ID  TIME_UTC                 LOG
D      my-first-function  k2bqgroszo4u  2020-07-24 18:18:01.791  Function execution started
D      my-first-function  k2bqgroszo4u  2020-07-24 18:18:01.958  Function execution took 168 ms, finished with status code: 200
...

Nota: in genere si verifica un leggero ritardo tra il momento in cui vengono create le voci di log e il momento in cui vengono visualizzate in Cloud Logging.

Usa la dashboard di Logging

Puoi visualizzare i log per Cloud Functions anche dalla console Google Cloud.

Scopri di più: per maggiori dettagli, leggi come scrivere, visualizzare e rispondere ai log.

Utilizzare il pacchetto di modelli

Le sezioni precedenti spiegano come creare manualmente una funzione da zero. In futuro, utilizzerai probabilmente i modelli per creare nuove funzioni.

Per utilizzare i modelli per creare, generare e testare una funzione:

1. Installa .NET SDK.

2. Installa il pacchetto di modelli:

   dotnet new install Google.Cloud.Functions.Templates
   

   Nota: le versioni di .NET SDK precedenti a .NET 7 utilizzano dotnet new -i anziché dotnet new install.

3. Poi, crea una directory per il progetto e usa dotnet new per creare una nuova funzione HTTP:

   mkdir HelloFunctions
   cd HelloFunctions
   dotnet new gcf-http
   

   Vengono creati i criteri HelloFunctions.csproj e Function.cs nella directory corrente. Apri Function.cs per esaminare il codice ed eventualmente fornire un messaggio personalizzato.

   Nota: per informazioni su come utilizzare i modelli per creare funzioni F# e Visual Basic, consulta Lingue.NET.

4. Crea la tua funzione localmente come segue:

   dotnet run
   

5. Quando il server è in esecuzione, vai a http://localhost:8080 per richiamare la funzione. Premi Ctrl+C nella console per arrestare il server.

   Questa funzione visualizza il messaggio "Hello Functions Framework".

In alternativa, puoi inviare richieste a questa funzione utilizzando curl da un'altra finestra del terminale:

curl localhost:8080
# Output: Hello Functions Framework