Quarkus Openapi 扩展：在构建时获取生成的 openapi yml 文件

Question

为了生成客户端库，我将在构建时获取 Quarkus 生成的 openapi yml 文件。

目前，我发现获取它的唯一方法是运行服务器并从 /q/openapi 端点获取它，但在这个过程中必须运行服务器才能获得 spec yml 文件，这有点过分了。

该文件将用作输入，以使用 CI 中的生成器生成客户端库。

Answer 1

您可以设置以下属性：

quarkus.smallrye-openapi.store-schema-directory

在服务器的 application.properties 中

例子：

quarkus.smallrye-openapi.store-schema-directory=target/generated/

将其相对于您的项目文件夹存储在 target/ generated 下。

json 和 yaml 版本都会被存储。

请参阅https://quarkus.io/guides/openapi-swaggerui#quarkus-smallrye-openapi_quarkus.smallrye-openapi.store-schema-directory