We have versioned APIs for our services and we want each version to be documented in Compass Api Specifications section of a component (which is web service)
I do not see possibility to do that, as currently Compass can display only one version. Am I missing something?
That other question was more about how to track release versioning between Jira and Compass, while this question is about a Service component in Compass needing the ability to have multiple versions of its API.
This one-to-many relationship between a Service and an API version is ubiquitous in API management platforms (Apigee, Azure APIM, everybody else), source code systems (Git, etc.) and even other component catalogs competing with Compass (Backstage, etc.). But for some reason API versioning isn't part of Compass's model.
But is there a workaround? Like, are folks creating a separate copy of the service component in Compass for each version, which is non-ideal (implies there are multiple services when they are the same service, just with multiple API versions; loses the link between them).
My team decided to have Compass only reflect the latest API version for a service, but that won't work for teams with services that support multiple API versions in parallel at the same time.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.