AI Controller

Compute Management

Add and delete nodes, download container images, and manage Docker permissions in AI Controller

In the following guide, you will go through the creation of a compute resource and managing user-level permission of compute and AI models.

Adding a Node

The Add Node feature in the Qubrid AI Controller dashboard allows administrators to add new worker nodes to the system. This expands the AI infrastructure, improving scalability and performance. Only users with administrative privileges can use this feature.

Prerequisites:

  1. Qubrid AI Worker Node Package: The package must be pre-installed on the target node before it can be added
  2. Ping Enabled: The node's IP address must be reachable with ping enabled
  3. Administrative Access: Only admin users can add nodes

Access the Dashboard

Log in to the Qubrid AI Controller as an admin and go to the Dashboard.

Press the Add Node button

Click the Add Node button. A pop-up will appear with the required fields.

Fill in node details

The pop-up will prompt you for the following:

  1. Node Name: Enter a unique name for the node
  2. IP Address: Enter the node's IP address. The system will ping the address to check connectivity
  3. Hostname: Enter the server's hostname

Confirm node addition

After filling in the details, the system will verify the IP address by pinging it. If successful, click Add Node to finalize the process. The node will appear in the Nodes List on the dashboard.

Delete the Node

The Delete Node feature in the Qubrid AI Controller dashboard allows administrators to remove a node from the system. This action is irreversible and will disconnect the node from the infrastructure, freeing up resources. Only users with administrative privileges can delete a node.

Prerequisites:

  • Administrative Access: Only admin users can perform this action
  • Node Status: Ensure that the node you wish to delete is not actively processing tasks. Deleting an active node can disrupt ongoing operations

Access the Dashboard

Log in to the Qubrid AI Controller as an admin and navigate to the Dashboard.

Locate the node

In the Nodes List, find the node you wish to delete.

Press the Delete button

Next to the node, click the Delete button. A confirmation prompt will appear asking if you are sure you want to delete the node.

Confirm deletion

To confirm, press the Delete button again. The node will be removed from the system and no longer appear in the Nodes List.

Downloading a container image to the local server

This feature allows administrators to download Docker images either from the internal catalog or directly from Docker Hub public images. Below are the two options available.

Download from the Catalog

Administrators can easily download Docker images that have been pre-registered and stored within the internal catalog.

To download an image from the catalog, follow these steps:

Open the Image section

Navigate to the Image section.

Search for the image

Search for the desired Docker image by name or tag.

Select the node

Select the Node on which the admin wants to download the image.

Download

Click on the Download button next to the image you wish to retrieve. The Docker image will be pulled directly from the Qubrid ECR repository and made available for use.

All these images are pulled from the Qubrid repository. Downloading will take a time range from 3-10 minutes, depending on the internet speed.

After a successful download, the admin can confirm the downloaded image in the Local section.

Only the user can run these images; all the running containers against the user are visible in the Container section.

Adding custom images from the Docker repository

If the Docker image you require is not available in the internal catalog, you can opt to download it directly from Docker Hub's public repository.

To download from Docker Hub:

Create your own image

Open the Image section and click on the Create your own Image tile.

Select the node

Select the Node on which the admin wants to download the image.

Enter image details

Enter the Docker Hub image name (for example nginx:latest) and tag (optional). The system will retrieve the image from Docker Hub and make it available in the Local section for use.

Viewing downloaded containers in the Local section

After downloading a Docker image from the internal catalog or Docker Hub, it will automatically be added to the Local section.

To view the downloaded container images:

Open Local

Navigate to the Local section in the Admin Panel.

Review images

Here, you will see a list of all the Docker images that have been downloaded and are available for assignment.

In this version, only public images from the Docker repository can be downloaded.

Managing downloaded Docker images

Once the Docker image is downloaded, it will be displayed in the Local section of the Admin Panel. Administrators can then manage user permissions for these images in the Manage Users section. Only the containers that are assigned to a user by the admin will appear in that user's console.

Administrators have the ability to assign specific Docker images to users via the Manage Users section. This ensures that each user only has access to the images that are relevant to them.

To assign images to users:

Open Manage Users

Go to the Manage users section in the Admin Panel.

Select the user

Select the user account to which you wish to assign Docker images.

Set Docker permission

In the user's profile, you'll find an option Docker permission.

Assign images

From the list of available images, select the Docker images that should be accessible to that user.

Apply changes

Apply the changes.