Serve SwaggerUI

[feloy]

What type of PR is this:

/kind feature

What does this PR do / why we need it:

Serve a swagger ui from odo dev / odo api-server

Instructions from:
https://ribice.medium.com/serve-swaggerui-within-your-golang-application-5486748a5ed4

Which issue(s) this PR fixes:

Fixes #6986

PR acceptance criteria:

• Unit test

• Integration test

• Documentation

How to test changes / Special notes to the reviewer:

[netlify]

🔨 Deploy Preview deleted from internal cluster!

Name	Link
🔨 Latest commit	94bb453
😎 Deploy Preview	https://odo-dev-pr-6989.odo-test-kubernete-449701-49529fc6e6a4a9fe7ebba9a3db5b55c4-0000.eu-de.containers.appdomain.cloud/

[odo-robot]

OpenShift Unauthenticated Tests on commit ca31923 finished successfully.
View logs: TXT HTML

[odo-robot]

NoCluster Tests on commit ca31923 finished successfully.
View logs: TXT HTML

[odo-robot]

Unit Tests on commit ca31923 finished successfully.
View logs: TXT HTML

[odo-robot]

Validate Tests on commit ca31923 finished successfully.
View logs: TXT HTML

[odo-robot]

Windows Tests (OCP) on commit ca31923 finished successfully.
View logs: TXT HTML

[odo-robot]

OpenShift Tests on commit ca31923 finished with errors.
View logs: TXT HTML

[odo-robot]

Kubernetes Tests on commit ca31923 finished successfully.
View logs: TXT HTML

[odo-robot]

Kubernetes Docs Tests on commit fadd130 finished successfully.
View logs: TXT HTML

[rm3l]

As discussed also, we'll need to add a simple page on odo.dev (under "Advanced Usage") mentioning the API Server and the Swagger UI.

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
1 Code Smell

No Coverage information
0.0% Duplication

[rm3l]

/test odo-ocp4.14-lp-interop-images

[rm3l]

Summarizing 2 Failures:
  [FAIL] odo create/delete/list/set namespace/project tests when namespace is created with -w [It] should list the new namespace when listing namespace
  /go/odo_1/tests/integration/cmd_namespace_test.go:38
  [FAIL] odo devfile deploy command tests when starting with Devfile with autoBuild or deployByDefault components when running odo deploy with some components not referenced in the Devfile [BeforeEach] should create the appropriate resources
  /go/odo_1/tests/helper/helper_cmd_wrapper.go:101

Ran 406 of 956 Specs in 1463.962 seconds
FAIL! -- 404 Passed | 2 Failed | 0 Pending | 550 Skipped

 [odo]  ✗  failed to create service(s) associated with the component: pods "k8s-deploybydefault-true-and-referenced" is forbidden: error looking up service account cmd-devfile-deploy-test723cyz/default: serviceaccount "default" not found

Unrelated issue (hopefully temporary) - but let's keep an eye on this..

odo create/delete/list/set namespace/project tests when namespace is created with -w [It] should list the new namespace when listing namespace
/go/odo_1/tests/integration/cmd_namespace_test.go:36
...
  to contain substring
      <string>: cmd-namespace-test36csz
  In [It] at: /go/odo_1/tests/integration/cmd_namespace_test.go:38 @ 07/21/23 07:21:41.626

Unrelated issue with odo list namespace tests (already reported in #6966)

/override OpenShift-Integration-tests/OpenShift-Integration-tests

[openshift-ci]

@rm3l: Overrode contexts on behalf of rm3l: OpenShift-Integration-tests/OpenShift-Integration-tests

In response to this:

Summarizing 2 Failures:
 [FAIL] odo create/delete/list/set namespace/project tests when namespace is created with -w [It] should list the new namespace when listing namespace
 /go/odo_1/tests/integration/cmd_namespace_test.go:38
 [FAIL] odo devfile deploy command tests when starting with Devfile with autoBuild or deployByDefault components when running odo deploy with some components not referenced in the Devfile [BeforeEach] should create the appropriate resources
 /go/odo_1/tests/helper/helper_cmd_wrapper.go:101

Ran 406 of 956 Specs in 1463.962 seconds
FAIL! -- 404 Passed | 2 Failed | 0 Pending | 550 Skipped

[odo]  ✗  failed to create service(s) associated with the component: pods "k8s-deploybydefault-true-and-referenced" is forbidden: error looking up service account cmd-devfile-deploy-test723cyz/default: serviceaccount "default" not found

Unrelated issue (hopefully temporary) - but let's keep an eye on this..

odo create/delete/list/set namespace/project tests when namespace is created with -w [It] should list the new namespace when listing namespace
/go/odo_1/tests/integration/cmd_namespace_test.go:36
...
 to contain substring
     <string>: cmd-namespace-test36csz
 In [It] at: /go/odo_1/tests/integration/cmd_namespace_test.go:38 @ 07/21/23 07:21:41.626

Unrelated issue with odo list namespace tests (already reported in #6966)

/override OpenShift-Integration-tests/OpenShift-Integration-tests

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.