Questo tutorial mostra come gestire le sessioni su App Engine.
Molte app richiedono la gestione della sessione per l'autenticazione e le preferenze utente.
Il pacchetto Gorilla Web Toolkit
sessions
include un'implementazione basata su file system per eseguire questa
funzione. Tuttavia, questa implementazione non è adatta per un'app che può essere pubblicata da più istanze, perché la sessione registrata in un'istanza potrebbe essere diversa da quella di altre istanze. Il pacchetto gorilla/sessions
include anche un'implementazione basata sui cookie. Tuttavia, questa implementazione richiede la crittografia dei cookie e l'archiviazione dell'intera sessione sul client, anziché solo un ID sessione, che potrebbe essere troppo grande per alcune app.
Obiettivi
- Scrivi l'app.
- Esegui l'app in locale.
- Eseguire il deployment dell'app su App Engine.
Costi
In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:
Per generare una stima dei costi basata sull'utilizzo previsto,
utilizza il Calcolatore prezzi.
Una volta completate le attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la pagina 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 gratuiti 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.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API Firestore.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API Firestore.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Aggiorna
gcloud
componenti:gcloud components update
- Preparare l'ambiente di sviluppo.
Configurazione del progetto
Nella finestra del terminale, clona il repository dell'app di esempio sulla tua macchina locale:
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
Passa alla directory che contiene il codice di esempio:
cd golang-samples/getting-started/sessions
Informazioni sull'app web
Questa app mostra i saluti in diverse lingue per ogni utente. Gli utenti di ritorno vengono sempre accolti nella stessa lingua.
Prima che l'app possa memorizzare le preferenze per un utente, devi avere un modo per memorizzare le informazioni sull'utente corrente in una sessione. Questa app di esempio utilizza Firestore per archiviare i dati delle sessioni.
Puoi utilizzare firestoregorilla
,
un session store compatibile con gorilla/sessions
.
L'app inizia importando le dipendenze, definendo un tipo
app
che contenga unsessions.Store
e un modello HTML, quindi definendo l'elenco di saluti.Successivamente, l'app definisce una funzione
main
, che crea una nuova istanzaapp
, registra il gestore di indice e avvia il server HTTP. La funzionenewApp
crea l'istanzaapp
inizializzandosessions.Store
con la funzionefirestoregorilla.New
.Il gestore dell'indice ottiene la sessione dell'utente, creandone una se necessario. Alle nuove sessioni viene assegnato un linguaggio casuale e un numero di visualizzazioni pari a 0. Successivamente, il numero di visualizzazioni viene aumentato di uno, la sessione viene salvata e il modello HTML scrive la risposta.
Il seguente diagramma illustra in che modo Firestore gestisce le sessioni per l'app App Engine.
Eliminazione delle sessioni
firestoregorilla
non elimina le sessioni vecchie o scadute. Puoi eliminare i dati della sessione nella console Google Cloud o implementare una strategia di eliminazione automatica. Se utilizzi soluzioni di archiviazione per sessioni come Memcache o Redis, le sessioni scadute vengono eliminate automaticamente.
Esecuzione in locale
Nella finestra del terminale, crea il programma binario
sessions
:go build
Avvia il server HTTP:
./sessions
Visualizza l'app nel browser web:
Cloud Shell
Nella barra degli strumenti di Cloud Shell, fai clic su Anteprima web e seleziona Anteprima sulla porta 8080.
Macchina locale
Nel browser, vai a
http://localhost:8080
Visualizzi uno dei cinque saluti: "Hello World", "Hallo Welt", "Hola mundo", "Salut le Monde" o "Ciao Mondo". La lingua cambia se apri la pagina in un browser diverso o in modalità di navigazione in incognito. Puoi visualizzare e modificare i dati della sessione nella console Google Cloud.
Per arrestare il server HTTP, premi
Control+C
nella finestra del terminale.
Deployment ed esecuzione su App Engine
Puoi utilizzare l'ambiente standard di App Engine per creare ed eseguire il deployment di un'app che viene eseguita in modo affidabile anche se sottoposta a un carico elevato e con grandi quantità di dati.
Questo tutorial utilizza l'ambiente standard di App Engine per il deployment del server.
Il file app.yaml
contiene la configurazione dell'ambiente standard di App Engine:
Esegui il deployment dell'app su App Engine:
gcloud app deploy
Nel browser, inserisci il seguente URL:
https://PROJECT_ID.REGION_ID.r.appspot.com
Sostituisci quanto segue:
PROJECT_ID
: l'ID del tuo progetto Google CloudREGION_ID
: un codice assegnato da App Engine alla tua app
Ora il saluto viene pubblicato da un server web in esecuzione su un'istanza di App Engine.
Debug dell'app
Se non riesci a connetterti all'app App Engine, verifica quanto segue:
- Controlla che i comandi di deployment di
gcloud
siano stati completati correttamente e non abbiano restituito errori. Se si sono verificati errori (ad esempiomessage=Build failed
), correggili e prova a eseguire di nuovo il deployment dell'app App Engine. Nella console Google Cloud, vai alla pagina Esplora log.
Nell'elenco a discesa Risorse selezionate di recente, fai clic su Applicazione App Engine, quindi su All module_id. Viene visualizzato un elenco delle richieste relative al momento in cui hai visitato la tua app. Se non vedi un elenco di richieste, conferma di aver selezionato Tutti i moduli_id dall'elenco a discesa. Se vengono visualizzati messaggi di errore stampati nella console Google Cloud, verifica che il codice dell'app corrisponda al codice nella sezione relativa alla scrittura dell'app web.
Assicurati che l'API Firestore sia abilitata.
Esegui la pulizia
Elimina il progetto
- Nella console Google Cloud, vai alla pagina Gestisci risorse.
- Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
- Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.
Elimina l'istanza di App Engine
- Nella console Google Cloud, vai alla pagina Versioni di App Engine.
- Seleziona la casella di controllo relativa alla versione non predefinita dell'app che vuoi eliminare.
- Per eliminare la versione dell'app, fai clic su Elimina.
Passaggi successivi
- Prova i tutorial di Cloud Functions.
- Scopri di più su App Engine.
- Prova Cloud Run, che ti consente di eseguire container stateless in un ambiente completamente gestito o nel tuo cluster Google Kubernetes Engine.