使用$ ref将Openapi YAML配置部署到Google Endpoint

Question

如果Openapi YAML配置从多个文件引用，并将文件存储在文件夹结构中，是否可以将Openapi YAML配置部署到Google端点？

例如：

-\ openapi.yaml
--\service1\service1.yaml
--\service2\service2.yaml
.
.
.

让我们说openapi.yaml在service1.yaml和service2.yaml中有$ ref定义一个或多个定义。

请注意我有大量的文件夹和YAML，以上只是我想要实现的一个例子。

如何使用服务管理将此结构按原样部署到Google Endpoints？

Answer 1

不幸的是，终点＆＃39;支持OpenAPI doesn't handle外部类型引用。即使这样，在gcloud endpoints services deploy中的OpenAPI上载期间也不会保留路径结构。

Answer 2

作为解决方法，您可以使用speccy来完成此任务。它将您的api描述和所有引用合并到单个可部署yaml文件中。 speccy resolve openapi-template.yaml -j -o openapi.yaml 您甚至可以通过添加-j标志将json引用合并到您的yaml文件中。

Speccy是一个npm软件包，因此，显然，您需要有一个node.js环境才能使用它。