Default Container Registry

Storing container images locally.

The Default container registry is a container registry flavor that comes built-in with ZenML and allows container registry URIs of any format.

When to use it

You should use the Default container registry if you want to use a local container registry or when using a remote container registry that is not covered by other container registry flavors.

Local registry URI format

To specify a URI for a local container registry, use the following format:

localhost:<PORT>

# Examples:

localhost:5000

localhost:8000

localhost:9999

How to use it

To use the Default container registry, we need:

Docker installed and running.

The registry URI. If you're using a local container registry, check out

the previous section on the URI format.

We can then register the container registry and use it in our active stack:

zenml container-registry register <NAME> \

--flavor=default \

--uri=<REGISTRY_URI>

# Add the container registry to the active stack

zenml stack update -c <NAME>

You may also need to set up authentication required to log in to the container registry.

Authentication Methods

If you are using a private container registry, you will need to configure some form of authentication to login to the registry. If you're looking for a quick way to get started locally, you can use the Local Authentication method. However, the recommended way to authenticate to a remote private container registry is through a Docker Service Connector.

If your target private container registry comes from a cloud provider like AWS, GCP or Azure, you should use the container registry flavor targeted at that cloud provider. For example, if you're using AWS, you should use the AWS Container Registry flavor. These cloud provider flavors also use specialized cloud provider Service Connectors to authenticate to the container registry.