swagger-ui: urls option from custom swagger-config.yaml ignored.

Q&A (please complete the following information)

  • OS: Archlinux
  • Browser: Firefox
  • Version: 76
  • Method of installation: Docker
  • Swagger-UI version: 3.25.3
  • Swagger/OpenAPI version: OpenAPI 3.0

Content & configuration

Swagger-UI configuration options: I tried both yaml and json:

---
urls:
  - name: Master API
    url: specs/master.yaml
  - name: Bot API
    url: specs/bot.yaml
{
    "urls": [
        {
            "name": "Master API",
            "url": "specs/master.yaml"
        },
        {
            "name": "Bot API",
            "url": "specs/bot.yaml"
        }
    ]
}

I looked at the swagger-config.yaml from this repository for reference.

Describe the bug you’re encountering

I have a micro service system with various swagger-specified APIs. My goal was to create a dedicated application, that integrates all the swagger documentation. ron in IRC suggested to use the urls option to configure multuple spec URLs to be selected. So I pulled the swaggerapi/swagger-ui:v3.25.3 image, copied my files in specified the URLS environment variable. As expected: The swagger UI shows the first URL in the list by default and allows to switch between the URLs using a selection in the header. Because we have many APIs, I then tried to use a custom swagger-config.yaml by copying it into the container and specifying CONFIG_URL=swagger-config.yaml with the contents from above.

The UI seems to load the correct swagger-config.yaml (or .json) file, but it still shows the default petstore spec, apparently ignoring the provided urls option.

To reproduce…

Steps to reproduce the behavior:

  1. Copy a swagger spec to /usr/share/nginx/html/specs/ inside the swaggerapi/swagger-ui:v3.25.3 image
  2. Copy a swagger-config.yaml to /usr/share/nginx/html/swagger-config.yaml with the following content:
    ---
    urls:
      - name: Spec
        url: specs/<spec file name>
    
  3. Add ENV CONFIG_URL=swagger-config.yaml to the Dockerfile (or set it while running the container)
  4. Open the swagger UI in the browser

Expected behavior

I’d expect to see the spec from the configured URL

About this issue

  • Original URL
  • State: open
  • Created 7 years ago
  • Reactions: 5
  • Comments: 17 (3 by maintainers)

Most upvoted comments

Just tested, seems like documentation is really outdated. swagger-config.yaml is not supported for now, only swagger-config.json

Also having /usr/share/nginx/html/swagger-config.json is not enough, need to set -e CONFIG_URL=/swagger-config.json additionally while docker run.

$ docker images --digests --filter "reference=swaggerapi/swagger-ui"
REPOSITORY              TAG       DIGEST                                                                    IMAGE ID       CREATED       SIZE
swaggerapi/swagger-ui   latest    sha256:8d3f30b936cf117f83c87379aadc7b7507735a3e899b1d8fcc38f8d0939eee77   ecb990ee92e8   4 weeks ago   101MB

Ha… apparently the switch to JSON was all that is needed… So maybe some documentation is needed here, that Yaml is not supported for the config.

For too fast too furious readers like me, FYI swagger-config.yaml is actually still supported, likely because a once broken support was fixed in #7749

swagger-config.yaml:

---
defaultModelExpandDepth: 6
defaultModelsExpandDepth: 6
docker run --rm -p 8080:8080 -v "${PWD}:/local" -e SWAGGER_JSON=/local/myapispec.yml -e CONFIG_URL=swagger-config.yaml  swaggerapi/swagger-ui

Using CONFIG_URL works for me. Example Dockerfile:

FROM swaggerapi/swagger-ui:latest

COPY swagger/*.json /usr/share/nginx/html/
ENV CONFIG_URL ./swagger-config.json
CMD ["sh", "/usr/share/nginx/run.sh"]

And swagger-config.json:

{
  "urls": [
    {
      "url": "./service1-swagger.json",
      "name": "Service 1"
    },
    {
      "url": "./service2-swagger.json",
      "name": "Service 2"
    }
  ]
}