文档中心API Explorer
ZHEN
文档中心›ZVF›ZStack ZSphere›用户手册ZVF

Image Storage

Image storage acts as a repository for storing image templates containing operating systems, as well as disk images. Through image storage, you can share image files across multiple data centers.

This section introduces how to use image storage from the following chapters:

Image Storage Basic Operations

Add a Standalone Image Storage

A standalone image storage stores image files through image slices and supports incremental storage.

Procedure

  1. In the navigation pane, choose Inventory > Image and Template.
  2. Right-click the target data center and choose Add Image Storage.
  3. In the Select Image Storage Type dialog, choose Standalone Image Storage.
  4. Click Next.
  5. In the Add Image Storage dialog, set the following parameters to complete basic configurations:
    1. Set basic information.
      • Name: Image storage name.
      • Description: Image storage description.
      • Type: Displays standalone image storage.
      • Data Center: Current data center.
    2. Set image storage configurations.
      • Image Storage IP: IP address of the image storage server.
      • SSH Port: Default port is 22. Supports setting SSH port.
      • Username: Default is root user. Supports setting regular user.
      • Password: Password for the user.
  6. Click Next.
    The system will test connectivity to the image storage IP.
  7. Set the following parameters to complete storage configuration:
    1. Set disk configurations.
      • Addition Method: Supports Free Disk and Local Directory addition methods.
        When selecting Free Disk, configure the following parameter:
        • Free Disk: Add the unmounted or unpartitioned disks on image storage.
          Note: Configuring a free disk will format the selected disk, completely clearing all partitions, file systems, and data on the disk.
      • Mount Path: Absolute path for mounting storage on image storage.
        Note: Do not use system directories such as /, /dev/, /proc/, /sys/, /usr/bin, /bin. Using system directories might cause image storage unable to work properly.
      • Retrieve Existing Images: Default: disabled. If enabled, retrieves existing image files from the mount path in this image storage.
      • Image Sync Network: The network CIDR used for image synchronization between standalone image storage within the same management node. If not specified, the management network is used by default. If both the source and target image storage set this parameter, only the image sync network of the target image storage takes effect.
      • Data Network: The network CIDR used for data communication between compute nodes and the image storage. If not specified, the management network is used by default.
    2. Configure advanced settings.
      • Reserved Capacity for Image Storage: Default: 1 GB. The capacity reserved for use by the image storage.
      • Image Blob Upload Concurrency: Default: 1. Specify the blob upload concurrency when you upload an image. Valid range: 1 to 16.
      • Image Blob Download Concurrency: Default: 1. Specify the blob download concurrency when you download an image. Valid range: 1 to 16.
  8. Review the configuration and click OK.

Add a Distributed Image Storage

A distributed image storage stores image files through distributed block storage.

Procedure

  1. In the navigation pane, choose Inventory > Image and Template.
  2. Right-click the target data center and choose Add Image Storage.
  3. In the Select Image Storage Type dialog, choose Distributed Image Storage.
  4. Click Next.
  5. In the Add Image Storage dialog, set the following parameters:
    1. Set basic information.
      • Name: Image storage name.
      • Description: Image storage description.
      • Type: Displays distributed image storage.
      • Data Center: Current data center.
    2. Set image storage configurations.
      • Monitoring Node: Add a monitoring node by specifying the monitoring node IP, SSH port, username, and password.
      • Image Storage Pool: You can create a storage pool in the distributed storage cluster in advance and enter the UUID of the pool. If left blank, a default image storage pool is created automatically.
      • Data Network: The network CIDR used for data communication between compute nodes and the image storage. If left blank, the management network is used by default.
    3. Configure advanced settings.
      • Reserved Capacity for Image Storage: Default: 1 GB. The capacity reserved for use by the image storage.
      • Image Blob Upload Concurrency: Default: 1. Specify the blob upload concurrency when you upload an image. Valid range: 1 to 16.
      • Image Blob Download Concurrency: Default: 1. Specify the blob download concurrency when you download an image. Valid range: 1 to 16.
  6. Review the configuration and click OK.

Manage an Image Storage

Modify an Image Storage

  1. Navigate to Menu > Image Storage.
  2. Right-click the image storage and select the action you want to perform from the list of actions that appears.
    • If you need to edit the name and description of the image storage, select Edit Name and Description.
    • If you need to modify the configuration information of the image storage, select Modify Configuration.
    • If you need to update the password for the image storage, select Update Password. After updating, you need to manually reconnect the image storage for the changes to take effect.

View Image Storage Usage

If you need to understand the storage usage information of the image storage, you can navigate to the image storage detail page to view the usage information. You can also clean up invalid data that has been permanently deleted and expired temporary data in the image storage based on your actual situation by clicking Actions > Data Cleanup.
Note: Deleting an image file completely and deleting virtual machines created using that image completely allows you to execute a data cleanup operation to release storage space on the image storage. During data cleanup, please avoid performing data write-related operations.

