The registry reef¶
Every command that runs an image registry in the cluster and publishes to it.
Commands¶
nereus registry create main
create asks for a registry, and names who makes itnereus registry create main
create fails when it exists, and lists what to runnereus registry get main
get gives the address an image reference usesnereus registry list
list shows every registry, one line eachnereus registry apply
apply takes files, and waits for the Nereidnereus registry delete main
delete removes the registry and what its Nereid madenereus registry create main
A registry purges, when set, the images no Delivery runsnereus registry repository publish hello
publish pushes an image with the platform's credential
Examples¶
registry-create¶
A registry, through the reef's default Mandate.
nereus registry create main
output
secrets/vaults/registries created
registry/registries/main created (mandate: zot, nereid: zot)
Next steps:
nereus registry get main
registry-create-exists¶
The same name twice.
nereus registry create main
output
✗ registry/registries/main already exists. To change it, run:
# write it as a file, then apply the file
nereus registry create main --dry-run --output yaml > main.yaml
nereus registry apply --from-file main.yaml
registry-get¶
Who runs it, the address to pull from, and whether it is ready.
nereus registry get main
output
NAME NEREID PURGE PULL-ADDRESS READY
main zot 168h localhost:31874 True
credential: secret registries/main-pull (vault registries)
localhost:31874 is a NodePort, for an image reference on this cluster's nodes. Reading it takes the credential above.
Next steps:
nereus registry repository publish hello --registry main --image hello:v1
registry-list¶
Every registry, in alphabetical order.
nereus registry list
output
NAME NEREID PURGE PULL-ADDRESS READY
main zot 168h localhost:31874 True
Next steps:
nereus registry get main
registry-apply¶
Create or update from a file or a folder, and return at once.
nereus registry apply \
--from-file main.yaml \
--wait false
output
registry/registries/main created
Next steps:
nereus registry list
registry-delete¶
Delete it, and wait until it is gone.
nereus registry delete main
output
registry/registries/main deleted
Next steps:
nereus registry list
registry-purge¶
A registry that deletes the images no Delivery runs, a week after they were built.
nereus registry create main \
--purge-unused 168h
output
registry/registries/main created (mandate: zot, nereid: zot; purge: images no Delivery runs, after 168h)
Next steps:
nereus registry get main
repository-publish¶
The first tag of a repository.
nereus registry repository publish hello \
--registry main \
--image hello:v1
output
registry/registries/main/repositories/hello created
registry/registries/main/repositories/hello/tags/v1 published (sha256:ab12…)
Next steps:
kubectl run hello --image localhost:31874/hello:v1