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
| Word | Meaning |
|---|---|
| Artifact | A template, processor, plugin or conflict resolver held in the registry, owned by a user and found by username/name. |
| Artifact version | One numbered release of an artifact, with its own version id and the images and links it was pushed with. |
| Version number | The integer that counts an artifact's pushes - 1, 2, 3; it carries no meaning beyond order. |
| Version id | The GUID of one artifact version; what links, container names and caches point at. |
| Reference pinning | At push, each username/name[:version] reference becomes a fixed version id; no version or 0 means the latest then. |
| Push | Publishing a new artifact version from cyan.yaml with cyanprint push. |
| 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. |
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.