Menangani sesi dengan Firestore

---

Tutorial ini menunjukkan cara menangani sesi di App Engine.

Banyak aplikasi memerlukan penanganan sesi untuk autentikasi dan preferensi pengguna. Paket sessions Gorilla Web Toolkit dilengkapi dengan implementasi berbasis sistem file untuk menjalankan fungsi ini. Namun, implementasi ini tidak sesuai untuk aplikasi yang dapat disalurkan dari beberapa instance, karena sesi yang direkam dalam satu instance mungkin berbeda dari instance lainnya. Paket gorilla/sessions juga dilengkapi dengan penerapan berbasis cookie. Namun, implementasi ini memerlukan enkripsi cookie dan penyimpanan seluruh sesi pada klien, bukan hanya ID sesi, yang mungkin terlalu besar untuk beberapa aplikasi.

Tujuan

• Tulis aplikasi.
• Jalankan aplikasi secara lokal.
• Men-deploy aplikasi di App Engine.

Biaya

Dalam dokumen ini, Anda menggunakan komponen Google Cloud yang dapat ditagih berikut:

• App Engine
• Firestore

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga. Pengguna baru Google Cloud mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.

Sebelum memulai

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Make sure that billing is enabled for your Google Cloud project.

4. Aktifkan API Firestore.

   Mengaktifkan API

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

7. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

8. Make sure that billing is enabled for your Google Cloud project.

9. Aktifkan API Firestore.

   Mengaktifkan API

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

12. Perbarui komponen gcloud:

    gcloud components update

13. Menyiapkan lingkungan pengembangan Anda.

Menyiapkan project

1. Di jendela terminal, clone repositori aplikasi contoh ke mesin lokal Anda:

   git clone https://github.com/GoogleCloudPlatform/golang-samples.git

2. Ubah ke direktori yang berisi kode contoh:

   cd golang-samples/getting-started/sessions

Memahami aplikasi web

Aplikasi ini menampilkan salam dalam bahasa yang berbeda untuk setiap pengguna. Pengguna yang kembali akan selalu disambut dalam bahasa yang sama.

Sebelum aplikasi dapat menyimpan preferensi bagi pengguna, Anda memerlukan cara untuk menyimpan informasi tentang pengguna saat ini dalam sebuah sesi. Aplikasi contoh ini menggunakan Firestore untuk menyimpan data sesi.

Anda dapat menggunakan firestoregorilla, penyimpanan sesi yang kompatibel dengan gorilla/sessions.

1. Aplikasi dimulai dengan mengimpor dependensi, menentukan jenis app untuk menyimpan sessions.Store dan template HTML, serta menentukan daftar ucapan.

   
   // Command sessions starts an HTTP server that uses session state.
   package main
   
   import (
   	"context"
   	"fmt"
   	"html/template"
   	"log"
   	"math/rand"
   	"net/http"
   	"os"
   
   	"cloud.google.com/go/firestore"
   	firestoregorilla "github.com/GoogleCloudPlatform/firestore-gorilla-sessions"
   	"github.com/gorilla/sessions"
   )
   
   // app stores a sessions.Store. Create a new app with newApp.
   type app struct {
   	store sessions.Store
   	tmpl  *template.Template
   }
   
   // greetings are the random greetings that will be assigned to sessions.
   var greetings = []string{
   	"Hello World",
   	"Hallo Welt",
   	"Ciao Mondo",
   	"Salut le Monde",
   	"Hola Mundo",
   }
   

