Offline Upgrade¶

The Workbench supports offline upgrades. You need to first load the image from the installation package and then run the corresponding command to upgrade.

tar -vxf amamba_x.y.z_amd64.tar

After unpacking, you will get a compressed bundle: amamba_x.y.z.bundle.tar

Load Image from Installation Package¶

Support loading images in two ways.

Sync Images via charts-syncer¶

If there is an image repository in the environment, it is recommended to synchronize the images to the image repository through charts-syncer for more efficient and convenient operation.

1. Create load-image.yaml with the following content as the configuration file for charts-syncer.

   All parameters in the load-image.yaml file are required. You need a private image repository and refer to the following instructions to modify each configuration. For detailed explanation of the charts-syncer configuration file, refer to its official documentation.

   HARBOR chart repo already installedCHARTMUSEUM chart repo already installedChart repo not installed

   If the HARBOR chart repo is already installed in the environment, charts-syncer also supports exporting the chart as a tgz file.

   load-image.yaml

   source:
     intermediateBundlesPath: amamba-offline 
   target:
     containerPrefixRegistry: 10.16.10.111 
     repo:
       kind: HARBOR 
       url: http://10.16.10.111/chartrepo/release.daocloud.io 
       auth:
         username: "admin" 
         password: "Harbor12345" 
     containers:
       auth:
         username: "admin" 
         password: "Harbor12345" 
   

   If the CHARTMUSEUM chart repo is already installed in the environment, charts-syncer also supports exporting the chart as a tgz file.

   load-image.yaml

   source:
     intermediateBundlesPath: amamba-offline 
   target:
     containerPrefixRegistry: 10.16.10.111 
     repo:
       kind: CHARTMUSEUM 
       url: http://10.16.10.111 
       auth:
         username: "rootuser" 
         password: "rootpass123" 
     containers:
       auth:
         username: "rootuser" 
         password: "rootpass123" 
   

   If the chart repo is not installed in the current environment, charts-syncer also supports exporting the chart as a tgz file and storing it in a specified path.

   source:
     intermediateBundlesPath: amamba-offline 
   target:
     containerRegistry: 10.16.23.145 
     containerRepository: release.daocloud.io/amamba 
     repo:
       kind: LOCAL
       path: ./local-repo 
     containers:
       auth:
         username: "admin" 
         password: "Harbor12345" 
   

2. Place amamba_x.y.z.bundle.tar in the amamba-offline folder.

3. Run the command to sync images.

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

Load Images Directly via Docker or containerd¶

1. Unpack the tar compressed bundle.

   tar -vxf amamba_x.y.z.bundle.tar
   

   After successful unpacking, you will get 3 files:

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

2. Run the following command to load the images from the local to Docker or containerd.

   Dockercontainerd

   docker load -i images.tar
   

   ctr -n k8s.io image import images.tar
   

Upgrade¶

Comments