Menangani sesi dengan Firestore

Menyiapkan project

1. Di jendela terminal Anda, mulai di direktori pilihan Anda dan buat direktori baru bernama sessions. Semua kode untuk tutorial ini berada di dalam direktori sessions.

2. Ubah ke direktori sessions:

   cd sessions
   

3. Lakukan inisialisasi file package.json:

   npm init .
   

4. Instal dependensinya:

   npm install \
    --save @google-cloud/connect-firestore @google-cloud/firestore express express-session
   

Di akhir tutorial ini, struktur file akhir akan mirip dengan yang berikut:

sessions
├── app.yaml
├── index.js
└── package.json

Menulis aplikasi web

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

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

Anda dapat menggunakan connect-firestore, penyimpanan sesi yang kompatibel dengan express-session.

• Di jendela terminal Anda, buat file bernama index.js dengan konten berikut:

  // Copyright 2019, Google LLC.
  // Licensed under the Apache License, Version 2.0 (the "License");
  // you may not use this file except in compliance with the License.
  // You may obtain a copy of the License at
  //
  //    http://www.apache.org/licenses/LICENSE-2.0
  //
  // Unless required by applicable law or agreed to in writing, software
  // distributed under the License is distributed on an "AS IS" BASIS,
  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  // See the License for the specific language governing permissions and
  // limitations under the License.
  
  const {Firestore} = require('@google-cloud/firestore');
  const express = require('express');
  const session = require('express-session');
  
  const app = express();
  const {FirestoreStore} = require('@google-cloud/connect-firestore');
  
  app.use(
    session({
      store: new FirestoreStore({
        dataset: new Firestore(),
        kind: 'express-sessions',
      }),
      secret: 'my-secret',
      resave: false,
      saveUninitialized: true,
    })
  );
  
  const greetings = [
    'Hello World',
    'Hallo Welt',
    'Ciao Mondo',
    'Salut le Monde',
    'Hola Mundo',
  ];
  
  app.get('/', (req, res) => {
    if (!req.session.views) {
      req.session.views = 0;
      req.session.greeting =
        greetings[Math.floor(Math.random() * greetings.length)];
    }
    const views = req.session.views++;
    res.send(`${views} views for ${req.session.greeting}`);
  });
  
  const port = process.env.PORT || 8080;
  app.listen(port, () => {
    console.log(`Example app listening on port ${port}!`);
  });
  
  module.exports = app;
  

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

Setelah Anda menetapkan app.use(session), setiap permintaan akan memiliki properti req.session yang dapat Anda gunakan untuk mengidentifikasi pengguna berulang. Data sesi disimpan di Firestore.

Menghapus sesi

Connect-firestore tidak menghapus sesi lama atau yang sudah berakhir. Anda dapat menghapus data sesi di Cloud de Confiance konsol atau menerapkan strategi penghapusan otomatis. Jika Anda menggunakan solusi penyimpanan untuk sesi seperti Memcache atau Redis, sesi yang sudah berakhir akan otomatis dihapus.

Berjalan secara lokal

1. Di jendela terminal Anda, instal dependensi untuk Cloud de Confiance project:

   npm install
   

2. Mulai server HTTP:

   npm start
   

3. Lihat aplikasi di browser web Anda:

   Cloud Shell

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

   Mesin lokal

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

   Anda akan melihat salah satu dari lima sapaan: “Hello World”, “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 Cloud de Confiance konsol.

   

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

Men-deploy dan menjalankan di App Engine

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

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

1. Di jendela terminal Anda, buat file app.yaml dan salin kode berikut:

   runtime: nodejs10

2. Deploy aplikasi di App Engine:

   gcloud app deploy
   

3. Lihat aplikasi aktif dengan memasukkan URL berikut:

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

   Ganti kode berikut:

   • PROJECT_ID: Project ID Anda Cloud de Confiance
   • REGION_ID: Kode yang ditetapkan App Engine ke aplikasi Anda

Sapaan kini dikirim oleh server web yang berjalan pada instance App Engine.

Men-debug aplikasi

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

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

2. Di Cloud de Confiance konsol, buka halaman Logs Explorer.

   Buka halaman Logs Explorer

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

   2. Pastikan Firestore API diaktifkan.