[Security Solution] Merge domain-specific OpenAPI bundles with Kibana bundles

maximpn commented 3 weeks ago

Epic: https://github.com/elastic/security-team/issues/9401 (internal)

Summary

Merge Security domain-specific bundles stored in /x-pack/plugins/security_solution/docs/openapi with Kibana-wide bundles stored in /oas_docs. As a result, we should have two final bundles:

1st one is for all Kibana API endpoints available in ESS, for all API versions.
2nd one is for all Kibana API endpoints available in Serverless, for all API versions.

As the next step, we (Kibana Core, most likely) will need to set up a CI/CD pipeline for deploying these two bundles to bump.sh.

Details

kbn-openapi-bundler is capable of merging OpenAPI specs as a part of the bundling process. It should be modified to expose the merger functionality.

To do

[ ] Expose merge utility function form kbn-openapi-bundler package
[ ] Allow to specify multiple glob patterns for convenient configuration
[ ] Support OpenAPI specs in JSON format
[ ] Handle merging errors

elasticmachine commented 3 weeks ago

Pinging @elastic/security-detections-response (Team:Detections and Resp)

elasticmachine commented 3 weeks ago

Pinging @elastic/security-solution (Team: SecuritySolution)

elasticmachine commented 3 weeks ago

Pinging @elastic/security-detection-rule-management (Team:Detection Rule Management)

elastic / kibana