vers tag

vers tag create <name> <commit-id> [-d "description"]
vers tag list                                     # Human-readable
vers tag list -q                                  # Just names
vers tag list --format json                       # Machine-readable
vers tag get <name>
vers tag update <name> --commit <new-commit>      # Move tag
vers tag update <name> --description "..."        # Update description
vers tag delete <name> [<name>...]

vers tag create production abc-123
vers tag create v1.2 abc-123 -d "First stable release"

vers tag list
vers tag list -q
vers tag list --format json | jq '.[] | {name, commit_id}'

vers tag get production
vers tag get production --format json

# Promote a newer commit to production
vers tag update production --commit def-456

# Update the description in place
vers tag update production --description "Post-launch hotfix"

vers tag delete staging
vers tag delete staging preview
vers tag delete $(vers tag list -q)   # nuke all tags

vers build -t myapp:prod .             # -t calls tag create under the hood
vers run-commit myapp:prod             # Boot the latest prod build

COMMIT=$(vers build -q .)
vers tag create staging "$COMMIT"

# ...testing...

vers tag update production --commit "$COMMIT"

vers branch production                 # Branch directly off the tag

COMMIT=$(vers build -q .)
vers tag update latest --commit "$COMMIT"

COMMIT=$(vers build -q .)
vers tag update staging    --commit "$COMMIT"
# ...after testing...
vers tag update production --commit "$COMMIT"

vers tag delete $(vers tag list -q | grep '^test-')

COMMIT=$(vers commit --format json | jq -r .commit_id)
vers tag create v1.2.0 "$COMMIT" -d "stable release, build $(date -u +%Y-%m-%dT%H:%M:%SZ)"