使用 gcloud 工具测试应用和管理索引

使用 gcloud 命令行工具,您可在本地测试应用,还可为 Datastore 模式 Firestore 生产实例管理索引。本页介绍了这些活动的典型工作流。

gcloud 工具支持以下工作流:

  1. 为 Datastore 实例创建本地支持,包括目录、所需文件和项目 ID。
  2. 启动 Datastore 模拟器,该模拟器提供 Datastore 生产环境的本地模拟。
  3. 通过应用的模拟器查询生成索引定义。
  4. 将手动创建或生成的索引定义上传到生产数据库实例。
  5. 从生产数据库实例中删除未使用的索引。

使用命令行工具的开发工作流

以下是使用 gcloud 工具的典型工作流:

  1. 启动 Datastore 模拟器

  2. 设置环境变量,以便您的应用了解其正在使用模拟器。

  3. 启动您的应用并针对模拟器进行测试。您需要对模拟器运行应用使用的查询,以便为您的生产数据库实例生成索引。

  4. 使用 indexes create 命令上传所生成的索引,传入本地 index.yaml 文件的路径,如以下示例所示:

    gcloud datastore indexes create ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml
        

    示例路径假定您尚未为 data-dir 选项设置特定目录。如果您已设置特定目录,请修改路径以使用 index.yaml 文件的路径。

  5. 移除环境变量,以便您的应用了解其正在使用生产数据库实例。

  6. 对生产数据库实例运行您的应用。

  7. 一段时间后,您可能不再使用某些索引。这时您可以从生产数据库实例中删除不再使用的索引,具体方法是从本地 index.yaml 文件中移除这些索引,然后调用 indexes cleanup 命令:

    gcloud datastore indexes cleanup ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml
        

    如果您为 data-dir 选项设置了特定目录,请修改示例中的路径以使用 index.yaml 文件的路径。

后续步骤