Skip to main content

Create Registries

Create an artifact registry

An Artifact Registry is a central location for storing and managing software artifacts, such as container images or helm charts used throughout the software development lifecycle. To create one, follow these steps:

  1. First, select + New Artifact Registry under the Registries tab.
  2. Select a registry type.
  3. Enter a Registry Name and optional Description and Labels.
    tip

    This registry name must start with a letter and can only contain lowercase alphanumerics, _, . and -

  4. Select Create Registry.

Create an upstream proxy

An Upstream Proxy for an Artifact Registry is a proxy configuration that allows the registry to fetch artifacts from another external or remote registry. When a user requests an artifact that isn't available in the registry, the registry directs the request to a configured upstream proxy. To create one, follow these steps:

  1. Select the dropdown next to + New Artifact Registry, and then select Upstream Proxy.

  2. Select a registry type.

  3. Enter the Upstream Proxy Key. This is the identifier or name for the proxy within Harness and is chosen by you.

    tip

    This proxy key must start with a letter and can only contain lowercase alphanumerics, _, . and -

  4. Depending on the registry, fill out any other required settings.

    • Enter the proxy Source. Either Docker Hub or a Custom source.
    • If it's a custom source, enter the Docker Remote Registry URL.
  5. Choose your Authentication method.

  6. Select Create Upstream Proxy.

After you've created your upstream proxy you will need to set it in a registry. To learn how to do so, go to Set an upstream proxy.