nginx - 如何更改默认的 swagger.json 文件路径？

Question

我创建了 Ngnix-Consul Docker 设置，引用 https://github.com/nginxinc/NGINX-Demos/tree/master/consul-template-demo .

并创建了许多微服务。因此，只有在添加服务名称后才能访问所有微服务，例如

http://example.com/service_name/get_data

一切正常，然后我想为所有微服务添加 swagger，因此尝试使用以下代码段
我可以通过使用访问 swagger ui

http://example.com/service_name/ui

但问题是我无法在该 ui 中加载 swagger.json，因为它试图访问以下 url 上的 swagger.json

http://example.com/swagger.json

但 json 文件已打开

http://example.com/service_name/swagger.json    

如何更改 swagger.json 的默认路径？

微服务中的应用程序是在 python-flask 中创建的
我试过下面的片段

swagger: "2.0"
    info:
      description: "Add service"
      version: "1.0.0"
      title: "Add Service"
      contact:
        email: "abc@efg.com"
      license:
        name: "s1.0"
        url: "http://sample.com"
    host: "abc.efg.com"
    tags:
    - name: "add service"
      description: "service"
    - name: "delete service"
      description: "data"
    schemes:
    - "http"
    paths:
      /service_name/get_data:

甚至我也尝试在 swagger.yaml 文件中添加 basePath
然后它甚至没有打开swaggerui

swagger: "2.0"
    info:
      description: "Add service"
      version: "1.0.0"
      title: "Add Service"
      contact:
        email: "abc@efg.com"
      license:
        name: "s1.0"
        url: "http://sample.com"
    host: "abc.efg.com"
    basePath: "service_name"
    tags:
    - name: "add service"
      description: "service"
    - name: "delete service"
      description: "data"
    schemes:
    - "http"
    paths:
      /get_data:

更新:

from flask import Flask
import connexion

app = Flask(__name__)
app = connexion.App(__name__)
app.add_api('swagger.yaml')

//apis

if __name__ == "__main__":
    app.run(host='0.0.0.0', port=8090, debug=True)

Answer 1

我自己也有类似的问题。我的解决方案是在 NGINX 级别禁用路径重写，以便微服务接收完整的 url:

前:

Request: 
http://example.com/service_name/get_data

Service sees:
/get_data

后:

Request: 
http://example.com/service_name/get_data

Service sees:
/service_name/get_data

只有这样，您才能在 swagger.yaml 文件中将 basePath 指定为“service_name”:

swagger: "2.0"
    info:
      description: "Add service"
      version: "1.0.0"
      title: "Add Service"
    host: "abc.efg.com"
    basePath: "service_name"