openapi - Quarkus Openapi 扩展 : Get the generated openapi yml file at build time

Question

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

目前我发现获取它的唯一方法是运行服务器并从/q/openapi 端点获取它，但在这个过程中必须运行服务器只是为了拥有规范 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