Разверните конфигурацию Openapi YAML в конечной точке Google с помощью $ ref

Можно ли развернуть конфигурацию Openapi YAML на конечных точках Google, если она ссылается на несколько файлов, причем файлы хранятся в структуре папок?

Например:

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

Допустим, openapi.yaml содержит $ ref для одного или нескольких определений в service1.yaml и service2.yaml.

Обратите внимание, что у меня есть большое количество папок и YAML, и приведенное выше - всего лишь пример того, чего я пытаюсь достичь.

Как я могу развернуть эту структуру как есть в конечных точках Google с помощью управления службами?


yaml openapi google-cloud-endpoints-v2
person Kenneth Mascarenhas    schedule 19.02.2018    source источник

Ответы (2)


arrow_upward
1
arrow_downward

К сожалению, поддержка OpenAPI конечными точками не поддерживает внешние ссылки на типы. Даже если это так, структура пути не сохраняется во время загрузки OpenAPI в gcloud endpoints services deploy.

person Rose Davidson    schedule 20.02.2018

arrow_upward
0
arrow_downward

В качестве обходного пути вы можете использовать speccy для этой задачи. Он объединяет ваше описание api со всеми вашими ссылками в один развертываемый файл yaml. speccy resolve openapi-template.yaml -j -o openapi.yaml Вы даже можете объединить ссылки json в свой файл yaml, добавив флаг -j.

Speccy - это пакет npm, поэтому для его использования вам, очевидно, понадобится среда node.js.

person Florian Martens    schedule 20.11.2019