Skip to content

Latest commit

 

History

History
54 lines (26 loc) · 2.16 KB

upgrade-control-plane.md

File metadata and controls

54 lines (26 loc) · 2.16 KB

Upgrade Control Plane to OSSM 2.x

This scenario explains how to upgrade the Service Mesh control plane (smcp) when you already have applications deployed using OSSM 1.x. In this scenario, we will first use the simple ingress gateway with Bookinfo scripts to deploy the control plane and Bookinfo application, make sure it works and then upgrade the control plane and verify things still work.

Deploy the BookInfo Application

Follow the instructions in Simple Ingress Gateway with Bookinfo to deploy OSSM 1.x with the Bookinfo application. Do everything except for the cleanup step.

Check for potential upgrade errors

sh scenarios/upgrade-control-plane/scripts/check-for-errors.sh

If the output is empty, then you are good to proceed. Otherwise, consult the Service Mesh Documentation for potential resolutions.

Fix non-upgradeable components

You can follow the following procedure to fix the non-upgradeable components found.

oc get smcp.v1.maistra.io <smcp_name> -o yaml > smcp-resource.yaml

Make the appropriate edits to the resource.

oc replace -f smcp-resource.yaml

Create the new control plane

This will create a backup of your current control plane and a conversion to version 2.x. Then, it will create a new project for the control plane and install the control plane components.

sh scenarios/upgrade-control-plane/scripts/create-v2-smcp.sh

Migrate the BookInfo Application to the new Service Mesh

sh scenarios/upgrade-control-plane/scripts/migrate-bookinfo.sh

Test out the application

Open the following URL in a browser.

echo "https://$(oc get route api -n istio-system-v2 -o jsonpath={'.spec.host'})/productpage"

Clean up the original control plane

sh scenarios/upgrade-control-plane/scripts/cleanup-v1-smcp.sh

Continue to test as much as you like. Visit the Kiali page to watch the traffic graphs.

echo "https://$(oc get route kiali -n istio-system-v2 -o jsonpath={'.spec.host'})"

Cleanup

sh scenarios/upgrade-control-plane/scripts/cleanup-all.sh