目录结构

API服务通常用.proto文件来定义API接口，用.yaml文件来配置API服务。

每个API在API仓库中必须有一个API目录，该目录包括它的定义文件和构建脚本。

API目录应该有如下的标准层级：

• API目录

  • 仓库基础

    • BUILD - 构建文件

    • METADATA - 构建元数据文件

    • OWNERS - API目录所有者

  • 配置文件

    • {service}.yaml - 基准服务配置文件，它是google.api.Service的proto消息的YAML表示。

    • prod.yaml - 生产环境差异化服务配置文件。

    • staging.yaml - 仿真环境差异化服务配置文件。

    • test.yaml - 测试环境差异化服务配置文件。

    • local.yaml - 本地环境差异化服务配置文件。

  • 文档文件

    • README.md - 主要的说明书。它应该包含产品概述、技术描述等等。

    • doc/* - 技术文档文件。它们应该使用Markdown格式。

  • 接口定义

    • v[0-9]*/* - 每个目录包含了一个API的major版本，大体上是proto文件和构建脚本。

    • {subapi}/v[0-9]*/*- 每个{subapi}目录包含了一个子API的接口定义。每个子API可能有它们自己独立的major版本。

    • type/* - proto文件，这些文件包含了不同API、相同API的不同版本，或是API和服务具体实现之间共享的类型。type/*下定义的类型一旦发布了就不能有破坏兼容性的改动。