// Copyright (C) 2019 Storj Labs, Inc. // See LICENSE for copying information. package version import ( "encoding/json" "fmt" "regexp" "strconv" "strings" "time" "github.com/zeebo/errs" "gopkg.in/spacemonkeygo/monkit.v2" "storj.io/storj/pkg/pb" ) var ( mon = monkit.Package() verError = errs.Class("version error") // the following fields are set by linker flags. if any of them // are set and fail to parse, the program will fail to start buildTimestamp string // unix seconds since epoch buildCommitHash string buildVersion string // semantic version format buildRelease string // true/false // Build is a struct containing all relevant build information associated with the binary Build Info ) // Info is the versioning information for a binary type Info struct { // sync/atomic cache commitHashCRC uint32 Timestamp time.Time `json:"timestamp,omitempty"` CommitHash string `json:"commitHash,omitempty"` Version SemVer `json:"version"` Release bool `json:"release,omitempty"` } // SemVer represents a semantic version type SemVer struct { Major int64 `json:"major"` Minor int64 `json:"minor"` Patch int64 `json:"patch"` } // AllowedVersions provides the Minimum SemVer per Service type AllowedVersions struct { Bootstrap SemVer Satellite SemVer Storagenode SemVer Uplink SemVer Gateway SemVer Identity SemVer Processes Processes `json:"processes"` } // Processes describes versions for each binary. type Processes struct { Bootstrap Process `json:"bootstrap"` Satellite Process `json:"satellite"` Storagenode Process `json:"storagenode"` Uplink Process `json:"uplink"` Gateway Process `json:"gateway"` Identity Process `json:"identity"` } // Process versions for specific binary. type Process struct { Minimum Version `json:"minimum"` Suggested Version `json:"suggested"` } // Version represents version and download URL for binary. type Version struct { Version string `json:"version"` URL string `json:"url"` } // SemVerRegex is the regular expression used to parse a semantic version. // https://github.com/Masterminds/semver/blob/master/LICENSE.txt const SemVerRegex string = `v?([0-9]+)\.([0-9]+)\.([0-9]+)` var versionRegex = regexp.MustCompile("^" + SemVerRegex + "$") // NewSemVer parses a given version and returns an instance of SemVer or // an error if unable to parse the version. func NewSemVer(v string) (sv SemVer, err error) { m := versionRegex.FindStringSubmatch(v) if m == nil { return SemVer{}, verError.New("invalid semantic version for build %s", v) } // first entry of m is the entire version string sv.Major, err = strconv.ParseInt(m[1], 10, 64) if err != nil { return SemVer{}, err } sv.Minor, err = strconv.ParseInt(m[2], 10, 64) if err != nil { return SemVer{}, err } sv.Patch, err = strconv.ParseInt(m[3], 10, 64) if err != nil { return SemVer{}, err } return sv, nil } // Compare compare two versions, return -1 if compared version is greater, 0 if equal and 1 if less. func (sem *SemVer) Compare(version SemVer) int { result := sem.Major - version.Major if result > 0 { return 1 } else if result < 0 { return -1 } result = sem.Minor - version.Minor if result > 0 { return 1 } else if result < 0 { return -1 } result = sem.Patch - version.Patch if result > 0 { return 1 } else if result < 0 { return -1 } return 0 } // String converts the SemVer struct to a more easy to handle string func (sem *SemVer) String() (version string) { return fmt.Sprintf("v%d.%d.%d", sem.Major, sem.Minor, sem.Patch) } // New creates Version_Info from a json byte array func New(data []byte) (v Info, err error) { err = json.Unmarshal(data, &v) return v, err } // Marshal converts the existing Version Info to any json byte array func (v Info) Marshal() (data []byte, err error) { data, err = json.Marshal(v) return } // Proto converts an Info struct to a pb.NodeVersion // TODO: shouldn't we just use pb.NodeVersion everywhere? gogoproto will let // us make it match Info. func (v Info) Proto() (*pb.NodeVersion, error) { return &pb.NodeVersion{ Version: v.Version.String(), CommitHash: v.CommitHash, Timestamp: v.Timestamp, Release: v.Release, }, nil } // isAcceptedVersion compares and checks if the passed version is greater/equal than the minimum required version func isAcceptedVersion(test SemVer, target SemVer) bool { return test.Major > target.Major || (test.Major == target.Major && (test.Minor > target.Minor || (test.Minor == target.Minor && test.Patch >= target.Patch))) } func init() { if buildVersion == "" && buildTimestamp == "" && buildCommitHash == "" && buildRelease == "" { return } timestamp, err := strconv.ParseInt(buildTimestamp, 10, 64) if err != nil { panic(verError.Wrap(err)) } Build = Info{ Timestamp: time.Unix(timestamp, 0), CommitHash: buildCommitHash, Release: strings.ToLower(buildRelease) == "true", } sv, err := NewSemVer(buildVersion) if err != nil { panic(err) } Build.Version = sv if Build.Timestamp.Unix() == 0 || Build.CommitHash == "" { Build.Release = false } }