Skip to content

Latest commit

 

History

History
89 lines (57 loc) · 3.65 KB

image-registry-settings.mdx

File metadata and controls

89 lines (57 loc) · 3.65 KB

import ImageRegistrySettings from "../partials/image-registry/_image-registry-settings.mdx" import DockerCompatibility from "../partials/image-registry/_docker-compatibility.mdx"

Configuring Local Image Registries

This topic describes how to configure private registry settings in the Replicated KOTS Admin Console.

The information in this topic applies to existing cluster installations with KOTS and installations with Replicated kURL. This topic does not apply to Replciated Embedded Cluster installations.

Overview

Using a private registry lets you create a custom image pipeline. Any proprietary configurations that you make to the application are shared only with the groups that you allow access, such as your team or organization. You also have control over the storage location, logging messages, load balancing requests, and other configuration options. Private registries can be used with online or air gap clusters.

Requirement

The domain of the image registry must support a Docker V2 protocol. KOTS has been tested for compatibility with the following registries:

Configure Local Private Registries in Online Clusters

In online (internet-connected) installations, you can optionally use a local private image registry. You can also disable the connection or remove the registry settings if needed.

To configure private registry settings in an online cluster:

  1. In the Admin Console, on the Registry settings tab, edit the fields:

    Registry Settings

    View a larger version of this image

    The following table describes the fields:

  2. Click Test Connection to test the connection between KOTS and the registry host.

  3. Click Save changes.

Change Private Registries in Air Gap Clusters {#air-gap}

You can change the private registry settings at any time in the Admin Console.

To change private registry settings in an air gap cluster:

  1. In the Admin Console, on the Registry settings tab, select the Disable Pushing Images to Private Registry checkbox. Click Save changes.

    :::note This is a temporary action that allows you to edit the registry namespace and hostname. If you only want to change the username or password for the registry, you do not have to disable pushing the images. :::

  2. Edit the fields as needed, and click Save changes.

    Field Description
    Hostname Specify a registry domain that uses the Docker V2 protocol.
    Username Specify the username for the domain.
    Password Specify the password for the domain.
    Registry Namespace Specify the registry namespace. For air gap environments, this setting overwrites the registry namespace that you pushed images to when you installed KOTS.

  3. Deselect the Disable Pushing Images to Private Registry checkbox. This action re-enables KOTS to push images to the registry.

  4. Click Test Connection to test the connection between KOTS and the private registry host.

  5. Click Save changes.

Stop Using a Registry and Remove Registry Settings

To stop using a registry and remove registry settings from the Admin Console:

  1. Log in to the Admin Console and go to Registry Settings.

  2. Click Stop using registry to remove the registry settings from the Admin Console.