Add rake task to generate and save OpenAPI 3 spec

Alberto Bignottirequested to merge
581181-openapi3-spec-generation-rake-task into master

What does this MR do and why?

Add rake task to generate and save OpenAPI 3 spec

This commit adds a new rake task (gitlab:openapi:v3:generate) to generate and save the OpenAPI 3.0 specification, with these characteristics:

  • It executes the existing OpenAPI generator
  • It saves the generated output to doc/api/openapi/openapi_v3.yaml
  • It integrates smoothly with the current development workflow

Additionally, it creates also the validate, generate_and_check and check_docs v3 tasks, to mirror the v2 tasks.

References

Screenshots or screen recordings

Before After

How to set up and validate locally

MR acceptance checklist

Evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.

Related to #581181 (closed)

Edited by Alberto Bignotti

Merge request reports