Carlos Florêncio
79 lines
2.0 KiB
Go
79 lines
2.0 KiB
Go
// Package info serves GET /api/v1/system/info — a small read-only payload
|
|
// describing the running binary (version, build commit, build time) and the
|
|
// Go runtime (version, OS, arch). Powers the System -> About page.
|
|
package info
|
|
|
|
import (
|
|
"crypto/rand"
|
|
"encoding/binary"
|
|
"encoding/hex"
|
|
"net/http"
|
|
"runtime"
|
|
"time"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
)
|
|
|
|
// Response is the JSON payload returned by GET /api/v1/system/info.
|
|
type Response struct {
|
|
Version string `json:"version"`
|
|
Commit string `json:"commit"`
|
|
BuildTime string `json:"build_time"`
|
|
GoVersion string `json:"go_version"`
|
|
OS string `json:"os"`
|
|
Arch string `json:"arch"`
|
|
BootID string `json:"boot_id"`
|
|
StartedAt string `json:"started_at"`
|
|
}
|
|
|
|
// Service composes the static build info; instantiated once at boot from
|
|
// cmd/kandev (which owns the ldflag-injected variables) and reused per
|
|
// request.
|
|
type Service struct {
|
|
Version string
|
|
Commit string
|
|
BuildTime string
|
|
BootID string
|
|
StartedAt time.Time
|
|
}
|
|
|
|
// NewService constructs a Service from the ldflag-injected build values.
|
|
func NewService(version, commit, buildTime string) *Service {
|
|
return &Service{
|
|
Version: version,
|
|
Commit: commit,
|
|
BuildTime: buildTime,
|
|
BootID: newBootID(),
|
|
StartedAt: time.Now().UTC(),
|
|
}
|
|
}
|
|
|
|
// Info renders the response payload.
|
|
func (s *Service) Info() Response {
|
|
return Response{
|
|
Version: s.Version,
|
|
Commit: s.Commit,
|
|
BuildTime: s.BuildTime,
|
|
GoVersion: runtime.Version(),
|
|
OS: runtime.GOOS,
|
|
Arch: runtime.GOARCH,
|
|
BootID: s.BootID,
|
|
StartedAt: s.StartedAt.Format(time.RFC3339Nano),
|
|
}
|
|
}
|
|
|
|
// Handler returns the gin handler for GET /api/v1/system/info.
|
|
func Handler(s *Service) gin.HandlerFunc {
|
|
return func(c *gin.Context) {
|
|
c.JSON(http.StatusOK, s.Info())
|
|
}
|
|
}
|
|
|
|
func newBootID() string {
|
|
var b [16]byte
|
|
if _, err := rand.Read(b[:]); err != nil {
|
|
binary.BigEndian.PutUint64(b[8:], uint64(time.Now().UTC().UnixNano()))
|
|
}
|
|
return hex.EncodeToString(b[:])
|
|
}
|