Introduzione a .NET

Questo tutorial è destinato a coloro che non hanno mai creato app nel cloud, ad esempio ingegneri e sviluppatori web che vogliono imparare i concetti chiave di Google Cloud.

Obiettivi

Costi

Questo tutorial utilizza i seguenti componenti fatturabili di Google Cloud:

Il tutorial è progettato 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 possono beneficiare di una prova gratuita.

Al termine di questo tutorial, puoi evitare una fatturazione continua eliminando le risorse che hai creato. Per scoprire di più, vedi Pulizia.

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. Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.

  4. Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  5. Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.

  6. Per creare un database Firestore in modalità Native, segui questa procedura:
    1. Nella console, vai alla pagina Visualizzatore Firestore.
      Vai al visualizzatore Firestore
    2. Nella schermata Seleziona una modalità di Cloud Firestore, fai clic su Seleziona modalità nativa.
    3. Seleziona una località per il tuo database Firestore. La località impostata corrisponde alla località predefinita delle risorse di Google Cloud per il tuo progetto Cloud . Questa località viene utilizzata per i servizi Google Cloud all'interno del tuo progetto Cloud che richiedono la geolocalizzazione. Nello specifico, si tratta del tuo bucket predefinito di Cloud Storage e della tua app Cloud Run.
    4. Fai clic su Crea database.
  7. Abilita le API Cloud Run, Cloud Storage JSON, Cloud Logging, and Error Reporting.

    Abilita le API

  8. 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.

  9. Per scaricare il codice di esempio e modificarlo nella directory dell'applicazione, fai clic su Continua.
  10. 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 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.

Esecuzione dell'applicazione

  1. Eseguire l'applicazione:
    GOOGLE_CLOUD_PROJECT=PROJECT_ID dotnet run
    
    Sostituisci PROJECT_ID con l'ID del 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 varie opzioni per eseguire il codice. Per questo esempio, utilizzi 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 file Docker possono essere più avanzati, ma questa configurazione funziona per molte app.

Cloud Run comunica alla tua app a quale porta ascoltare, impostando la variabile di ambiente PORT. La libreria Program.cs di librerie contiene codice per osservare la variabile PORT e rimanere in 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 l'interfaccia a riga di comando gcloud:

  1. Crea l'app localmente.
    dotnet publish -c Release
    
  2. Utilizzare 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 può essere visualizzata 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. Home page dell&#39;app Bookshelf

Per ulteriori informazioni 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 varie 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).

    Aggiungere un libro all&#39;app Bookshelf
  2. Nel campo Title (Titolo), inserisci Moby Dick.
  3. Nel campo Author (Autore), inserisci Herman Melville.
  4. Fai clic su Salva. Adesso esiste una voce nell'applicazione Bookshelf.

    Voce per Moby Dick nell&#39;app Bookshelf
  5. Nella console, vai a Cloud Firestore. Vai a Cloud Firestore

    I dati vengono visualizzati in Firestore. L'app Bookshelf 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).

    Esempio di documento Firestore

Firestore archivia i libri mediante 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 Aggiungere dati a Firestore.

Archiviare i caricamenti dei file in Cloud Storage

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 è il principale archivio di blob per Google Cloud. Puoi utilizzare Cloud Storage per archiviare gli asset dell'app che vuoi condividere in Google Cloud. Per utilizzare Cloud Storage, devi creare un bucket Cloud Storage, ovvero un container di base che ospiti i tuoi dati.

  1. Nella console, 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 del 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:
    Copertina di Moby Dick
  7. Fai clic su Save (Salva). Viene visualizzata la home page, dove è presente una voce per la tua app Bookshelf.
    Voce per Moby Dick nell&#39;app Bookshelf

L'applicazione Bookshelf invia i file caricati a Cloud Storage mediante 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();
        }

Per ulteriori informazioni sull'utilizzo di Cloud Storage, consulta l'elenco di guide illustrative.

Monitorare l'app con la suite operativa di Google Cloud

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. In 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.

    Visualizzatore log di Stackdriver
  2. Nell'elenco a discesa Risorsa, seleziona Revisione Cloud Run, scaffale.

Monitorare gli errori con Error Reporting

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

    Viene così generata una nuova eccezione di test che viene inviata alla suite operativa di Google Cloud.

  3. Nella console, torna alla pagina Error Reporting. Dopo qualche istante viene visualizzato il nuovo errore. Fai clic su Ricarica automaticamente per evitare di aggiornare manualmente la pagina.

    Messaggio di errore di Error Reporting.

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

  1. Nella console, vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

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

Passaggi successivi