Skip to main content

Version Defaults

version.defaults sets shared policy for managed versions. Track defaults, entry fields, and group policies can override these values.

Configuration​

atmos.yaml
version:
  defaults:
    update:
      strategy: patch
      cooldown: 14d
    include:
      - "v1.*"
    exclude:
      - "*-rc*"
      - "*-beta*"
    prerelease: false
    labels:
      - dependencies

Fields​

update.strategy
Maximum update scope: major, minor, patch, or pin.
update.cooldown
Minimum release age before an update is eligible, such as 14d, 2w, or 36h.
update.pin
Artifact form to render. Use digest or sha for immutable identifiers, or none for plain versions.
include
Candidate version patterns to allow. When set, versions must match at least one pattern.
exclude
Candidate version patterns to block. Excluded versions cannot be selected, even when requested directly.
prerelease
Whether prerelease candidates are eligible. Defaults to false.
labels
Metadata labels for downstream workflows and reports.

Example​

version:
  defaults:
    update:
      strategy: minor
      cooldown: 7d
    exclude:
      - "*-alpha*"
    prerelease: false