Skip to main content

Version Files

version.files declares which files carry managed versions. atmos version track apply rewrites those files from the lock file, and verify fails when they drift.

Configuration​

atmos.yaml
version:
  files:
    - manager: github-actions
      paths:
        - .github/workflows/*.yaml
        - .github/workflows/*.yml

    - manager: marker
      paths:
        - Dockerfile
        - scripts/**/*.sh

    - manager: template
      paths:
        - "**/*.tmpl"

When version.files is empty, managers with default paths run over those defaults.

Managers​

github-actions
Rewrites uses: refs in workflow files by matching owner/repo packages.
marker
Rewrites version tokens on lines annotated with atmos:version comments.
template
Renders *.tmpl source files to sibling files using the .version context.

Marker Example​

# atmos:version opentofu
ENV TOFU_VERSION=1.10.6
tofu_version: 1.10.6 # atmos:version opentofu

Use match= when the default token detection is ambiguous:

DOWNLOAD_URL="https://example.com/tool/v1.2.3/tool.tgz" # atmos:version tool match=/tool/(v[^/]+)/tool.tgz

Examples​

atmos version track apply prod
atmos version track apply prod --check
atmos version track apply prod --manager=github-actions