2. Selanjutnya, aplikasi akan menentukan fungsi main, yang membuat instance app baru, mendaftarkan pengendali indeks, dan memulai server HTTP. Fungsi newApp membuat instance app dengan menginisialisasi sessions.Store menggunakan fungsi firestoregorilla.New.

   
   func main() {
   	port := os.Getenv("PORT")
   	if port == "" {
   		port = "8080"
   	}
   	projectID := os.Getenv("GOOGLE_CLOUD_PROJECT")
   	if projectID == "" {
   		log.Fatal("GOOGLE_CLOUD_PROJECT must be set")
   	}
   
   	a, err := newApp(projectID)
   	if err != nil {
   		log.Fatalf("newApp: %v", err)
   	}
   
   	http.HandleFunc("/", a.index)
   
   	log.Printf("Listening on port %s", port)
   	if err := http.ListenAndServe(":"+port, nil); err != nil {
   		log.Fatal(err)
   	}
   }
   
   // newApp creates a new app.
   func newApp(projectID string) (*app, error) {
   	ctx := context.Background()
   	client, err := firestore.NewClient(ctx, projectID)
   	if err != nil {
   		log.Fatalf("firestore.NewClient: %v", err)
   	}
   	store, err := firestoregorilla.New(ctx, client)
   	if err != nil {
   		log.Fatalf("firestoregorilla.New: %v", err)
   	}
   
   	tmpl, err := template.New("Index").Parse(`<body>{{.views}} {{if eq .views 1.0}}view{{else}}views{{end}} for "{{.greeting}}"</body>`)
   	if err != nil {
   		return nil, fmt.Errorf("template.New: %w", err)
   	}
   
   	return &app{
   		store: store,
   		tmpl:  tmpl,
   	}, nil
   }
   

3. Pengendali indeks mendapatkan sesi pengguna, yang membuatnya jika diperlukan. Sesi baru diberi bahasa acak dan jumlah penayangan 0. Kemudian, jumlah penayangan bertambah satu, sesi akan disimpan, dan template HTML akan menulis responsnya.

   
   // index uses sessions to assign users a random greeting and keep track of
   // views.
   func (a *app) index(w http.ResponseWriter, r *http.Request) {
   	if r.RequestURI != "/" {
   		return
   	}
   
   	// name is a non-empty identifier for this app's sessions. Set it to
   	// something descriptive for your app. It is used as the Firestore
   	// collection name that stores the sessions.
   	name := "hello-views"
   	session, err := a.store.Get(r, name)
   	if err != nil {
   		// Could not get the session. Log an error and continue, saving a new
   		// session.
   		log.Printf("store.Get: %v", err)
   	}
   
   	if session.IsNew {
   		// firestoregorilla uses JSON, which unmarshals numbers as float64s.
   		session.Values["views"] = float64(0)
   		session.Values["greeting"] = greetings[rand.Intn(len(greetings))]
   	}
   	session.Values["views"] = session.Values["views"].(float64) + 1
   	if err := session.Save(r, w); err != nil {
   		log.Printf("Save: %v", err)
   		// Don't return early so the user still gets a response.
   	}
   
   	if err := a.tmpl.Execute(w, session.Values); err != nil {
   		log.Printf("Execute: %v", err)
   	}
   }
   

   Diagram berikut mengilustrasikan cara Firestore menangani sesi untuk aplikasi App Engine.

   

Catatan: Firestore adalah database transaksional yang persisten, terdistribusi. Sering kali, akan lebih tepat memilih solusi penyimpanan yang berbeda untuk sesi seperti Memcache atau Redis, yang desainnya dapat menghasilkan operasi yang lebih cepat dalam kasus penggunaan ini.

Menghapus sesi

firestoregorilla tidak menghapus sesi lama atau yang habis masa berlakunya. Anda dapat menghapus data sesi di Google Cloud Console atau menerapkan strategi penghapusan otomatis. Jika Anda menggunakan solusi penyimpanan untuk sesi seperti Memcache atau Redis, sesi yang telah habis masa berlakunya akan otomatis dihapus.

Menjalankan proses secara lokal

1. Di jendela terminal Anda, build biner sessions:

   go build
   

2. Mulai server HTTP:

   ./sessions
   

