Managing Container Image Registries

Container image registries are important components of Neutree’s infrastructure layer, providing the container images required for cluster deployment.

If cluster nodes can connect to Docker-compatible container image registries (such as Docker Hub), after creating a container image registry, clusters will obtain Neutree’s container images from these registries.

If cluster nodes cannot connect to these container image registries, you can manually import container images.

Create Container Image Registry

1. Log in to the Neutree management interface, click Container Image Registries in the left sidebar, and click Create on the right page.

2. Fill in the configuration information.

   • Basic Information

     Parameter	Description	Editable After Creation
     Name	The name of the container image registry.	No
     Workspace	The workspace to which the container image registry belongs.	No

   • Image Registry

     Parameter	Description	Editable After Creation
     URL	The URL of the container image registry. For Docker Hub, the URL is https://docker.io.	Yes
     Repository	The project or repository in the container image registry. Not required for Docker Hub.	Yes

   • Authentication

     Parameter	Description	Editable After Creation
     Username	Username for accessing the container image registry.	Yes
     Password	Password for accessing the container image registry.	Yes

3. After confirming all configuration information is correct, click Save.

Manually Import Container Images

In restricted network environments, you can manually import required container images into Neutree’s container image registry.

Steps

1. Download the Neutree CLI from GitHub Releases according to your server’s CPU architecture:

   # For amd64
   curl -LO https://github.com/neutree-ai/neutree/releases/download/v1.0.0/neutree-cli-amd64
   
   # For aarch64
   curl -LO https://github.com/neutree-ai/neutree/releases/download/v1.0.0/neutree-cli-aarch64

2. Rename and grant executable permissions to the CLI:

   mv neutree-cli-<arch> neutree-cli
   chmod +x neutree-cli

   Replace <arch> with your server’s CPU architecture: amd64 or aarch64.

3. Download the cluster offline image file for the specified accelerator type from GitHub Releases.

4. Upload the cluster offline image to the specified image registry using the CLI tool:

   ./neutree-cli import cluster \
   --package <cluster_package> \
   --mirror-registry <mirror_registry> \
   --registry-username <registry_username> \
   --registry-password <registry_password>

   Parameter	Description
   <cluster_package>	Cluster offline image filename. Static node cluster offline image format: neutree-ssh-<accelerator_type>-v1.0.0-<arch>.tar.gz, where <accelerator_type> is nvidia_gpu or amd_gpu. Kubernetes cluster offline image format: neutree-k8s-v1.0.0-<arch>.tar.gz.
   <mirror_registry>	Image registry address.
   <registry_username>	Image registry username with image upload permissions.
   <registry_password>	Image registry login password or access key (e.g., token).

View Container Image Registry

Log in to the Neutree management interface, click Container Image Registries in the left sidebar, and the container image registry list on the right will display all current registries. Click on a registry name to view details.

Edit Container Image Registry

After creating a container image registry, you can modify the registry URL, repository, and authentication settings as needed.

1. Log in to the Neutree management interface, click the menu icon on the container image registry list or details page, and select Edit.

2. Modify as needed on the configuration page. For parameter descriptions, refer to Create Container Image Registry.

3. After confirming the configuration is correct, click Save to complete the edit.

Delete Container Image Registry

1. Log in to the Neutree management interface, click the menu icon on the container image registry list or details page, and select Delete.

2. In the pop-up dialog, confirm and click Delete. The container image registry will be permanently deleted.