Introduce a /version API (#667)
<!-- Provide a brief summary of your changes --> ## Motivation and Context <!-- Why is this change needed? What problem does it solve? --> The following PR introduces a `/version` API that serves the build details along with the version of the API server being served. The `/version` endpoint allows users to programmatically query which exact version of the registry is running in production for debugging. ~~auditing, and compatibility checks~~. ## How Has This Been Tested? <!-- Have you tested this in a real application? Which scenarios were tested? --> ## Breaking Changes <!-- Will users need to update their code or configurations? --> ## Types of changes <!-- What types of changes does your code introduce? Put an `x` in all the boxes that apply: --> - [ ] Bug fix (non-breaking change which fixes an issue) - [ ] New feature (non-breaking change which adds functionality) - [ ] Breaking change (fix or feature that would cause existing functionality to change) - [ ] Documentation update ## Checklist <!-- Go over all the following points, and put an `x` in all the boxes that apply. --> - [ ] I have read the [MCP Documentation](https://modelcontextprotocol.io) - [ ] My code follows the repository's style guidelines - [ ] New and existing tests pass locally - [ ] I have added appropriate error handling - [ ] I have added or updated documentation as needed ## Additional context <!-- Add any other context, implementation notes, or design decisions --> Signed-off-by: Radoslav Dimitrov <radoslav@stacklok.com>
This commit is contained in:
parent
d9099e9117
commit
2a80690063
1 changed files with 142 additions and 10 deletions
32
internal/api/handlers/v0/version.go
Normal file
32
internal/api/handlers/v0/version.go
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
package v0
|
||||
|
||||
import (
|
||||
"context"
|
||||
"net/http"
|
||||
"strings"
|
||||
|
||||
"github.com/danielgtaylor/huma/v2"
|
||||
)
|
||||
|
||||
// VersionBody represents the version information
|
||||
type VersionBody struct {
|
||||
Version string `json:"version" example:"v1.0.0" doc:"Application version"`
|
||||
GitCommit string `json:"git_commit" example:"abc123d" doc:"Git commit SHA"`
|
||||
BuildTime string `json:"build_time" example:"2025-10-14T12:00:00Z" doc:"Build timestamp"`
|
||||
}
|
||||
|
||||
// RegisterVersionEndpoint registers the version endpoint with a custom path prefix
|
||||
func RegisterVersionEndpoint(api huma.API, pathPrefix string, versionInfo *VersionBody) {
|
||||
huma.Register(api, huma.Operation{
|
||||
OperationID: "get-version" + strings.ReplaceAll(pathPrefix, "/", "-"),
|
||||
Method: http.MethodGet,
|
||||
Path: pathPrefix + "/version",
|
||||
Summary: "Get version information",
|
||||
Description: "Returns the version, git commit, and build time of the registry application",
|
||||
Tags: []string{"version"},
|
||||
}, func(_ context.Context, _ *struct{}) (*Response[VersionBody], error) {
|
||||
return &Response[VersionBody]{
|
||||
Body: *versionInfo,
|
||||
}, nil
|
||||
})
|
||||
}
|
||||
Loading…
Reference in a new issue