feat: generate, merge and publish OpenAPI spec 2

[bcronin90]

WHAT

Generates OpenAPI spec for our extensions, merges it with the upstream docs and publishes it. Hopefully does this automatically and with the correct versions.

WHY

#295

Closes #295

[bcronin90]

This is a successful workflow run:
https://github.com/bcronin90/tractusx-edc/actions/runs/5611012302/jobs/10266762957

I assume the red X-s will go away once DEPENDENCIES are fixed and I rebase. What I cannot test is how the new workflow links up to publish and publish-release. Please review that with care. Thanks.

[bcronin90]

Okay. Everything's green. Feel free to review.

[paullatzelsperger]

The changes in the Dockerfiles should be reverted - the change is already in main. You'll have it after rebasing.

Other comments inline.

[bcronin90]

Once again, successful run here: https://github.com/bcronin90/tractusx-edc/actions/runs/5678365723

I just needed to remove the push trigger afterwards.

[bcronin90]

Newest version, before the rebase, but still: https://github.com/bcronin90/tractusx-edc/actions/runs/5679954414

[paullatzelsperger]

@bcronin90 the tests fail, because the cUrl version has apparently changed on Alpine. Could you please replace 8.2.0-r1->8.2.1-r0 in all Dockerfiles?

This has nothing to do with your PR, the problem is that Alpine doesn't keep old cUrl versions around.

#686 should fix this problem in the future.

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
0.0% Duplication