在终端窗口中，从您选择的目录启动，并创建一个名为 sessions 的新目录。本教程的所有代码均位于 sessions 目录内。
切换到 sessions 目录：
```
cd sessions
```
请使用以下内容创建 requirements.txt：

sessions/requirements.txt

在 GitHub 上查看
```
google-cloud-firestore==2.5.2
flask==2.1.2
```
安装依赖项：
```
pip install  -r requirements.txt
```

在本教程结束时，最终文件结构类似于以下内容：

sessions
├── app.yaml
├── main.py
└── requirements.txt

编写 Web 应用

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

多个应用窗口显示不同语言的问候语。

在应用存储用户偏好设置之前，您需要存储会话中当前用户的相关信息。此示例应用使用 Cookie 和 Firestore 来存储会话数据。

在终端窗口中，使用以下内容创建名为 main.py 的文件：

sessions/main.py

在 GitHub 上查看

import random
from uuid import uuid4

from flask import Flask, make_response, request
from google.cloud import firestore

app = Flask(__name__)
db = firestore.Client()
sessions = db.collection('sessions')
greetings = [
    'Hello World',
    'Hallo Welt',
    'Ciao Mondo',
    'Salut le Monde',
    'Hola Mundo',
]

@firestore.transactional
def get_session_data(transaction, session_id):
    """ Looks up (or creates) the session with the given session_id.
        Creates a random session_id if none is provided. Increments
        the number of views in this session. Updates are done in a
        transaction to make sure no saved increments are overwritten.
    """
    if session_id is None:
        session_id = str(uuid4())   # Random, unique identifier

    doc_ref = sessions.document(document_id=session_id)
    doc = doc_ref.get(transaction=transaction)
    if doc.exists:
        session = doc.to_dict()
    else:
        session = {
            'greeting': random.choice(greetings),
            'views': 0
        }

    session['views'] += 1   # This counts as a view
    transaction.set(doc_ref, session)

    session['session_id'] = session_id
    return session

@app.route('/', methods=['GET'])
def home():
    template = '<body>{} views for "{}"</body>'

    transaction = db.transaction()
    session = get_session_data(transaction, request.cookies.get('session_id'))

    resp = make_response(template.format(
        session['views'],
        session['greeting']
        )
    )
    resp.set_cookie('session_id', session['session_id'], httponly=True)
    return resp

if __name__ == '__main__':
    app.run(host='127.0.0.1', port=8080)

下图说明了 Firestore 如何处理 App Engine 应用的会话。

删除会话

您可以删除会话数据或实施自动删除策略。如果您为会话使用 Memcache 或 Redis 等存储解决方案，系统会自动删除已过期的会话。

在本地运行

在您的终端窗口中，安装 Gunicorn HTTP 服务器：
```
pip install gunicorn
```
运行 Gunicorn HTTP 服务器：
```
gunicorn -b :8080 main:app
```
在网络浏览器中查看应用：

Cloud Shell

在 Cloud Shell 工具栏中，点击 Web 预览 ，然后选择在端口 8080 上预览。

本地机器

在浏览器中，转到 http://localhost:8080

您会看到五个问候语之一：“Hello World”、“Hallo Welt”、“Hola mundo”、“Salut le Monde”或“Ciao Mondo”。如果您使用其他浏览器或无痕模式打开网页，语言会更改。您可以在 Google Cloud Console 中查看和修改会话数据。
要停止 HTTP 服务器，请在终端窗口中按 Control+C。

在 App Engine 上部署并运行

通过 App Engine 标准环境，您可以构建和部署在繁重负载和大量数据的压力下仍能可靠运行的应用。

本教程使用 App Engine 标准环境来部署服务器。

在您的终端窗口中，创建一个 app.yaml 文件并复制以下内容：

sessions/app.yaml

在 GitHub 上查看
```
runtime: python37
```
在 App Engine 上部署应用：
```
gcloud app deploy
```
访问 https://your-project-id.appspot.com 以查看实时应用：
```
gcloud app browse
```
其中 your-project-id 是您的 Google Cloud 项目 ID。

现在，问候语由在 App Engine 实例上运行的网络服务器提供。

调试应用

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

检查 gcloud 部署命令是否已成功完成，并且未输出任何错误。如果存在错误（例如 message=Build failed），修复问题，然后再次尝试部署 App Engine 应用。
在 Cloud Console 中，转到日志浏览器页面。

转到“日志浏览器”页面
1. 在最近选择的资源下拉列表中，点击 App Engine 应用，然后点击所有 module_id。您将看到访问您的应用时的请求列表，如果您未发现请求列表，请确认您是否已从下拉列表中选择所有 module_id。如果您发现 Cloud Console 出现错误消息，请检查应用代码是否与“编写 Web 应用”相关部分中的代码匹配。
2. 确保已启用 Firestore API。

清理

删除项目

在 Google Cloud 控制台中，进入管理资源页面。
转到“管理资源”
在项目列表中，选择要删除的项目，然后点击删除。
在对话框中输入项目 ID，然后点击关闭以删除项目。

删除 App Engine 实例

在 Google Cloud 控制台中，转到 App Engine 的版本页面。
转到“版本”
选中要删除的非默认应用版本对应的复选框。
注意：要删除 App Engine 应用的默认版本，只需删除您的项目即可。不过，您可以在 Google Cloud 控制台中停用默认版本。此操作将关停与该版本关联的所有实例。如果需要，您可以稍后重启这些实例。

在 App Engine 标准环境中，只有您的应用采用手动扩缩或基本扩缩服务时，您才能停用默认版本。
如需删除应用版本，请点击删除。

后续步骤

请试用其他 Cloud Functions 教程。
详细了解 App Engine。
试用 Cloud Run，该平台可让您在完全托管式环境或您的自定义 Google Kubernetes Engine 集群中运行无状态容器。

使用 Firestore 处理会话

目标

费用

准备工作

设置项目