Install by Using the Web Console

Use Cases

Use the web console installation path for:

  • First-time users who prefer a guided, visual interface.
  • Quick proof-of-concept setups in non-production environments.
  • Teams with limited Kubernetes expertise seeking a simplified deployment process.
  • Scenarios requiring minimal customization (e.g., default storage configurations).
  • Basic networking setups without specific ingress rules.
  • StorageClass configurations for high availability.

Use the YAML installation path when you need advanced S3-compatible storage configuration or specific ingress rules.

Prerequisites

  • Install the Registry Cluster Plugin to a target cluster using the Cluster Plugin mechanism.

Install Registry Using the Web Console

Procedure

  1. Log in and navigate to the Administrator page.
  2. Click Marketplace > Cluster Plugins to access the Cluster Plugins list page.
  3. Locate the Registry Cluster Plugin, click Install, then proceed to the installation page.
  4. Configure parameters according to the following specifications and click Install to complete the deployment.

The parameter descriptions are as follows:

ParameterDescription
Expose ServiceOnce enabled, administrators can manage the image repository externally using the access address. This poses significant security risks and should be enabled with extreme caution.
Enable IPv6Enable this option when the cluster uses IPv6 single-stack networking.
NodePortWhen Expose Service is enabled, configure NodePort to allow external access to the Registry via this port.
Storage TypeSelect a storage type. Supported types: LocalVolume and StorageClass.
NodesSelect a node to run the Registry service for image storage and distribution. (Available only when Storage Type is LocalVolume)
StorageClassSelect a StorageClass. When replicas exceed 1, select storage with RWX (ReadWriteMany) capability (e.g., File Storage) to ensure high availability. (Available only when Storage Type is StorageClass)
Storage SizeStorage capacity allocated to the Registry (Unit: Gi).
ReplicasConfigure the number of replicas for the Registry Pod:
  • LocalVolume: Default is 1 (fixed)
  • StorageClass: Default is 3 (adjustable)
Resource RequirementsDefine CPU and Memory resource requests and limits for the Registry Pod.

Verification

  1. Navigate to Marketplace > Cluster Plugins and confirm the plugin status shows Installed.
  2. Click the plugin name to view its details.
  3. Copy the Registry Address and use a container client (e.g., Podman) to push/pull images.

Update Or Uninstall Registry

You can update or uninstall the Registry plugin from either the list page or details page.