Expose a valid OpenApi specification

[nelsonkopliku]

I noticed our openapi spec is not valid (shame on me 😄 )

here are the reasons https://validator.swagger.io/validator/debug?url=http%3A%2F%2Fdemo.trento-project.io%2Fapi%2Fopenapi

{
  "messages": [
    "attribute paths.'/api/clusters/{cluster_id}/checks'(post).parameters.[selected_checks].in is not of type `string`",
    "attribute paths.'/api/runner/callback'(post).parameters.[callback_event].in is not of type `string`",
    "attribute components.schemas.Schema name IP address doesn't adhere to regular expression ^[a-zA-Z0-9\\.\\-_]+$"
  ],
  "schemaValidationMessages": [
    {
      "level": "error",
      "domain": "validation",
      "keyword": "oneOf",
      "message": "instance failed to match exactly one schema (matched 0 out of 2)",
      "schema": {
        "loadingURI": "#",
        "pointer": "/definitions/Operation/properties/parameters/items"
      },
      "instance": {
        "pointer": "/paths/~1api~1clusters~1{cluster_id}~1checks/post/parameters/1"
      }
    }
  ]
}

with these changes we it's green again

[arbulu89]

Nice thing!
How did you generate the swagger validation output? Or is it just this online service?
Maybe we could integrate something like this in our CI

[nelsonkopliku]

Nice thing! How did you generate the swagger validation output? Or is it just this online service? Maybe we could integrate something like this in our CI

Here https://validator.swagger.io/ then you provide the url of a reachable openapi spec.
Because it doesn't work with localhost I cheated and used ngrok and provided this URL https://5faa-79-18-240-47.eu.ngrok.io/api/doc which is basically my machine ™️

We can put to production our machines eheh 😂

Anyway, I believe there should be some validator to be used programmatically, even in CI, but I didn't go there yet.

EDIT:
You can get this url https://validator.swagger.io/validator/debug?url=http%3A%2F%2Fdemo.trento-project.io%2Fapi%2Fopenapi by clicking on the invalid tag on our openapi doc on demo http://demo.trento-project.io/api/doc