Skip to main content

Version Groups

version.groups defines batches of related version entries. Groups let you apply shared policy and limit commands such as lock, update, status, and diff with --group.

Configuration​

atmos.yaml
version:
  groups:
    infrastructure:
      ecosystems:
        - toolchain
        - github/actions
        - oci
      patterns:
        - opentofu
        - actions/*
        - nginx
      exclude_patterns:
        - experimental/*
      update:
        strategy: minor
        cooldown: 14d
      exclude:
        - "1.5.*"
      prerelease: false
      labels:
        - infrastructure

Fields​

ecosystems
Match entries by ecosystem.
datasources
Match entries by datasource.
providers
Match entries by provider name.
patterns
Entry-name patterns included in the group.
exclude_patterns
Entry-name patterns excluded from the group.
update, include, exclude, prerelease, labels
Policy applied to entries that match the group.

Examples​

version:
  groups:
    github_actions:
      ecosystems: [github/actions]
      update:
        strategy: minor
        cooldown: 3d
      exclude:
        - "v4.0.0"
atmos version track status prod --group=github_actions
atmos version track update prod --group=github_actions