From 29a1cbd7be0e7974e3393951a22de44fcdf0b733 Mon Sep 17 00:00:00 2001 From: BigEars Date: Thu, 11 Jun 2026 14:45:11 -0400 Subject: [PATCH 1/2] Added TP notes, fixed misc minor inconsistencies --- modules/ossm-about-istio-ambient-mode.adoc | 2 +- ...ing-bookinfo-application-istio-ambient-mode.adoc | 2 +- ...ng-multi-primary-multi-network-mesh-ambient.adoc | 13 ++++--------- ...sm-verifying-multi-cluster-topology-ambient.adoc | 9 +++------ .../technology-preview-ambient-multicluster.adoc | 13 +++++++++++++ 5 files changed, 22 insertions(+), 17 deletions(-) create mode 100644 snippets/technology-preview-ambient-multicluster.adoc diff --git a/modules/ossm-about-istio-ambient-mode.adoc b/modules/ossm-about-istio-ambient-mode.adoc index 17f9b205044f..6bd3a7f76f60 100644 --- a/modules/ossm-about-istio-ambient-mode.adoc +++ b/modules/ossm-about-istio-ambient-mode.adoc @@ -36,7 +36,7 @@ The L7 features require deploying `waypoint` proxies, which introduces minimal a Ambient mode is a newer architecture and might involve different operational considerations than traditional sidecar models. ==== -While well-defined discovery selectors allow a service mesh deployed in ambient mode alongside a mesh in sidecar mode, this scenario has not been thoroughly validated. To avoid potential conflicts, install {istio} ambient mode only on clusters that do not have an existing {SMProductName} installation. Ambient mode remains a Technology Preview feature. +While well-defined discovery selectors allow a service mesh deployed in ambient mode alongside a mesh in sidecar mode, this scenario has not been thoroughly validated. To avoid potential conflicts, install {istio} ambient mode only on clusters that do not have an existing {SMProductName} installation. [IMPORTANT] ==== diff --git a/modules/ossm-deploying-bookinfo-application-istio-ambient-mode.adoc b/modules/ossm-deploying-bookinfo-application-istio-ambient-mode.adoc index 1a01ab9c41e3..6ad7de401f3c 100644 --- a/modules/ossm-deploying-bookinfo-application-istio-ambient-mode.adoc +++ b/modules/ossm-deploying-bookinfo-application-istio-ambient-mode.adoc @@ -14,7 +14,7 @@ For more information about the `bookinfo` application, see "About the Bookinfo a .Prerequisites -* You have deployed a cluster on {ocp-product-title} 4.15 or later, which includes the supported {k8s} Gateway API custom resource definitions (CRDs) required for {istio} ambient mode. +* You have deployed a cluster on {ocp-product-title} 4.19 or later, which includes the supported {k8s} Gateway API custom resource definitions (CRDs) required for {istio} ambient mode. * You have logged in to the {ocp-product-title} cluster either through the web console as a user with the `cluster-admin` role, or with the `oc login` command, depending on the installation method. diff --git a/modules/ossm-installing-multi-primary-multi-network-mesh-ambient.adoc b/modules/ossm-installing-multi-primary-multi-network-mesh-ambient.adoc index 370075a33bfc..e472823809c4 100644 --- a/modules/ossm-installing-multi-primary-multi-network-mesh-ambient.adoc +++ b/modules/ossm-installing-multi-primary-multi-network-mesh-ambient.adoc @@ -8,14 +8,9 @@ [role="_abstract"] -Install {istio} and configure it for ambient mode in the multi-primary multi-network topology on two {ocp-product-title} clusters. +Install {istio} and configure it for ambient mode in the multi-primary multi-network topology on two {ocp-product-title} clusters. For a mesh spanning more than two clusters, you can adapt these instructions. -[NOTE] -==== -In this procedure, `CLUSTER1` is the East cluster and `CLUSTER2` is the West cluster. -==== - -You can adapt these instructions for a mesh spanning more than two clusters. +include::snippets/technology-preview-ambient-multicluster.adoc[] .Prerequisites @@ -59,7 +54,7 @@ In addition to bare metal, the MetalLB Operator can offer load balancing for ins $ export ISTIO_VERSION=1.27.3 ---- -. Install {istio} on the East cluster: +. Install {istio} on the East cluster (`CLUSTER1`): .. Create an `{istio}` resource on the East cluster by running the following command: + @@ -152,7 +147,7 @@ EOF $ oc --context="${CTX_CLUSTER1}" wait gateway/istio-eastwestgateway -n istio-system --for=condition=Programmed=True --timeout=3m ---- -. Install {istio} on the West cluster: +. Install {istio} on the West cluster (`CLUSTER2`): .. Create an `Istio` resource on the West cluster by running the following command: + diff --git a/modules/ossm-verifying-multi-cluster-topology-ambient.adoc b/modules/ossm-verifying-multi-cluster-topology-ambient.adoc index 8d47d2a6f57f..3c1d71b148ac 100644 --- a/modules/ossm-verifying-multi-cluster-topology-ambient.adoc +++ b/modules/ossm-verifying-multi-cluster-topology-ambient.adoc @@ -10,10 +10,7 @@ Deploy sample applications and verify traffic across two {ocp-product-title} clusters with {SMProductShortName} in ambient mode. -[NOTE] -==== -In this procedure, `CLUSTER1` is the East cluster and `CLUSTER2` is the West cluster. -==== +include::snippets/technology-preview-ambient-multicluster.adoc[] .Prerequisites @@ -33,7 +30,7 @@ In this procedure, `CLUSTER1` is the East cluster and `CLUSTER2` is the West clu .Procedure -. Deploy sample applications on the East cluster: +. Deploy sample applications on the East cluster (`CLUSTER1`): .. Create a sample application namespace on the East cluster by running the following command: + @@ -98,7 +95,7 @@ $ oc --context="${CTX_CLUSTER1}" wait --for condition=available -n sample deploy $ oc --context="${CTX_CLUSTER1}" wait --for condition=available -n sample deployment/sleep ---- -. Deploy the sample applications on the West cluster: +. Deploy the sample applications on the West cluster (`CLUSTER2`): .. Create a sample application namespace on the West cluster by running the following command: + diff --git a/snippets/technology-preview-ambient-multicluster.adoc b/snippets/technology-preview-ambient-multicluster.adoc new file mode 100644 index 000000000000..503278919604 --- /dev/null +++ b/snippets/technology-preview-ambient-multicluster.adoc @@ -0,0 +1,13 @@ +// snippet included in the following modules: +// +// * service-mesh-docs-main/modules/ossm-installing-multi-primary-multi-network-mesh-ambient.adoc +// * service-mesh-docs-main/modules/ossm-verifying-multi-cluster-topology-ambient.adoc +:_mod-docs-content-type: SNIPPET + +[IMPORTANT] +==== +Ambient mode in a multi-primary multi-network topology is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. + +For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope]. +==== + From 0d29fe0133da35fc54527703722b5d96ec3b27f4 Mon Sep 17 00:00:00 2001 From: BigEars Date: Fri, 12 Jun 2026 10:08:10 -0400 Subject: [PATCH 2/2] Tweaked short description --- ...ssm-installing-multi-primary-multi-network-mesh-ambient.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ossm-installing-multi-primary-multi-network-mesh-ambient.adoc b/modules/ossm-installing-multi-primary-multi-network-mesh-ambient.adoc index e472823809c4..f827076952b2 100644 --- a/modules/ossm-installing-multi-primary-multi-network-mesh-ambient.adoc +++ b/modules/ossm-installing-multi-primary-multi-network-mesh-ambient.adoc @@ -8,7 +8,7 @@ [role="_abstract"] -Install {istio} and configure it for ambient mode in the multi-primary multi-network topology on two {ocp-product-title} clusters. For a mesh spanning more than two clusters, you can adapt these instructions. +Install {istio} and configure it for ambient mode in the multi-primary multi-network topology on two {ocp-product-title} clusters. (For a mesh spanning more than two clusters, you can adapt these instructions.) include::snippets/technology-preview-ambient-multicluster.adoc[]