OSSM-8507 Migration guide for multitenant 2.6

[gwynnemonahan]

OSSM 3.0 GA

https://issues.redhat.com/browse/OSSM-8507

Merge to: https://github.com/openshift/openshift-docs/tree/service-mesh-docs-main
Cherry pick to: https://github.com/openshift/openshift-docs/tree/service-mesh-docs-3.0

This PR is part of the standalone doc set for the OpenShift Service Mesh project. Kathryn is aware that this content applies for a product that is part of a Technology Preview release. The project is seeking feedback from early adopters.

Version(s):

Technology Preview.

OSSM 3.0 is moving to stand alone format so it will not be cherry-picked back to OCP core branches.

Issue:
https://issues.redhat.com/browse/OSSM-8507

Link to docs preview:
https://86917--ocpdocs-pr.netlify.app/openshift-service-mesh/latest/migrating/multitenant/ossm-migrating-multitenant-assembly.html

QE review:

• QE has approved this change.

Additional information:
This PR also sets up the Migration Guides assembly.

[ocpdocs-previewbot]

🤖 Thu Feb 20 15:50:01 - Prow CI generated the docs preview:

https://86917--ocpdocs-pr.netlify.app/openshift-service-mesh/latest/migrating/done/ossm-migrating-complete-assembly.html
https://86917--ocpdocs-pr.netlify.app/openshift-service-mesh/latest/migrating/multitenant/ossm-migrating-multitenant-assembly.html

[pbajjuri20]

Tested the PR, It works as expected.

[nrfox]

One nit otherwise LGTM

[pbajjuri20]

LGTM

[gwynnemonahan]

/label peer-review-needed

[snarayan-redhat]

Great work! Left few suggestions and nits.

[openshift-ci]

@gwynnemonahan: all tests passed!

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

[gwynnemonahan]

/label merge-review-needed

[kcarmichael08]

I will go ahead and merge but you might want to fix these tiny issues in the future. I just caught them while skimming to make sure everything was formatted OK.

[kcarmichael08]

Suggested change

.. The `maistra.io/ignore-namespace: "true"` label: Disables sidecar injection for {SMProduct} 2.6 proxies in the namespace so {SMProduct} 2.6 stops injecting proxies in this namespace, and any new proxies are injected by {SMProduct} 3.0. Without this label, the {SMProduct} 2.6 injection webhook tries to inject the pod and the injected sidecar proxy will refuse to start since it will have both the {SMProduct} 2.6 and the {SMProduct} 3.0 Container Network Interface(CNI) annotations.

.. The `maistra.io/ignore-namespace: "true"` label: Disables sidecar injection for {SMProduct} 2.6 proxies in the namespace so {SMProduct} 2.6 stops injecting proxies in this namespace, and any new proxies are injected by {SMProduct} 3.0. Without this label, the {SMProduct} 2.6 injection webhook tries to inject the pod and the injected sidecar proxy will refuse to start since it will have both the {SMProduct} 2.6 and the {SMProduct} 3.0 Container Network Interface (CNI) annotations.

[kcarmichael08]

Suggested change

	Once you apply the `maistra.io/ignore-namespace` label, any new pod that gets created in the namespace connects to the {SMProduct} 3.0 proxy. Workloads can still communicate with each other regardless of which controlplane they are connected to.
	Once you apply the `maistra.io/ignore-namespace` label, any new pod that gets created in the namespace connects to the {SMProduct} 3.0 proxy. Workloads can still communicate with each other regardless of which control plane they are connected to.

[kcarmichael08]

/cherrypick service-mesh-docs-3.0

[openshift-cherrypick-robot]

@kcarmichael08: new pull request created: #89006

In response to this:

/cherrypick service-mesh-docs-3.0

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.