Doc system test

UL

Words: registry

Namespace: durian.cloud/cyanprint/registry

The registry service (zinc) and its web UI (argon) - artifacts, their versions, references between them, and accounts

WordMeaning
ArtifactA template, processor, plugin or conflict resolver held in the registry, owned by a user and found by username/name.
Artifact versionOne numbered release of an artifact, with its own version id and the images and links it was pushed with.
Version numberThe integer that counts an artifact's pushes - 1, 2, 3; it carries no meaning beyond order.
Version idThe GUID of one artifact version; what links, container names and caches point at.
Reference pinningAt push, each username/name[:version] reference becomes a fixed version id; no version or 0 means the latest then.
PushPublishing a new artifact version from cyan.yaml with cyanprint push.
API tokenA named, revocable 64-character key a user makes in the registry UI and the CLI sends as X-API-TOKEN.
Template version linksThe processor, plugin, template and resolver versions a template version was pushed with, by version id.

Artifact

A template, processor, plugin or conflict resolver held in the registry, owned by a user and found by username/name.

  • Do not say: package, module
  • See: Artifact version

Artifact version

One numbered release of an artifact, with its own version id and the images and links it was pushed with.

  • Do not say: release, tag

Example: atomi/web version 5, version id e0…, template image atomi/web-template:5, blob image atomi/web-blob:5.

Version number

The integer that counts an artifact's pushes - 1, 2, 3; it carries no meaning beyond order.

  • Do not say: semver, tag

Version id

The GUID of one artifact version; what links, container names and caches point at.

  • Do not say: template id, id

Not the artifact's own GUID. Example: cyan-template-e0… is named from the version id.

Reference pinning

At push, each username/name[:version] reference becomes a fixed version id; no version or 0 means the latest then.

  • Do not say: dependency resolution, resolve

Full: docs/domain/registry/implementation/reference-pinning.md

Push

Publishing a new artifact version from cyan.yaml with cyanprint push.

  • Do not say: publish, release

API token

A named, revocable 64-character key a user makes in the registry UI and the CLI sends as X-API-TOKEN.

Template version links

The processor, plugin, template and resolver versions a template version was pushed with, by version id.

Template links carry preset answers; resolver links carry config and file globs.