Inizia a utilizzare .NET

Questo tutorial è rivolto a chi non ha esperienza nella creazione di app nel cloud, ad esempio ingegneri e sviluppatori web, che vogliono apprendere i concetti chiave dello sviluppo di app in relazione a Google Cloud.

Obiettivi

• Scopri gli strumenti di base di Google Cloud , come la Google Cloud console e gcloud.
• Eseguire il deployment dell'app in Cloud Run.
• Rendere persistenti i dati con Firestore.
• Archiviare in Cloud Storage i file caricati.
• Monitora la tua app utilizzando Google Cloud Observability.

Costi

In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:

• Cloud Run
• Cloud Storage
• Firestore
• Google Cloud Observability

Le istruzioni riportate in questo documento sono progettate per mantenere l'utilizzo delle risorse entro i limiti del livello Always Free di Google Cloud. Per generare una stima dei costi in base all'utilizzo previsto, utilizza il calcolatore prezzi.

I nuovi utenti di Google Cloud potrebbero avere diritto a una prova senza costi.

Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per saperne di più, consulta Esegui la pulizia.

Prima di iniziare

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 senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

1. Per creare un database Firestore in modalità Native, segui questa procedura:
   1. Nella console Google Cloud , vai alla pagina Crea database Firestore.
      

      Vai a Firestore crea database

   2. Dalla schermata Seleziona una modalità di Cloud Firestore, fai clic su Seleziona modalità Native.
   3. Seleziona una località per il tuo database Firestore. Questa impostazione della località è la località delle risorse predefinita Google Cloud per il tuo progetto Google Cloud . Questa località viene utilizzata per i servizi Google Cloud nel tuo progetto Google Cloud che richiedono l'impostazione di una località, in particolare il bucket Cloud Storage predefinito e l'app Cloud Run.
      Avviso: dopo aver impostato la località delle risorse predefinita per il tuo progetto Google Cloud , non potrai modificarla.
   4. Fai clic su Crea database.

2. Abilita le API Cloud Run, Cloud Storage JSON, Cloud Logging ed Error Reporting, se non sono già abilitate.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

   Abilita le API

3. Clona il repository di esempio e apri l'applicazione di esempio in Cloud Shell:
   Vai a Cloud Shell

   Cloud Shell fornisce l'accesso tramite riga di comando alle tue risorse Google Cloud direttamente dal browser.

4. Al prompt per clonare il repository, fai clic su Conferma.

5. In Cloud Shell, configura lo strumento gcloud in modo da utilizzare il nuovo progetto Google Cloud :

   # Configure gcloud for your project
   gcloud config set project PROJECT_ID

   Sostituisci PROJECT_ID con l'ID progetto Google Cloud che hai creato utilizzando la console Google Cloud .

   Google Cloud CLI è il metodo principale per interagire con le risorse Google Cloud dalla riga di comando. In questo tutorial utilizzerai lo strumento gcloud per eseguire il deployment dell'app e per monitorarla.

Esegui l'app

1. Eseguire l'applicazione:

   GOOGLE_CLOUD_PROJECT=PROJECT_ID dotnet run
   

   Sostituisci PROJECT_ID con l'ID progetto Google Cloud che hai creato.
2. In Cloud Shell, fai clic su Anteprima web , e seleziona Anteprima sulla porta 8080. Compare una nuova finestra in cui viene eseguita l'app.

Esecuzione del deployment dell'app in Cloud Run

Google Cloud offre diverse opzioni per l'esecuzione del codice. Per questo esempio, utilizzerai Cloud Run per eseguire il deployment di un'app scalabile in Google Cloud. Senza gestione del server, Cloud Run ti consente di concentrarti sulla scrittura del codice. Inoltre, Cloud Run scala automaticamente per supportare picchi di traffico improvvisi.

Il Dockerfile indica a Cloud Run come eseguire l'app:

FROM mcr.microsoft.com/dotnet/core/aspnet:2.1
COPY . /app
WORKDIR /app
ENTRYPOINT ["dotnet", "Bookshelf.dll"]

I Dockerfiles possono essere più ricchi, ma questa configurazione funziona per molte app.

