使用 Firestore 處理工作階段

設定專案

1. 在終端機視窗中，從您選擇的目錄開始，建立一個新目錄，名稱為 sessions。本教學課程的所有程式碼都在 sessions 目錄中。

2. 變更至 sessions 目錄：

   cd sessions
   

3. 初始化 Gemfile：

   bundle init
   

4. 在產生的 Gemfile 中附加下列內容：

   gem "google-cloud-firestore", "~> 2.0"
   gem "sinatra", "~> 2.0"

   Gemfile 會列出應用程式需要 App Engine 為其載入的所有非標準 Ruby 程式庫：

   • google-cloud-firestore 是 Firestore API 的 Ruby 用戶端。

   • Sinatra 是應用程式使用的 Ruby 網路架構。

5. 安裝依附元件：

   bundle install
   

編寫網頁應用程式

這個應用程式為每個使用者顯示不同語言的問候語。系統一律會用與上次相同的語言問候回訪者。

• 使用文字編輯器，在 sessions 目錄中建立名為 app.rb 的檔案，並加入以下內容：

  require "sinatra"
  
  require_relative "firestore_session"
  
  use Rack::Session::FirestoreSession
  
  set :greetings, ["Hello World", "Hallo Welt", "Ciao Mondo", "Salut le Monde", "Hola Mundo"]
  
  get "/" do
    session[:greeting] ||= settings.greetings.sample
    session[:views] ||= 0
    session[:views] += 1
    "<h1>#{session[:views]} views for \"#{session[:greeting]}\"</h1>"
  end

建立工作階段儲存空間

您必須先將目前使用者的相關資訊儲存在工作階段中，應用程式才能儲存使用者的偏好設定。下圖說明 Firestore 如何處理 App Engine 應用程式的工作階段。

Sinatra 內建支援將工作階段資料儲存至 Cookie。如要改為儲存至 Firestore，您必須自行定義 Rack::Session 物件。

• 在 sessions 目錄中，建立名為 firestore_session.rb 的檔案，並加入以下內容：

  require "google/cloud/firestore"
  require "rack/session/abstract/id"
  
  module Rack
    module Session
      class FirestoreSession < Abstract::Persisted
        def initialize app, options = {}
          super
  
          @firestore = Google::Cloud::Firestore.new
          @col = @firestore.col "sessions"
        end
  
        def find_session _req, session_id
          return [generate_sid, {}] if session_id.nil?
  
          doc = @col.doc session_id
          fields = doc.get.fields || {}
          [session_id, stringify_keys(fields)]
        end
  
        def write_session _req, session_id, new_session, _opts
          doc = @col.doc session_id
          doc.set new_session, merge: true
          session_id
        end
  
        def delete_session _req, session_id, _opts
          doc = @col.doc session_id
          doc.delete
          generate_sid
        end
  
        def stringify_keys hash
          new_hash = {}
          hash.each do |k, v|
            new_hash[k.to_s] =
              if v.is_a? Hash
                stringify_keys v
              else
                v
              end
          end
          new_hash
        end
      end
    end
  end

刪除工作階段

如您所寫，這個應用程式不會刪除舊的或過期的工作階段。您可以刪除工作階段資料，或實作自動化的刪除策略。Cloud de Confiance

在本機環境中執行

1. 啟動 HTTP 伺服器：

   bundle exec ruby app.rb
   

2. 在網路瀏覽器中檢視應用程式。

   您會看到以下五個問候語其中之一：「Hello World」、「Hallo Welt」、「Hola mundo」、「Salut le Monde」或「Ciao Mondo」。如果您在其他瀏覽器或無痕模式中開啟頁面，語言就會變更。您可以在Cloud de Confiance 控制台中查看和編輯工作階段資料。

3. 如要停止 HTTP 伺服器，請在您的終端機視窗中，按下 Control+C。

在 App Engine 上部署及執行

您可以使用 App Engine 標準環境以建構及部署應用程式，即使是處在高負載和大量資料的情況下，應用程式仍會穩定可靠地執行。

本教學課程使用 App Engine 標準環境來部署伺服器。

1. 在終端機視窗中，建立 app.yaml 檔案，並將下列內容貼到檔案中：

   runtime: ruby25
   entrypoint: bundle exec ruby app.rb

2. 在 App Engine 上部署應用程式：

   gcloud app deploy
   

3. 透過以下網址查看執行中的應用程式，其中 PROJECT_ID 是您的 Cloud de Confiance 專案 ID：

   https://PROJECT_ID.appspot.com

問候語目前是由 App Engine 執行個體上執行的網路伺服器提供。

應用程式偵錯

如果您無法連接到 App Engine 應用程式，請檢查以下內容：

1. 檢查 gcloud 部署指令是否順利完成，且未輸出任何錯誤。如果發生錯誤 (例如 message=Build failed)，請修正錯誤，並再次嘗試部署 App Engine 應用程式。

2. 前往 Cloud de Confiance 控制台的「Logs Explorer」頁面。

   前往「Logs Explorer」(記錄檔探索工具) 頁面

   1. 在「Recently selected resources」(最近選取的資源) 下拉式清單中，點選 [App Engine Application] (App Engine 應用程式)，然後按一下 [All module_id] (所有 module_id)。系統隨即會顯示您造訪應用程式時的要求清單。如果您沒看見要求清單，請確認您已從下拉式清單中選取 [All module_id] (所有 module_id)。如果在 Cloud de Confiance 控制台中看到錯誤訊息，請檢查應用程式的程式碼是否與「編寫網頁應用程式」一節中的程式碼相符。

   2. 確認已啟用 Firestore API。