使用 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
   

编写 Web 应用

此应用为每位用户显示不同语言的问候语。回访用户始终会收到同一种语言的问候语。

• 使用文本编辑器在 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 实例上运行的 Web 服务器提供。

调试应用

如果您无法连接到 App Engine 应用，请检查以下内容：

1. 检查 gcloud 部署命令是否已成功完成，并且未输出任何错误。如果存在错误（例如 message=Build failed），修复问题，然后再次尝试 部署 App Engine 应用。

2. 在 Cloud de Confiance 控制台中，前往 Logs Explorer 页面。

   前往 Logs Explorer 页面

   1. 在最近选择的资源 下拉列表中，点击 App Engine 应用 ，然后点击 所有 module_id 。您将看到访问您的应用时的请求列表，如果您未发现请求列表，请确认您是否已从下拉列表中选择所有 module_id 。 如果您发现控制台出现错误消息，请检查应用代码是否与 “编写 Web 应用”相关部分中的代码匹配。 Cloud de Confiance

   2. 确保已启用 Firestore API。