3. Melihat aplikasi di browser web:

   Cloud Shell

   Di toolbar Cloud Shell, klik Web preview lalu pilih Preview on port 8080.

   Komputer lokal

   Di browser Anda, buka http://localhost:8080

   Anda akan melihat salah satu dari lima salam: “Halo Dunia”, “Hallo Welt”, "Hola mundo”, “Salut le Monde”, atau “Ciao Mondo”. Bahasa akan berubah jika Anda membuka halaman di browser lain atau dalam mode samaran. Anda dapat melihat dan mengedit data sesi di Konsol Google Cloud.

   

4. Untuk menghentikan server HTTP, di jendela terminal, tekan Control+C.

Men-deploy dan menjalankan aplikasi di App Engine

Anda dapat menggunakan lingkungan standar App Engine untuk membangun dan men-deploy aplikasi yang berjalan dengan andal dalam beban berat dan dengan data dalam jumlah besar.

Tutorial ini menggunakan lingkungan standar App Engine untuk men-deploy server.

File app.yaml berisi konfigurasi lingkungan standar App Engine:

runtime: go112

1. Deploy aplikasi di App Engine:

   gcloud app deploy
   

2. Di browser Anda, masukkan URL berikut:

   https://PROJECT_ID.REGION_ID.r.appspot.com

   Ganti kode berikut:

   • PROJECT_ID: ID Project Google Cloud Anda
   • REGION_ID: Kode yang ditetapkan App Engine untuk aplikasi Anda

Salam ini sekarang dikirimkan oleh server web yang berjalan di instance App Engine.

Men-debug aplikasi

Jika Anda tidak dapat terhubung ke aplikasi App Engine, periksa hal-hal berikut:

1. Pastikan perintah deploy gcloud berhasil diselesaikan dan tidak menghasilkan error. Jika ada error (misalnya, message=Build failed), perbaiki error tersebut, lalu coba deploy aplikasi App Engine lagi.

2. Di Konsol Google Cloud, buka halaman Logs Explorer.

   Buka halaman Logs Explorer

   1. Di menu drop-down Recent selected resources, klik App Engine Application, lalu klik All module_id. Anda akan melihat daftar permintaan dari saat Anda mengunjungi aplikasi. Jika Anda tidak melihat daftar permintaan, pastikan Anda memilih All module_id dari menu drop-down. Jika Anda melihat pesan error yang dicetak ke Konsol Google Cloud, pastikan kode aplikasi Anda cocok dengan kode di bagian tentang cara menulis aplikasi web.

   2. Pastikan Firestore API diaktifkan.

Pembersihan

Menghapus project

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari berbagai arsitektur, tutorial, atau panduan memulai, menggunakan kembali project dapat membantu agar Anda tidak melampaui batas kuota project.

1. Di konsol Google Cloud, buka halaman Manage resource.

   Buka Manage resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Menghapus instance App Engine

1. Di konsol Google Cloud, buka halaman Versi untuk App Engine.

   Buka Versi

2. Pilih kotak centang untuk versi aplikasi non-default yang ingin Anda hapus.
   Catatan: Satu-satunya cara untuk menghapus versi default aplikasi App Engine adalah dengan menghapus project Anda. Namun, Anda dapat menghentikan versi default ini di Google Cloud Console. Tindakan ini akan menonaktifkan semua instance yang terkait dengan versi tersebut. Anda dapat memulai ulang instance ini jika nanti dibutuhkan.

   Di lingkungan standar App Engine, Anda dapat menghentikan versi default hanya jika aplikasi memiliki penskalaan manual atau dasar.

3. Untuk menghapus versi aplikasi, klik Hapus.

Langkah selanjutnya

• Mencoba tutorial Cloud Functions.
• Pelajari App Engine lebih lanjut.
• Coba Cloud Run, yang dapat Anda gunakan untuk menjalankan container stateless di lingkungan yang terkelola sepenuhnya atau di cluster Google Kubernetes Engine Anda sendiri.