Skip to main content

atmos version track set

Update selected fields of an existing dependency entry in atmos.yaml, preserving comments and formatting. Only flags you pass are changed.

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