Skip to main content

atmos artifacts catalog sync

Resolve the releases of an inventory and merge them into the latest published catalog. Entries the inventory does not mention are kept, so sync is safe to run on a schedule.

Experimental

Usage​

atmos artifacts catalog sync --repository=<alias> --input=<inventory> [flags]

Examples​

# Merge an inventory into the published catalog
atmos artifacts catalog sync --repository=shared --input=inventory.yaml

Behavior​

Sync takes the repository's lock when it provides one, reads the latest catalog, resolves each inventory ref, merges the releases, and publishes a new revision. A listed version whose tag now resolves to a different digest is updated and reported under updated. Nothing is removed: use remove to unlist a release.

Flags​

--repository, -r (required)

Configured repository alias the inventory refs are relative to. Its catalog setting selects the catalog. Environment variable: ATMOS_ARTIFACTS_REPOSITORY

--input (required)

An AtmosArtifactInventory manifest listing the releases to merge. Environment variable: ATMOS_ARTIFACTS_INPUT

--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.
Reference not found
An inventory ref does not resolve in the repository. Nothing is written.
Catalog changed
Another writer published between the read and the write. Run the command again, and run only one catalog writer at a time.

Every failure exits with a nonzero status.

Related​