openeuler/swagger-uiThe official Swagger UI docker image.
Maintained by: openEuler CloudNative SIG.
Where to get help: openEuler CloudNative SIG, openEuler.
Current Swagger UI docker images are built on the openEuler. This repository is free to use and exempted from per-user rate limits.
Swagger UI is a collection of HTML, JavaScript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.
Learn more on Swagger UI Website.
The tag of each swagger-ui docker image is consist of the version of swagger-ui and the version of basic image. The details are as follows
| Tag | Currently | Architectures |
|---|---|---|
| 5.30.2-oe2403sp2 | swagger 5.30.2 on openEuler 24.03-LTS-SP2 | amd64, arm64 |
| 5.30.0-oe2403sp2 | swagger 5.30.0 on openEuler 24.03-LTS-SP2 | amd64, arm64 |
| 5.29.1-oe2403sp2 | swagger 5.29.1 on openEuler 24.03-LTS-SP2 | amd64, arm64 |
| 5.21.0-oe2403sp1 | Swagger UI 5.21.0 on openEuler 24.03-LTS-SP1 | amd64, arm64 |
In this usage, users can select the corresponding {Tag} based on their requirements.
Pull the openeuler/swagger-ui image from docker
bashdocker pull openeuler/swagger-ui:{Tag}
Run with an interactive shell
You can also start the container with an interactive shell to use swagger-ui.
docker run -it --rm openeuler/swagger-ui:{Tag} bash
Quick Start Example (HTML Local Version)
{ "openapi": "3.0.0", "info": { "title": "Simple API", "version": "1.0.0" }, "paths": { "/hello": { "get": { "summary": "Say hello", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "example": { "message": "Hello, World!" } } } } } } } } }
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Swagger UI Example</title> <link rel="stylesheet" href="[***]" /> </head> <body> <div id="swagger-ui"></div> <script src="[***]"></script> <script> SwaggerUIBundle({ url: "./swagger.json", // Point to your OpenAPI file dom_id: "#swagger-ui" }); </script> </body> </html>
python3 -m http.server 8080
Then visit:
http://localhost:8080/
You'll see the interactive Swagger UI page. Click /hello → GET → Try it out → Execute, and it will show the example response.
If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images.
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务