我在 EC2 实例上部署了一组 dockerized 微服务(带有 jersey 应用程序的 spring boot)。每个服务都公开了我需要为其创建规范的 rest api。
作为第一步,我在所有 Spring Boot 应用程序中都包含了 swagger-core,它生成一个 .json/.yaml 文件,并在服务启动时将其作为休息资源在 http 上提供。
我想使用 slate 将所有服务的 api 规范作为单个资源(从单个 json/yaml 文件聚合)通过 http/s 提供。
Slate ( https://github.com/lord/slate ) 使用 markdown 格式来提供静态内容。库 Swagger2Markup 可用于通过聚合每个服务的 api 规范(json/yaml 文件)来生成 markdown 文件(每个服务都有自己的 json/yaml 文件生成)。
使用这个降价文件,我可以使用 slate 默认中间人来构建静态内容并通过 http 提供服务。
问题:什么可以被认为是将此过程无缝集成到 jenkins 构建中的最佳实践。