Ruby 使用入门

本教程适合在构建云应用方面初学乍练的新手，例如那些希望了解关键应用开发概念，并在将其运用于 Google Cloud 的过程中进行学习的工程师和 Web 开发者。

目标

• 了解基本的 Google Cloud 工具，例如 Google Cloud Console 和 gcloud。
• 将您的应用部署到 App Engine 标准环境。
• 使用 Firestore 保留数据。
• 在 Cloud Storage 中存储上传的文件。
• 使用 Google Cloud 的运维套件监控您的应用。

费用

在本文档中，您将使用 Google Cloud 的以下收费组件：

• App Engine
• Cloud Storage
• Firestore
• Google Cloud 的运维套件

本文档中的说明旨在将您的资源使用量保持在 Google Cloud 的始终免费层级的限制范围内。 您可使用价格计算器根据您的预计使用情况来估算费用。 Google Cloud 新用户可能有资格申请免费试用。

完成本文档中描述的任务后，您可以通过删除所创建的资源来避免继续计费。如需了解详情，请参阅清理。

准备工作

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. 如需在原生模式下创建 Firestore 数据库，请完成以下步骤：
   1. 在 Cloud Console 中，转到 Firestore 查看器页面。
      转到 Firestore 查看器
   2. 从选择一种 Cloud Firestore 模式屏幕中，点击选择原生模式。
   3. 选择 Firestore 数据库的位置。 此位置设置是您的 Cloud 项目的默认 Google Cloud 资源位置。此位置将用于 Cloud 项目中需要位置设置的 Google Cloud 服务，具体地说，包括您的默认 Cloud Storage 存储分区和 App Engine 应用。
      警告：Cloud 项目默认资源位置设置后无法更改。
   4. 点击创建数据库。

7. Enable the App Engine Admin, Cloud Storage, Cloud Logging, and Error Reporting APIs.

   Enable the APIs

8. 克隆示例代码库并在 Cloud Shell 中打开示例应用：
   转到 Cloud Shell

   利用 Cloud Shell，您可以直接在浏览器中通过命令行访问 Google Cloud 资源。

9. 如需将示例代码和更改下载到应用目录，请点击继续。

10. 在 Cloud Shell 中，配置 gcloud 工具以使用新的 Google Cloud 项目：

    # Configure gcloud for your project
    gcloud config set project PROJECT_ID

    将 PROJECT_ID 替换为您使用 Cloud Console 创建的 Google Cloud 项目的 ID。

    Google Cloud CLI 是您从命令行与 Google Cloud 资源进行交互的主要方式。在本教程中，您将使用 gcloud 工具来部署和监控应用。

运行应用

1. 使用 bundler 安装应用依赖项：

   bundle install
   

2. 运行 Rails 服务器：

   GOOGLE_CLOUD_PROJECT=PROJECT_ID bundle exec rails server -p 8080
   

   将 PROJECT_ID 替换为您创建的 Google Cloud 项目的 ID。
3. 在 Cloud Shell 中，点击网页预览 ，然后选择通过 8080 端口预览。此时浏览器会打开一个新窗口，显示出您运行中的应用。

将应用部署到 App Engine

Google Cloud 提供了多种运行代码的方案。在本示例中，您将使用 App Engine 将可伸缩应用部署到 Google Cloud。App Engine 提供零配置部署和零服务器管理，让您可以专注于编写代码。此外，App Engine 会自动扩容以应对突发的流量高峰。

app.yaml 文件是您将应用部署到 App Engine 时使用的主要配置文件：

getting-started/bookshelf/app.yaml

在 GitHub 上查看

runtime: ruby25
entrypoint: bundle exec rackup -p $PORT
instance_class: F2

1. 在您的终端窗口中，使用 gcloud CLI 将应用部署到 App Engine：

   # on the command-line
   gcloud app deploy

2. 在网络浏览器中，输入以下网址：

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

   替换以下内容：

   • PROJECT_ID：您的 Google Cloud 项目 ID
   • REGION_ID：App Engine 分配给您的应用的代码
   
   注意：这个使用 SSL 保护的网域是自动创建的，用于开发过程。您也可以使用 App Engine 设置自定义网域。

如需详细了解如何部署到 App Engine，请参阅 Ruby 2.5 运行时环境。

使用 Firestore 保留数据

您不能在 App Engine 实例中存储信息，因为实例重启时信息会丢失，当新实例创建时该信息已不再存在。所以，您需要一个所有实例都能在其中读写的数据库。

Google Cloud 提供了多种存储数据的方案。在此示例中，您将使用 Firestore 存储每本图书的数据。Firestore 是一种全代管式无服务器 NoSQL 文档数据库，可用于存储和查询数据。Firestore 能够根据您的应用需求自动扩缩，并在不使用时缩减到零个实例。现在添加第一本图书。

1. 在网络浏览器中，输入以下网址：

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

   替换以下内容：

   • PROJECT_ID：您的 Google Cloud 项目 ID
   • REGION_ID：App Engine 分配给您的应用的代码

2. 如需为部署的应用创建图书，请点击添加图书。

   
3. 在书名字段中，输入 Moby Dick。
4. 在作者字段中，输入 Herman Melville。

