Offline Upgrade of Container Management Module¶

This page explains how to install or upgrade the Container Management Module after downloading it from the Download Center.

Upgrade from CLI¶

Load Images from the Downloaded Package¶

You can load the images in one of the following two ways. When an image repository exists in the environment, it is recommended to use chart-syncer to synchronize the images to the image repository, as it is more efficient and convenient.

Method 1: Synchronize Images using chart-syncer¶

Using chart-syncer, you can upload the charts and their dependent image packages from the downloaded package to the image repository and helm repository used by the installer when deploying DCE.

First, find a node (e.g., Spark Node) that can connect to the image repository and helm repository. Create a load-image.yaml configuration file on the node and fill in the configuration information for the image repository and helm repository.

1. Create load-image.yaml

   Note

   All parameters in this YAML file are required.

   Helm Repo AddedHelm Repo Not Added

   If the chart repo is already installed in the current environment, chart-syncer also supports exporting charts as tgz files.

   load-image.yaml

   source:
     intermediateBundlesPath: kpanda # The path where the .tar.gz package is located after using chart-syncer
   target:
     containerRegistry: 10.16.10.111 # Image repository address
     containerRepository: release.daocloud.io/kpanda # Image repository path
     repo:
       kind: HARBOR # Helm Chart repository type
       url: http://10.16.10.111/chartrepo/release.daocloud.io # Helm repository address
       auth:
         username: "admin" # Image repository username
         password: "Harbor12345" # Image repository password
     containers:
       auth:
         username: "admin" # Helm repository username
         password: "Harbor12345" # Helm repository password
   

   If the helm repo is not added on the current node, chart-syncer also supports exporting charts as tgz files and storing them in the specified path.

   load-image.yaml

   source:
     intermediateBundlesPath: kpanda # The path where the .tar.gz package is located after using chart-syncer
   target:
     containerRegistry: 10.16.10.111 # Image repository url
     containerRepository: release.daocloud.io/kpanda # Image repository path
     repo:
       kind: LOCAL
       path: ./local-repo # Local path of the chart
     containers:
       auth:
         username: "admin" # Image repository username
         password: "Harbor12345" # Image repository password
   

2. Run the image synchronization command.

   charts-syncer sync --config load-image.yaml
   

Method 2: Load Images using Docker or containerd¶

Unpack and load the image files.

1. Unpack the tar compressed file.

   tar xvf kpanda.bundle.tar
   

   After successful unpacking, you will get 3 files:

   • hints.yaml
   • images.tar
   • original-chart

2. Load the images from the local file to Docker or containerd.

   Dockercontainerd

   docker load -i images.tar
   

   ctr -n k8s.io image import images.tar
   

Upgrade¶

There are two ways to upgrade. You can choose the corresponding upgrade method based on the pre-operation:

1. Check if the container management helm repository exists.

   helm repo list | grep kpanda
   

   If the result is empty or displays the following prompt, proceed to the next step; otherwise, skip the next step.

   Error: no repositories to show
   

2. Add the container management helm repository.

   helm repo add kpanda http://{harbor url}/chartrepo/{project}
   

3. Update the container management helm repository.

   helm repo update kpanda
   

4. Select the version of the container management module you want to install (it is recommended to install the latest version).

   helm search repo kpanda/kpanda --versions
   

   The output will be similar to:

   NAME                   CHART VERSION  APP VERSION  DESCRIPTION
   kpanda/kpanda  0.20.0          v0.20.0       A Helm chart for kpanda
   ...
   

5. Back up the --set parameters.

   Before upgrading the container management module, it is recommended to run the following command to back up the --set parameters of the old version.

   helm get values kpanda -n kpanda-system -o yaml > bak.yaml
   

6. Update the kpanda CRDs.

   helm pull kpanda/kpanda --version 0.21.0 && tar -zxf kpanda-0.21.0.tgz
   kubectl apply -f kpanda/crds
   

7. Run helm upgrade .

   Before upgrading, it is recommended to replace the global.imageRegistry field in bak.yaml with the image repository address you are currently using.

   export imageRegistry={your_image_repository}
   

   helm upgrade kpanda kpanda/kpanda \
     -n kpanda-system \
     -f ./bak.yaml \
     --set global.imageRegistry=$imageRegistry \
     --version 0.21.0
   

1. Back up the --set parameters.

   Before upgrading the container management module, it is recommended to run the following command to back up the --set parameters of the old version.

   helm get values kpanda -n k pan da-system -o yaml > bak.yaml
   

2. Update the kpanda CRDs.

   kubectl apply -f ./crds
   

3. Run helm upgrade .

   Before upgrading, it is recommended to replace the global.imageRegistry field in bak.yaml with the image repository address you are currently using.

   export imageRegistry={your_image_repository}
   

   helm upgrade kpanda . \
     -n kpanda-system \
     -f ./bak.yaml \
     --set global.imageRegistry=$imageRegistry
   

Upgrade via Web UI¶

Prerequisites¶

Before installing DCE 5.0 or upgrading the product module, execute the following command:

~/dce5-installer cluster-create -c /home/dce5/sample/clusterConfig.yaml -m /home/dce5/sample/manifest.yaml -d -j 14,15

Steps¶

1. On the Clusters page, search for the kpanda-global-cluster and enter its details.

   

2. In the left navigation panel, locate Helm Apps and search for kpanda to find the Container Management module. Expand the right-hand operation column and click the Update button to initiate the upgrade.

   

Comments