Skip to main content

Overview

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. In your project, select Artifact Registries, and then select New Artifact Registry
  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 local registry, the registry directs the request to a configured upstream proxy. To create one, follow these steps:

  1. In your project, select Artifact Registries.

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

  3. Select a registry type.

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

    tip

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

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

    1. Enter the proxy Source. Either Docker Hub or a Custom source.
    2. If it's a custom source, enter the Docker Remote Registry URL.

  6. Choose your Authentication method.

  7. Select Create Upstream Proxy.

Set an upstream proxy​

After creating an upstream proxy, you can set it in your local artifact registry. To do so, follow these steps:

  1. In your registry, select Configuration.
  2. Open the Advanced (Optional) dropdown menu.
  3. Select Configure Upstream.
  4. Under Available upstream proxies, you will see a list of available upstream proxies. Select as many as you would like.
  5. Under Selected proxies, you will see an ordered list of selected proxies for this registry. When the registry receives a request, the proxies will be queried in order from top to bottom.

Registry configuration​

To change your registry settings, go to the registry and select Configuration."

Here you can:

  • Change your registry Description.
  • Add a label under Labels.
  • Set an Upstream Proxy under Advanced settings.

Delete a registry​

  1. In Artifact Registries, select the three dots on the right of the registry you want to delete.
  2. Select Delete.

OR

  1. In your registry, select the three dots on the top right next to Setup Client.
  2. Select Delete.