Skip to main content

atmos version track set

Adjust a tracked dependency's desired version or update policy without editing YAML by hand. Only the settings you specify are changed, and the file's comments and formatting are preserved.

Usage​

atmos version track set NAME [flags]

Arguments​

NAME required
Entry name to update.

Flags​

--desired
Desired version: concrete, SemVer constraint, or latest.
--package
Package coordinate.
--provider
Provider name from version.providers.
--group
Version group name.
--pin
Pin policy: digest, sha, or none.
--include
Candidate version patterns to include. Repeat the flag for multiple patterns.
--exclude
Candidate version patterns to exclude. Repeat the flag for multiple patterns.
--prerelease
Allow or disallow prerelease candidates for this entry.

Examples​

# Move checkout to the v6 desired range
atmos version track set checkout --desired=v6

# Render nginx with an immutable OCI digest
atmos version track set nginx --pin=digest

# Exclude a known vulnerable release and keep prereleases disabled
atmos version track set checkout --exclude=v6.0.0 --prerelease=false

# Move an entry into a group on prod
atmos version track set opentofu --track=prod --group=infrastructure