Skip to main content

atmos artifacts catalog remove

Unlist a release from the latest published catalog. The artifact, its signatures, and every consumer lock file are untouched.

Experimental

Usage​

atmos artifacts catalog remove <ref> --repository=<alias> [flags]

Examples​

# Unlist one release
atmos artifacts catalog remove components/terraform/vpc:1.2.0 --repository=shared

Behavior​

Remove only unlists. It deletes no artifact content, no signature, and does not rewrite any lock file, so consumers that pinned the release keep working. When the removed version was the last one of its name, the name is dropped from the catalog. Removal publishes a new catalog revision under the repository's lock when one is available.

Arguments​

ref (required)

name:version of a listed release. A digest reference cannot be unlisted.

Flags​

--repository, -r (required)

Configured repository alias. Its catalog setting selects the catalog. Environment variable: ATMOS_ARTIFACTS_REPOSITORY

--format (optional)

Output format: text (default), json, or yaml. Environment variable: ATMOS_ARTIFACTS_FORMAT

Errors​

Catalog not configured
The repository has no catalog. Nothing is written.
Not listed
The catalog does not exist or does not list that version.

Every failure exits with a nonzero status.

Related​