Ссылка OpenAPI 3.0.0 на определения в externalFile - PullRequest
Новая
       71

Ссылка OpenAPI 3.0.0 на определения в externalFile

0 голосов
/ 27 мая 2020

У меня проблема с open-api 3.0.0 и swagger-ui.

Я пишу большое определение чванства, и я хотел бы определить параметры и ответы в отдельном файле. В качестве первого подхода я попытался следовать документации (https://swagger.io/docs/specification/using-ref/) и сослался на ответы таким образом: 

    '429':
      $ref: '../common-definitions.yaml#/components/responses/429'

, но это не сработало, даже если путь к файлам согласован ( Я могу переходить по ссылкам в webstorm).

Во второй попытке я погуглил, есть ли у кого-нибудь похожая проблема, и нашел несколько хороших решений, таких как это: https://davidgarcia.dev/how-to-split-open-api-spec-into-multiple-files Я загрузил образцы определений, и я смонтировал их как тома в моем контейнере swagger-ui (да, я использую докеры ...), но я не вижу никакого определения:

Может кто-нибудь помогите мне?

Спасибо, Лаура

Обновление:

Я запускаю свой docker со следующим docker -compose: 

version: "2.1"
services:

  my_swaggerhub_portal:
    build:
      context: .
    image: swaggerapi/swagger-ui:latest
    environment:
      - SWAGGER_JSON=/usr/share/nginx/html/api/openapi.yaml
    volumes:
      - /data/volume1/openapi-boilerplate-master/src:/usr/share/nginx/html/api
    dns: 10.21.1.3
    privileged: true
    container_name: my_swaggerhub_portal
    hostname: my_swaggerhub_portal
    ports:
      - "80:8080"
    networks:
      default:
        ipv4_address: 10.21.20.216
    logging:
      options:
        max-size: 50m
networks:
  default:
    external:
      name: macvlan_net
...