Skip to main content

Image Management

Public Images​

Enter the public image page: On the user homepage, select "Artificial Intelligence > Basic Services > Image Management" to enter the "Public Images" page.

View images: On the public image page, you can view the public images pre-set by the platform and those uploaded by administrators.

Manage images: Administrators can delete public images.

View image details: Click on the image name in the list to view the image details.

Download images: Users can download images.

My Images​

Enter the my images page: On the user homepage, select "Artificial Intelligence > Basic Services > Image Management" to enter the "My Images" page.

View images: On the my images page, you can view the images uploaded by members within the user group.

Manage images: You can view, upload, convert to public images, and delete images.

View image details: Click on the image name in the list to view the image details.

Operate on images: You can upload, delete, verify, and install the dependent packages of the code development environment.

Upload Images​

Upload method: You can use the client to upload images to the platform.

Upload button: Click the "Client Upload" button in the image list.

Supported methods: It supports two methods of uploading images from the local Docker environment and uploading image compressed packages.

Operation steps: You need to download the client and operate according to the upload command instructions.

Client Operations​

Download the client​

Download the client file for the corresponding operating system on the platform (no installation required)

alt text

Add local DNS resolution​

Before using this command-line tool to upload images, you need to modify the hosts. The locations of the hosts files on Linux, Mac, and Windows are organized as follows:

The location of the hosts file on Windows is C:Windows\System32\drivers\etc\hosts. Open this file with administrator privileges and add a line:

10.120.48.20  harbor.internal.com

The locations of the hosts files on Linux and Mac are both /etc/hosts. The modification method is as follows:

sudo vi /etc/hosts
tip

If the image file is on the HPC Phase II platform, it cannot be directly uploaded through this client on the HPC Phase II platform (ordinary users cannot modify the hosts file of the HPC Phase II platform)

Solution:

  • Use the scp command to upload the image file from the HPC Phase II platform to the HPC Phase III platform

  • Upload the Linux version client file to the HPC Phase III platform

  • Upload the image through the client file

Upload the image​

Open the command-line tool and enter the directory where the client file is downloaded.

Copy the upload command provided by the platform and replace ai-cli with the full name of the client file.

Upload command: ai-cli-file image copy --dest-creds {upload token} {src} {dest}

alt text

  • --dest-creds: Required. The upload token. Click the copy button on the upload interface to automatically obtain it.
warning

If the operating system is Windows, the value of this parameter needs to be enclosed in double quotes.

In Linux and macOS systems, it needs to be enclosed in single quotes.

  • {src}: Required. The local image to be uploaded.

    • If uploading a image from the local Docker environment, it is docker-daemon:{image name}:{tag}, and you need to fill in the image name and tag in the Docker environment.

    • If uploading a local image compressed package, it is docker-archive-file:"{local file path to be uploaded}", and you need to fill in the path of the uploaded image file and enclose it in English double quotes.

  • {dest}: Required. The destination of the upload. The upload path will be automatically generated. You need to fill in the name and tag of the uploaded image: docker://{upload path}/{uploaded image name}:{uploaded tag}

Replace ${src_image_name}, {src_image_tag} , {dest_image_name}, and {dest_image_tag} in the command.

Build Images​

Build method: It supports online image building using Dockerfile.

Build button: Click the "Build Image" button in the image list to enter the build task list.

Task management: In the build task list, you can view, filter, create, stop, and delete the tasks of building images.

Create a task: Click the "Create Task" button to enter the build image page and fill in the following parameters:

Image name: Enter the image name.

Image tag: Enter the image tag.

Dockerfile content: Enter the Dockerfile content.

Build parameters: Enter the build parameters.

Image description: Enter the image description.

Default settings: The built image is my image by default, and it can be manually converted into a public image.

Notes

If the built image has the same name and tag as an existing image, the existing image will be overwritten.

The online Dockerfile does not support storage-related instructions such as "COPY" and "ADD".

The "FROM" instruction in the online Dockerfile supports specifying existing images on the platform. Please copy the complete path of the image in the image details.

Install Dependent Packages of the Code Development Environment​

Necessity of installation: If you want to use functions such as Jupyter, SSH, conda, and training index comparison in the code development environment, you need to install the dependent packages of the code development environment for the images uploaded by users.

Installation steps: On the details page of my image, click the "Install" button on the right side of the image version to start the installation.

Notes

Installing the dependent packages of the code development environment will overwrite the original image.

The installation takes a certain amount of time and can be stopped during the process.

It can be used normally after the installation is completed.