Offline Upgrade¶
Multi-cloud orchestration supports offline upgrades. You need to load the images from the installation package and then execute the respective commands for upgrading.
Info
The term "kairship" appearing in the following commands or scripts is the internal development codename for the multicloud orchestration module.
Load Images from the Downloaded Installation Package¶
You can load the images in one of the following two ways, but it is recommended to use chart-syncer to synchronize the images to the image repository when an image repository is available in the environment. This method 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 installation package to the image repository and helm repository used by the installer to deploy DCE.
First, find a node that can connect to the image repository and helm repository (e.g., the spark node) and create the load-image.yaml configuration file on the node with the appropriate configuration information for the image repository and helm repository.
-
Create load-image.yaml
Note
All parameters in this YAML file are required.
If the current environment already has a chart repo installed, chart-syncer also supports exporting the chart as a tgz file.
load-image.yamlsource: intermediateBundlesPath: kairship # 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/kairship # 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 no helm repo is added on the current node, chart-syncer also supports exporting the chart as a tgz file and storing it in the specified path.
load-image.yamlsource: intermediateBundlesPath: kairship # 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/kairship # Image repository path repo: kind: LOCAL path: ./local-repo # Local chart path containers: auth: username: "admin" # Image repository username password: "Harbor12345" # Image repository password
-
Run the command to synchronize the images.
Method 2: Load Images Using Docker or containerd¶
Unpack and load the image files.
-
Unpack the tar archive.
After successful unpacking, you will have three files:
- hints.yaml
- images.tar
- original-chart
-
Load the images from the local directory into Docker or containerd.
Note
Each node needs to perform the Docker or containerd image loading operation. After loading is complete, it is necessary to tag the images to match the registry and repository as they were during installation.
Upgrading¶
There are two ways to upgrade. You can choose the corresponding upgrade method based on the prerequisites:
-
Check if the multicloud orchestration Helm repository exists.
If the result is empty or shows the following prompt, proceed to the next step; otherwise, skip the next step.
-
Add the multicloud orchestration Helm repository.
-
Update the multicloud orchestration Helm repository.
-
Select the version of multicloud orchestration you want to install (it is recommended to install the latest version).
The output will be similar to:
-
Back up the
--set
parameters.Before upgrading the multicloud orchestration version, it is recommended to run the following command to back up the
--set
parameters of the old version. -
Update kairship CRDs
-
Run
helm upgrade
.Before upgrading, it is recommended to update the
global.imageRegistry
field in bak.yaml to the image repository address you are currently using.
-
Back up the
--set
parameters.Before upgrading the multicloud orchestration version, it is recommended to run the following command to back up the
--set
parameters of the old version. -
Update kairship CRDs
-
Run
helm upgrade
.Before upgrading, it is recommended to update the
global.imageRegistry
field in bak.yaml to the image repository address you are currently using.