Cloud Run indica alla tua app la porta da ascoltare impostando la variabile di ambiente PORT. Program.cs di Bookshelf contiene il codice per osservare la variabile PORT ed eseguire le operazioni di ascolto su quella porta:

using Google.Cloud.Diagnostics.AspNetCore;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;
using System;

namespace Bookshelf
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run();
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseGoogleDiagnostics(Startup.GetProjectId(), "Bookshelf", "0.01")
                .UseStartup<Startup>().UsePortEnvironmentVariable();
    }

    static class ProgramExtensions
    {
        // Google Cloud Run sets the PORT environment variable to tell this
        // process which port to listen to.
        public static IWebHostBuilder UsePortEnvironmentVariable(
            this IWebHostBuilder builder)
        {
            string port = Environment.GetEnvironmentVariable("PORT");
            if (!string.IsNullOrEmpty(port))
            {
                builder.UseUrls($"http://0.0.0.0:{port}");
            }
            return builder;
        }
    }
}

Nella finestra del terminale, esegui il deployment dell'app in Cloud Run utilizzando gcloud CLI:

1. Crea l'app localmente.

   dotnet publish -c Release

2. Utilizza Cloud Build per creare un container Docker e pubblicarlo in Container Registry.

   gcloud builds submit --tag gcr.io/PROJECT_ID/bookshelf \
       bin/Release/netcoreapp2.1/publish

3. Esegui il container con Cloud Run.

   gcloud run deploy bookshelf --region us-central1 --platform managed \
       --image gcr.io/PROJECT_ID/bookshelf --allow-unauthenticated

   Ora la tua app è visibile all'URL visualizzato nell'output di gcloud run:

   Service [bookshelf] revision [bookshelf-00001] has been deployed and is serving traffic at
   https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app

4. Copia l'URL nel browser web per visualizzare l'app.
   Nota: questo dominio protetto mediante SSL viene creato automaticamente ed è utile per lo sviluppo. Puoi anche configurare un dominio personalizzato con Cloud Run.

Per saperne di più sul deployment in Cloud Run, consulta la documentazione di Cloud Run.

Rendere persistenti i dati con Firestore

Non puoi archiviare informazioni sulle istanze di Cloud Run poiché vengono perse al riavvio dell'istanza e non esistono quando vengono create nuove istanze. Puoi, invece, utilizzare un database in cui tutte le istanze eseguono operazioni di lettura e scrittura.

Google Cloud offre diverse opzioni per archiviare i dati. In questo esempio viene utilizzato Firestore per archiviare i dati di ogni libro. Firestore è un database di documenti NoSQL serverless completamente gestito che consente di archiviare i dati e di eseguire query su di essi. Firestore si ridimensiona automaticamente per soddisfare le esigenze dell'app, con una scalabilità fino a zero quando non la utilizzi. Aggiungi il tuo primo libro.

1. Per creare un libro per l'applicazione di cui hai eseguito il deployment, fai clic su Add book (Aggiungi libro).

   
2. Nel campo Title (Titolo), inserisci Moby Dick.
3. Nel campo Author (Autore), inserisci Herman Melville.

4. Fai clic su Save (Save). Adesso esiste una voce nell'applicazione Bookshelf.

   

5. Nella console Google Cloud , vai a Cloud Firestore. Vai a Cloud Firestore

   I dati vengono visualizzati in Firestore. L'app Libreria archivia ogni libro come documento Firestore con un ID univoco e tutti questi documenti vengono archiviati in una raccolta Firestore. Ai fini di questo tutorial, la raccolta è chiamata "books" (libri).

   

Firestore archivia i libri utilizzando la libreria client di Firestore. Ecco un esempio di come recuperare un documento Firestore:

