Offline Upgrade - Mongodb Module¶
This page explains how to install or upgrade the Mongodb module of the middleware after downloading it from the Download Center.
Info
The term "mcamel" mentioned in the following commands or scripts is the internal development code name for the middleware module.
Load Images from Installation Package¶
You can load the images using one of the following two methods. It is recommended to use chart-syncer to synchronize images to the image repository when a repository already exists in the environment, as it is more efficient and convenient.
Synchronize Images to Image Repository using chart-syncer¶
-
Create load-image.yaml .
Note
All parameters in this YAML file are required. You need a private image repository and modify the relevant configurations.
If there is already an installed chart repo in the current environment, chart-syncer can also export the chart as a tgz file.
load-image.yamlsource: intermediateBundlesPath: mcamel-offline # path relative to the location where the charts-syncer command is executed, not relative to this YAML file and the offline package. target: containerRegistry: 10.16.10.111 # Replace with your image repository URL containerRepository: release.daocloud.io/mcamel # Replace with your image repository repo: kind: HARBOR # Can also be any other supported Helm Chart repository type url: http://10.16.10.111/chartrepo/release.daocloud.io # Replace with the chart repo URL auth: username: "admin" # Your image repository username password: "Harbor12345" # Your image repository password containers: auth: username: "admin" # Your image repository username password: "Harbor12345" # Your image repository password
If there is no installed chart repo in the current environment, chart-syncer can still export the chart as a tgz file and store it in the specified path.
load-image.yamlsource: intermediateBundlesPath: mcamel-offline # path relative to the location where the charts-syncer command is executed, not relative to this YAML file and the offline package. target: containerRegistry: 10.16.10.111 # Replace with your image repository URL containerRepository: release.daocloud.io/mcamel # Replace with your image repository repo: kind: LOCAL path: ./local-repo # Local path of the chart containers: auth: username: "admin" # Your image repository username password: "Harbor12345" # Your image repository password
-
Run the image synchronization command.
Load Directly from Docker or containerd¶
Extract and load the image files.
-
Extract the tar archive.
tar -xvf mcamel-mongodb_0.3.1_amd64.tar cd mcamel-mongodb_0.3.1_amd64 tar -xvf mcamel-mongodb_0.3.1.bundle.tar
After successful extraction, you will have 3 files:
- hints.yaml
- images.tar
- original-chart
-
Load the images from the local directory to Docker or containerd.
Note
Docker or containerd image loading operation should be performed on each node. After loading is complete, tag the images to keep the registry and repository consistent with the installation.
Upgrade¶
There are two ways to upgrade. You can choose the corresponding upgrade method based on the pre-operation:
-
Check if the 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 helm repository.
-
Update the helm repository.
-
Choose the version you want to install (it is recommended to install the latest version).
-
Back up the
--set
parameters.Before upgrading to a new version, it is recommended to back up the
--set
parameters of the old version by executing the following command: -
Run
helm upgrade
.Before upgrading, it is recommended to replace the
global.imageRegistry
field in mcamel-mongodb.yaml with the image repository address you are currently using.
-
Back up the
--set
parameters.Before upgrading to a new version, it is recommended to back up the
--set
parameters of the old version by executing the following command: -
Run
helm upgrade
.Before upgrading, it is recommended to replace the
global.imageRegistry
field in mcamel-mongodb.yaml with the image repository address you are currently using.