Uploading a Huawei CSI Image

Huawei provides the huawei-csi image for users. For details about how to obtain the image file, see Downloading the Huawei CSI Software Package.

To use the CSI image on the container management platform, you need to import the CSI image to the cluster in advance using either of the following methods:

  • (Recommended) Use Docker to upload the CSI image to the image repository.
  • Manually import the CSI image to all nodes where Huawei CSI needs to be deployed.

Uploading an Image to the Image Repository

The installation of Huawei CSI depends on the following image files provided by Huawei. Import and upload the image files in sequence. For details about how to obtain the image files, see Downloading the Huawei CSI Software Package.

  • huawei-csi-v4.5.0-arch.tar
  • storage-backend-controller-v4.5.0-arch.tar
  • storage-backend-sidecar-v4.5.0-arch.tar
  • huawei-csi-extender-v4.5.0-arch.tar

Prerequisites

A Linux host with Docker installed is available, and the host can access the image repository.

Procedure

  1. Run the docker load -i huawei-csi-v4.5.0-arch.tar command to import the CSI image to the current node.

    docker load -i huawei-csi-v4.5.0-arch.tar 
    
  2. Run the docker tag huawei-csi:4.5.0 repo.huawei.com/huawei-csi:4.5.0 command to add the image repository address to the image tag. repo.huawei.com indicates the image repository address.

    docker tag huawei-csi:4.5.0 repo.huawei.com/huawei-csi:4.5.0
    
  3. Run the docker push repo.huawei.com/huawei-csi:4.5.0 command to upload the CSI image to the image repository. repo.huawei.com indicates the image repository address.

    docker push repo.huawei.com/huawei-csi:4.5.0
    

  • You can also use containerd to import and upload the images.
  • For details about how to import and upload images to the CCE or CCE Agile platform, see the user manual of the platform.

Uploading an Image to a Local Node

If the image has been uploaded to the image repository, skip this section.

Prerequisites

  • The node has the corresponding Huawei CSI image file. For details about how to obtain the image file, see Downloading the Huawei CSI Software Package.
  • Docker or another container engine has been installed on the node.

Procedure

  1. Use a remote access tool, such as PuTTY, to log in to the node where the image is to be imported through the management IP address.

  2. Copy the image directory in the Kubernetes CSI component package to any directory on the current node.

  3. Run the cd image command to go to the image working directory. For details about the tool path, see Table 1.

  4. Run the following commands in sequence to import all Huawei CSI images in the image directory to the local node. In the commands, name indicates the name of a .tar image package.

    Run the following command using the Docker container engine:

    docker load -i <name>.tar
    

    Run the following command using the containerd container engine:

    ctr -n k8s.io image import <name>.tar
    

    Run the following command using the Podman container engine:

    podman load -i <name>.tar
    

    If another container engine is installed on the node, use the image import command for the corresponding container engine.