Delete an Image Storage

If you need to delete an existing image storage, on the target image storage page, click Actions > Delete to delete it. You can also delete image storage in bulk on the data center Image Storage sub-page.

Image Basic Operations

Add an Image

You can add various formats of system images or disk images to the image storage. When creating a virtual machine for the first time, the system will download the image to the data storage as an image cache. Using a URL or by uploading locally, you can add QCOW2, ISO, RAW, and VMDK image files to the image storage.

Procedure

  1. In the navigation pane, choose Inventory > Image and Template.
  2. Right-click the target image storage and choose Add Image.
  3. In the Add Image dialog, set the following parameters:
    • Image Storage: The current image storage
    • Name: Image name
    • Description: Image description
    • Image Type: Image type, including system images and disk images
    • Image Format: Different types of images support different image formats, including .qcow2, .iso, .raw, and .vmdk formats
    • Image Path: Add an image through a URL path or by uploading a local file
      • URL: Supports adding an image via HTTP/HTTPS/FTP/SFTP format or through an absolute path on a single-node image repository
      • Upload File: Choose a file that matches the selected image format and is accessible by the current browser to upload directly
  4. Review the configuration and click OK.

Synchronize Images

About this task

Within the same management node, you can synchronize one or multiple images from a standalone image storage to the specified standalone image storage.

By default, image synchronization between image storage uses the management network. You can set a dedicated image sync network when adding an image storage or modifying image storage settings to reduce management network load. When both source and target image storage have set image sync networks, only the image sync network of the target image storage takes effect during the actual synchronization.

Procedure

  1. In the navigation pane, choose Inventory > Image and Template.
  2. Select the target image storage.
  3. On the image storage details page, click Image.
  4. On the Image tab, select target images.
  5. Click Bulk Action > Synchronize Image.
  6. In the Synchronize Image dialog, select the target standalone image storage.
  7. Click OK.

Migrate an Image

Before you begin

  • You can migrate images between distributed image storage.
  • Before migrating images, ensure the network connectivity between the monitoring nodes of the two distributed image storage.
  • When migrating an ISO image across data centers, virtual machines using the ISO image need to detach the ISO image before they can start normally.

Procedure

  1. In the navigation pane, choose Inventory > Image and Template.
  2. Right-click the target image and choose Change Image Storage.
  3. In the Change Image Storage dialog, select the target distributed image storage.
  4. Click OK.

What to do next

After migration, the original image data remains in the image storage. You can manually clean up the data in the image storage. Once cleaned up, the data cannot be recovered. Proceed with caution.

Delete an Image

Before you begin

(Optional) The platform provides deletion protection for images. You can define how resources are deleted by customizing the deletion policy in system parameters. By default, the platform adopts a delayed deletion for Image deletion policy (retained for 3 days). Deleted resources are first moved to the recycle bin and permanently deleted after the retention period. For more information, see System Parameters.

Procedure

  1. In the navigation pane, choose Inventory > Image and Template.
  2. Select the target image.
  3. On the image details page, click Actions > Move to Recycle Bin.
    To delete multiple images, go to the image storage's image tab, select the VMs you want to delete, and then click Bulk Action > Move to Recycle Bin.
    The delete button label changes based on the Image Deletion Policy. When the deletion policy is set to immediate deletion, the button appears as "Delete". When the deletion policy is set to delayed deletion or never delete, the button appears as "Move to Recycle Bin".
  4. After acknowledging the risk, click OK.

Image Cross-Platform Usage

Export Image

Select an image and export it. The exported image will appear in the Export List tab of the root node. Once an image has been exported, it cannot be exported again.

Procedure

  1. In the navigation pane, choose Inventory > Image and Template > Image Files.
  2. Right-click the target image file, then select Export Image.
  3. In the Export Image dialog, choose the export method, and then click OK.
    Note:
    • For large image files, it is recommended to select export only. After exporting, you can go to the export list page to view and download.
    • For medium and small image files, you can directly choose to export and download.

Export VM as OVA Template

Export a virtual machine in the .ova file format to a standalone image storage within the same data center. The exported OVA template does not include ISO drives or GPU devices.

Before you begin

Before exporting an OVA template, ensure that the virtual machine is powered off.

Procedure

  1. In the navigation pane, choose Inventory > Host and VM.
  2. Right-click the target virtual machine, then select Template > Export OVA Template.
  3. In the Export OVA Template dialog, choose the export method and image storage, and then click OK.
    Note:
    • For large VM files, it is recommended to select export only. After exporting, you can go to the export list page to view and download.
    • For medium and small VM files, you can directly choose to export and download.
  4. After the export completes, click Inventory > Root Node.
  5. Click Export List to view the exported VM OVA template.
    图 1. View the Exported VM OVA Template


上一篇Host下一篇Virtual Machine