chalkctl registry list¶
Lists the repositories, tags and digests of every endpoint of the cluster's ClusterRegistry, with the endpoints that serve each. A tag's digest is the one most endpoints serve; the command marks an endpoint that lacks the tag, serves it with another digest, or lacks images of a tagged index, which would fail a pull of that platform. Nothing copies images between the endpoints, so the command exits 1 when any is marked or an endpoint cannot be listed; a push of the image to every endpoint mends it. Images pushed by digest alone, without a tag, are not listed.
The registry serves reads to anyone, but chalkctl verifies the endpoints by the OS CA of a client file or the secrets file, so the command needs a client file of any role or the secrets file.
Flags¶
| Flag | Type | Default | Description |
|---|---|---|---|
--config |
string | $CHALKOSCONFIG, else ~/.config/chalkos/config, unless --secrets is given | Client file to authenticate with instead of the secrets file. |
--connect-to |
list of string | — | ENDPOINT=HOST:PORT: reach an endpoint at another address, such as a forwarded port, while still verifying its certificate for the endpoint; may be repeated, once per endpoint. |
--identity |
list of string | ~/.config/chalkos/age.key, ~/.ssh/id_ed25519, ~/.ssh/id_rsa | File holding an age identity to decrypt the secrets with; may be repeated. |
--inventory |
string | $CHALKOSINVENTORY, else chalkos.yaml in the current directory, when it exists | Inventory naming the cluster's nodes, their addresses and their config files. |
--secrets |
string | — | Cluster secrets path (.age, .enc.*, or plaintext), provider URI, or - for standard input. |
Examples¶
See also¶
- chalkctl registry: Manage the images of the cluster registry