Image Registration and Management

Registering an Image

1. Log in to the ModelArts console. In the navigation pane on the left, perform the following operations:
   • New console: Choose Asset Management > Images. In the Registered Images tab, click Register.
   • Old console: Choose Asset Management > Image Management. In the Registered Images tab, click Register.
2. On the Register Image page, set the following parameters and click Register Now.
   Figure 1 Registering an Image
   

   Table 1 Parameters

   Parameter	Description
   SWR Source	Use one of the following methods to configure the image source: Method 1: Enter the image path. Example path: <swr-domain-name>/<namespace>/<repository>:<tag> Method 2: Click , select an image from either SWR or SWR Enterprise Edition tab, and click OK. For details about SWR images, see What Is SWR?
   Tags	Specify tags for the image. You can add a maximum of 20 tags.
   Version Description	Enter a description for the image version. It can contain up to 256 characters and cannot include the following special characters: &<>"'/
   Architecture	Select ARM or x86_64 based on your requirements. The architecture must match that of the image source.
   Type	Select NPU, CPU, or GPU based on your requirements. The type must match that of the image source.
   Specifications	Select the target specifications for the image.
   Image Description	Provide detailed information for the uploaded custom image. Only .md files with a size no more than 32 KB can be uploaded. It can contain a maximum of 30,000 characters. Click Add to upload a .md file. You can modify an uploaded .md file or write one directly. Example: # Primary functions ... # Version differences ... # Usage instructions ... The image details will be displayed in the Overview tab.

   You can view the registered image in the Registered Images tab.

   

Adding an Image Version

Editing a Registered Image

1. In the Registered Images tab, use either of the following methods to edit a registered image:
   For details about the parameters, see Table 1.

   • Method 1:
     1. In the Operation column of the target image, click Edit.
     2. On the Edit Image panel, configure the image description and tags as required, and click OK.
   • Method 2:
     1. Click the name of the target image. In the upper right corner of the page, click Edit.
     2. On the Edit Image panel, configure the image description and tags as required, and click OK.

   Figure 2 Editing an image
   
2. View the edited image description and tags.
   • Viewing the edited image details: In the Registered Images tab, click the name of the target image. You can then view the image details in the Overview tab.
   • Viewing the edited tags: in the Registered Images tab, locate the Tags column and hover your mouse over to view the updated tags.

Creating a Notebook Instance Using a Registered Image

1. In the Registered Images tab, click the target image name and choose Versions.
2. In the version list, locate the target image version and click Create Notebook in the Operation column.
3. On the Create Notebook page, configure the required information, select the agreement, and click Next.

   For details about the parameters, see Creating a Notebook Instance.

Adding Overview Information

As shown in the following figure, if no image description were configured during registration, the Overview tab will display No overview information available. You can follow the steps below or edit a registered image (Editing a Registered Image) to add overview information.

Figure 3 Overview

1. In the Registered Images tab, click the target image name. In the Overview tab, click to enter the image description.
2. In the Image Description area, click Add to upload the .md file.

   For details about the .md file and examples, see Table 1.

Synchronizing an Image

Synchronize the image status from SWR.

1. In the Registered Images tab, click the name of the target image.
2. In the Operation column of the version list, click Sync.

   If the message Synchronization status command set successfully is displayed, the image synchronization is successful.

   Figure 4 Synchronizing an image
   

Deleting an Image Version

Deleted versions cannot be restored. After an image is deleted, all instances using this image version will fail to be restarted. Exercise caution when performing this operation.

1. In the Registered Images tab, click the name of the target image.
2. In the Operation column of the version list, click Delete for the target version.
3. In the Delete Version dialog box, enter DELETE and click OK.

   You can delete the associated SWR image version only when the image version is registered using the image saving function of a notebook instance.

   Figure 5 Deleting the associated SWR image version
   

Deleting a Registered Image

Deleted images cannot be restored. After an image is deleted, all instances using this image will fail to be restarted. Exercise caution when performing this operation. This will unbind the SWR image. The original image in SWR will remain intact.

Use either of the following methods to delete a registered image:

• Method 1:
  1. In the Registered Images tab, click Delete in the Operation column.
  2. In the Delete Image dialog box, enter DELETE and click OK.
• Method 2:
  1. In the Registered Images tab, click the name of the target image.
  2. In the upper right corner of the page, click Delete. In the Delete Image dialog box, enter DELETE and click OK.