parsertongue/swagger-codegen-cli

swagger-codegen-cli Docker镜像

镜像概述

这是一个用于https://github.com/swagger-api/swagger-codegen的多平台Docker镜像（https://github.com/clu-ling/docker-swagger-codegen-cli）。swagger-codegen-cli是一款基于OpenAPI规范生成API客户端、服务器存根和文档的工具，本镜像提供容器化部署方式，无需本地安装即可使用其功能。

核心功能与特性

• 多平台支持：适配多种架构，满足不同环境部署需求
• 工具集成：完整集成swagger-codegen-cli功能，包含所有官方生成器
• 即开即用：无需复杂配置，通过Docker命令直接执行代码生成任务
• 文件挂载：支持本地目录挂载，方便处理本地OpenAPI规范文件

使用场景

适用于需要基于OpenAPI规范（原Swagger规范）进行API开发的场景，包括：

• 生成多种编程语言（如Java、Python、JavaScript等）的API客户端
• 创建服务器端框架（如Spring、Node.js等）的存根代码
• 转换OpenAPI规范格式（如YAML与JSON互转）
• 生成API文档

使用方法

基本说明

详细生成器使用说明请参见https://github.com/swagger-api/swagger-codegen#generators。

将OpenAPI YAML转换为OpenAPI JSON

假设OpenAPI规范文件myschema.yml位于本地/path/to/schema目录，执行以下命令进行格式转换：

bash
docker run -it -v /path/to/schema:/app docker.xuanyuan.run/"parsertongue/swagger-codegen-cli:latest" generate -i /app/myschema.yml -l openapi

参数说明：

• -it：以交互模式运行容器
• -v /path/to/schema:/app：将本地/path/to/schema目录挂载到容器内/app目录，实现文件共享
• generate：swagger-codegen-cli的核心生成命令
• -i /app/myschema.yml：指定输入的OpenAPI规范文件路径（容器内路径，对应本地挂载目录中的文件）
• -l openapi：指定生成器类型为openapi，用于OpenAPI规范格式转换

转换后的JSON文件将生成在容器内的当前工作目录，可通过挂载目录获取到本地。