5. 点击保存。现在您的 Bookshelf 应用有了一个条目。

   
6. 在 Cloud Console 中，点击刷新 来刷新 Firestore 页面。现在数据显示在 Firestore 中。Bookshelf 应用将每本图书存储为具有唯一 ID 的 Firestore 文档，这些文档都存储在一个 Firestore 集合中。在本教程中，该集合称为 books。

Firestore 使用 Firestore 客户端库存储图书。下面是一个提取 Firestore 文档的示例：

getting-started/bookshelf/app/models/book.rb

在 GitHub 上查看

require "google/cloud/firestore"
firestore = Google::Cloud::Firestore.new project_id: project_id
@collection = firestore.col "books"

book_snapshot = collection.doc(id).get
Book.from_snapspot book_snapshot if book_snapshot.data

如需详细了解如何使用 Firestore，请参阅向 Firestore 添加数据。

在 Cloud Storage 中存储上传的文件

现在您已经添加了一本图书，接下来该添加图书封面图片。您不能在实例中存储文件，数据库也不适合图片文件。这时，您就得用上 Cloud Storage 了。

Cloud Storage 是 Google Cloud 的主要 Blob 存储库。您可以使用 Cloud Storage 来托管要在 Google Cloud 中共享的应用资源。如需使用 Cloud Storage，您需要创建一个 Cloud Storage 存储分区，这是一个保存数据的基本容器。

1. 在 Cloud Console 中，转到 Cloud Storage 浏览器页面。

   转到“Cloud Storage 浏览器”页面

2. 点击创建存储分区。
3. 在创建存储分区对话框中输入存储分区的名称：将 Google Cloud 项目 ID 附加到字符串 _bucket 前面，这样名称就显示为 YOUR_PROJECT_ID_bucket。此名称须遵守存储分区名称要求。其他所有字段可以保留默认值。
4. 点击创建。
5. 创建存储分区后，必须将对象设为可公开访问，以供用户查看。如需将对象设为可公开访问，请参阅公开数据。
6. 点击修改图书，然后选择一张图片上传为图书的封面。例如，可以使用图中所示的这张属于公共领域的图片：
   
7. 点击保存。您将被重定向至首页，其中有您 Bookshelf 应用的条目。
   

Bookshelf 应用会使用 Cloud Storage 客户端库将上传的文件发送到 Cloud Storage。

getting-started/bookshelf/app/models/book.rb

在 GitHub 上查看

require "google/cloud/storage"
bucket_id = "#{project_id}_bucket"
storage = Google::Cloud::Storage.new project_id: config["project_id"],
                                     credentials: config["keyfile"]
bucket = storage.bucket bucket_id

注意：您可以更改存储桶名称，只需将上述代码中的 bucket_id 变量设置为不同的名称，然后通过运行 gcloud app deploy 重新部署应用。

如需详细了解如何使用 Cloud Storage，请参阅方法指南列表。

使用 Google Cloud 的运维套件监控您的应用

您已经部署了应用，创建并修改了 books 集合。如需为用户监控这些事件，可以使用 Application Performance Management。

使用 Cloud Logging 监控日志

Cloud Console

1. 在浏览器中转至应用中的 /logs 网址。

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

   这将向 Cloud Logging 发送一个自定义条目。该条目的日志严重性为 NOTICE，其中包含消息“Hey, you triggered a custom log entry. Good job!”。

2. 转到日志查看器，您可以在其中实时监控应用。如果出现问题，这是应该首先查看的地方之一。
   
3. 在资源下拉列表中，选择 GAE Application。
4. 在日志下拉列表中，选择所有日志。

   将有一行显示您的自定义日志条目。

   

gcloud

1. 在终端窗口中，使用 Google Cloud CLI，通过监听新日志条目来监控应用日志：

   gcloud app logs tail

2. 在浏览器中转至应用中的 /logs 网址。

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

   这将向 Cloud Logging 发送一个自定义条目。该条目的日志严重性为 NOTICE，其中包含消息“Hey, you triggered a custom log entry. Good job!”。

   gcloud 命令的输出会显示新的日志条目：

   Waiting for new log entries...
   2019-03-27 22:17:01 default[20190327t151430]  "Hey, you triggered a custom log entry. Good job!"

使用 Error Reporting 监控错误

1. 在 Cloud Console 中，转到 Error Reporting 页面。
   转到“Error Reporting”页面
   Error Reporting 可突出显示应用中的错误和异常，您还可以设置相关的提醒。
2. 在浏览器中，转到应用中的 /errors 网址。
   

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

   这会生成一个新的测试异常并发送至 Google Cloud 运维套件。

3. 在 Cloud Console 中，返回到 Error Reporting 页面，很快就可以看到这个新错误。点击自动重新加载，这样就无需手动刷新页面。

   

注意：应用性能管理中有许多可帮助调试和监控应用的工具。如需了解详情，请参阅教程。

清除数据

为避免因本教程中使用的资源导致您的 Google Cloud 帐号产生费用，请删除包含这些资源的项目，或者保留项目但删除各个资源。

删除项目

注意：删除项目会产生以下影响：

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目可以帮助您避免超出项目配额限制。

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

后续步骤

• 将应用部署到 Google Kubernetes Engine
• 将应用部署到 Compute Engine
• 使用 Firestore 处理会话