openapitools/openapi-generator-cli 封装 Java 运行时与 generator 插件，开发者挂载 openapi.yaml 后执行 generate 输出 Java、TypeScript、Go 等 SDK。镜像定位为 ephemeral 代码生成工具，任务结束即退出，不适合 作为长期 HTTP Deployment 或 Kubernetes 常驻服务。与本地 npm @openapitools/openapi-generator-cli 相比容器版 pin 了 JDK 与 generator 版本；大仓库应挂载 spec 与 output 目录，Pipeline 中以 --rm 运行。

快速启动

docker run --rm \
  -v $(pwd):/local \
  docker.io/openapitools/openapi-generator-cli:latest \
  version

推荐实践

docker run --rm \
  -v $(pwd)/spec:/local/spec \
  -v $(pwd)/out:/local/out \
  docker.io/openapitools/openapi-generator-cli:v7.6.0 \
  generate -i /local/spec/api.yaml \
    -g typescript-fetch \
    -o /local/out/ts-client \
    --additional-properties=npmName=@org/api-client

核心参数说明

• -v .../spec:/local/spec — 挂载 OpenAPI 规范文件
• -v .../out:/local/out — 生成代码输出目录
• -g typescript-fetch — 目标语言/generator 名称
• -i /local/spec/api.yaml — 输入 spec 路径
• 固定 tag — generator 与模板版本 pin
• --rm — 生成完成自动清理容器