Documentation
¶
Overview ¶
Package updatepolicy implements the semver-based tag selection used by image-type component builds when the user has set a `update_policy` constraint.
The runner is the single owner of this code path. ctl-api stores and passes the policy string through unchanged; the runner lists tags from the user's source registry, filters/sorts them with this package, and resolves the selected tag to a manifest digest the same way it would for a literal tag.
The package is intentionally tiny and pure: it takes a list of tag strings and a Masterminds-compatible semver constraint, and returns the highest tag that parses as a valid semver and satisfies the constraint. Tags that do not parse as semver (e.g. "latest", "stable", "main") are silently skipped. A constraint that matches zero parseable tags returns ErrNoMatchingTag so the caller can fail the build loudly.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var ErrNoMatchingTag = errors.New("no tags in the source registry match the update_policy constraint")
ErrNoMatchingTag is returned when zero tags in the input list parse as semver and satisfy the constraint. Callers should treat this as a build failure: the user's constraint doesn't match anything in the registry.
Functions ¶
func SelectHighestMatching ¶
SelectHighestMatching returns the tag from tags that:
- parses as a valid semver version, and
- satisfies constraint (a Masterminds-compatible constraint string),
preferring the highest-precedence semver among the matches.
Tags that do not parse as semver are silently skipped (e.g. "latest", "stable", "main"). Returns ErrNoMatchingTag when zero tags match.
The returned string is the original tag as it appeared in the input list, preserving any leading "v" or other formatting the registry used (e.g. input "v1.25.5" → returned "v1.25.5", not "1.25.5").
Types ¶
This section is empty.
Source Files