在Ubuntu里管理Swagger,可參考以下方法:
可通過包管理器安裝,如sudo apt-get install swagger-jsdoc swagger-ui-express。也可使用npm安裝,先安裝Node.js和npm,再執行npm install -g swagger-ui-express等命令。還能用Docker安裝,拉取鏡像并運行容器,如docker run -p 8080:8080 swaggerapi/swagger-ui-express。
創建swagger.json或swagger.yaml文件,定義API元數據。若使用Express框架,可通過swagger-ui-express中間件集成Swagger UI,示例代碼為app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument))。
在項目中創建swaggerConfig.js等配置文件,通過管理不同版本的API路由文件路徑,來實現Swagger的版本控制。
使用Swagger Editor編輯和查看API文檔,通過訪問http://localhost:8080(默認端口)進行操作。