Node.js Bookshelf 应用

Bookshelf 应用是一个用 Node.js 编写的示例 Web 应用,展示了如何使用各种 Google Cloud 产品,包括:

  • App Engine 标准环境
  • Datastore
  • Cloud Storage
  • Pub/Sub

本教程介绍 Bookshelf 示例应用,并讨论了如何使用 Google Cloud 提供的技术和服务来实现此应用的每项功能。

显示控件和图书封面的 Bookshelf 应用的屏幕截图

Bookshelf 示例应用存储了一系列书名。有权访问该应用的任何人都可以修改该列表。借助于该示例应用,用户可以执行以下操作:

  • 查看图书列表。
  • 将图书添加到列表中。
  • 从列表中移除图书。
  • 修改图书详细信息。
  • 上传图书的封面图片。

目标

  • 克隆或下载示例应用。
  • 构建应用并在本地机器上运行该应用。
  • 将该应用部署到 App Engine。
  • 了解示例代码。
  • 了解该应用如何存储结构化数据。
  • 了解该应用如何在 Cloud Storage 中存储二进制数据。

费用

本教程使用 Google Cloud 的计费组件。

本教程涉及几个步骤,每个步骤都由单独的页面进行介绍。 本教程的最后一页介绍了如何清理资源,以避免日后再为相应 Google Cloud 服务支付费用。 如果您决定不完成本教程的所有步骤,请参阅最后一页上的清理说明

准备工作

  1. 要设置您的 Google Cloud 项目,请使用 Cloud Console:
    1. 依次创建 Google Cloud 项目和 App Engine 应用,然后在该项目中启用结算功能。
      转到 App Engine

      当看到提示时,请选择要部署 App Engine 应用的目标区域,然后启用结算功能。创建 Google Cloud 项目后,系统会打开信息中心

    2. 启用 Datastore、Pub/Sub、Cloud Storage JSON、Stackdriver Logging API。

      启用 API

  2. 下载、安装并初始化 Cloud SDK。
    下载 Cloud SDK
  3. 获取本地凭据以用于向 Google Cloud 服务进行身份验证。
    gcloud auth application-default login
  4. 验证您的默认项目是否正确。
    gcloud config list
    如果输出中所列的项目 ID 不是您要在本教程中使用的项目,请设置项目。
    gcloud config set project [YOUR_PROJECT_ID]
    其中,[YOUR_PROJECT_ID] 是您创建或选择用于本教程的项目的 ID。
  5. 克隆示例代码库。

    git clone https://github.com/GoogleCloudPlatform/nodejs-getting-started.git

    或者,也可以下载该示例的 zip 文件并将其解压缩。

本教程假定您熟悉 Node.js 编程,并且已准备好 Node.js 开发环境

教程结构

Bookshelf 教程分为多个部分,分别演示了示例应用如何使用各种 Google Cloud 服务。