using Google.Cloud.Firestore;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace Bookshelf.Models
{
    class FirestoreBookStore : IBookStore
    {
        private FirestoreDb _firestore;
        private CollectionReference _books;

        public FirestoreBookStore(string projectId)
        {
            _firestore = FirestoreDb.Create(projectId);
            _books = _firestore.Collection("Books");
        }

Per ulteriori informazioni sull'utilizzo di Firestore, consulta la pagina relativa all'aggiunta di dati a Firestore.

Archiviare in Cloud Storage i dati caricati

Dopo aver aggiunto un libro, devi aggiungere la rispettiva immagine di copertina. Non puoi archiviare i file nelle istanze. Un database non è la scelta giusta per i file di immagine. Utilizza, invece, Cloud Storage.

Cloud Storage è l'archivio blob principale per Google Cloud. Puoi utilizzare Cloud Storage per ospitare gli asset dell'app che vuoi condividere su Google Cloud. Per utilizzare Cloud Storage, devi creare un bucket Cloud Storage, un container di base per archiviare i tuoi dati.

1. Nella console Google Cloud , vai alla pagina Browser Cloud Storage.

   Vai alla pagina Browser Cloud Storage

2. Fai clic su Crea bucket.
3. Nella finestra di dialogo Crea bucket, inserisci un nome per il bucket aggiungendo l'ID progetto Google Cloud alla stringa _bucket in modo che il nome sia simile a YOUR_PROJECT_ID_bucket. Questo nome è soggetto ai requisiti per i nomi dei bucket. Puoi lasciare invariati i valori predefiniti di tutti gli altri campi.
4. Fai clic su Crea.
5. Una volta creato il bucket, gli oggetti devono essere resi accessibili pubblicamente per poter essere visualizzati dagli utenti. Per rendere gli oggetti accessibili pubblicamente, consulta la pagina Rendere pubblici i dati.
6. Fai clic su Edit book (Modifica libro) e seleziona un'immagine da caricare come copertina del libro. Ad esempio, puoi utilizzare questa immagine di dominio pubblico:
   
7. Fai clic su Save (Salva). Viene visualizzata la home page, dove è presente una voce per la tua app Bookshelf.
   

L'app Bookshelf invia i file caricati a Cloud Storage utilizzando la libreria client di Cloud Storage.

using Google.Cloud.Storage.V1;
using Microsoft.AspNetCore.Http;
using System;
using System.Threading.Tasks;
using System.Web;

namespace Bookshelf.Services
{
    public class ImageUploader
    {
        private readonly string _bucketName;
        private readonly StorageClient _storageClient;

        public ImageUploader(string bucketName)
        {
            _bucketName = bucketName;
            _storageClient = StorageClient.Create();
        }

Nota: puoi modificare il nome del bucket impostando la variabile $bucketId nel codice precedente con un nome diverso ed eseguendo di nuovo il deployment dell'app eseguendo gcloud app deploy.

Per saperne di più sull'utilizzo di Cloud Storage, consulta la Introduzione a Cloud Storage.

Monitorare l'app utilizzando Google Cloud Observability

Hai eseguito il deployment dell'app e hai creato e modificato i libri. Per monitorare questi eventi per i tuoi utenti, utilizza gestione delle prestazioni delle applicazioni (APM).

Monitorare i log con Cloud Logging

1. Nel Google Cloud, vai a Esplora log.

   Vai a Esplora log

   Puoi monitorare l'app in tempo reale. In caso di problemi con l'app, questa è una delle prime sezioni da controllare.

   
2. Nell'elenco a discesa Risorsa, seleziona Revisione Cloud Run, Bookshelf.

Monitora gli errori con Error Reporting

1. Nella console Google Cloud , vai alla pagina Error Reporting.
   Vai alla pagina Error Reporting
   Error Reporting evidenzia errori ed eccezioni nell'applicazione e consente di impostare avvisi al riguardo.
2. Nel browser, accedi all'URL /Home/Throw nell'applicazione.
   Ad esempio, se la tua app è ospitata all'indirizzo https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app, vai all'indirizzo https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app/Home/Throw.

   Viene generata una nuova eccezione di test e inviata a Google Cloud Observability.

3. Nella console Google Cloud , torna alla pagina Error Reporting e dopo qualche istante il nuovo errore sarà visibile. Fai clic su Ricarica automaticamente per evitare di aggiornare manualmente la pagina.

   

Esegui la pulizia

Per evitare che al tuo Account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina il progetto

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console Google Cloud , vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona quello che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Deployment di un'app in Google Kubernetes Engine
• Deployment di un'app in Compute Engine
• Gestione delle sessioni con Firestore