Skip to main content

Cosmo Reg

Cosmo reg allows users to interact with OCI compliant registries and their artifacts. A user may pull artifacts from the registry to use in their constellation. They may also push their own projects to registries to use in various constellations.Following are the subcommands available under cosmo reg.

  • push
  • pull
  • ping

push​

Push an artifact to an OCI compliant registry. By default it is pushed to the Cosmonic registry at registry.cosmonic.sh. You may provide your own registry URL using the --url flag.

Usage​

cosmo reg push wasmcloud.azurecr.io/example:0.0.1 /path/to/artifact

Options​

--url URL to push artifact to

--config (Alias -c) Path to config file, if omitted will default to a blank configuration

--output (Alias -o) Specify output format (text or json) [default: text]

--allow-latest Allow latest artifact tags

--annotation (Alias -a) Optional set of annotations to apply to the OCI artifact manifest

--user (Alias -u) OCI username, if omitted anonymous authentication will be used [env: COSMO_REG_USER]

--password (Alias -p) OCI password, if omitted anonymous authentication will be used [env: COSMO_REG_PASSWORD]

--insecure Allow insecure (HTTP) registry connections

pull​

Pull an artifact from an OCI compliant registry

Usage​

cosmo reg pull wasmcloud.azurecr.io/echo:0.3.7

Options​

--destination File destination of artifact

--output Specify output format (text or json) [default: text]

--digest (Alias -d) Digest to verify artifact against

--allow-latest Allow latest artifact tags

--user (Alias -u) OCI username, if omitted anonymous authentication will be used

--password OCI password, if omitted anonymous authentication will be used

--insecure Allow insecure (HTTP) registry connections

ping​

Ping (test url) to see if the OCI url has an artifact

Usage​

cosmo reg ping wasmcloud.azurecr.io/echo:0.3.7

Options​

--output Specify output format (text or json) [default: text]

--user (Alias -u) OCI username, if omitted anonymous authentication will be used

--password OCI password, if omitted anonymous authentication will be used

--insecure Allow insecure (HTTP) registry connections