Skip to content

The registry reef

Every command that runs an image registry in the cluster and publishes to it.

Commands

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