Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions install/ossm-enabling-mtls.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ include::modules/ossm-enabling-strict-mtls-namespace.adoc[leveloffset=+1]

include::modules/ossm-enabling-strict-mtls-whole-service-mesh.adoc[leveloffset=+1]

[id="ossm-validating-encrytions-kiali_{context}"]
== Validating encrytions with Kiali
[id="ossm-validating-encryptions-kiali_{context}"]
== Validating encryptions with Kiali

The Kiali console offers several ways to validate whether or not your applications, services, and workloads have mTLS encryption enabled.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
= Accessing the Bookinfo application by using Gateway API
:context: ossm-accessing-bookinfo-application-using-gateway-API

The {k8s} Gateway API deploys a gateway by creating a `Gateway` resource. In {ocp-product-title} 4.15 and later versions. If you want your cluster to use the Gateway API CRDs, you must enable the CRDs because they are disabled by default.
The {k8s} Gateway API deploys a gateway by creating a `Gateway` resource. In {ocp-product-title} 4.15 and later versions. If you want your cluster to use the Gateway API CRDs, you must enable the CRDs because they are disabled by default.

[NOTE]
====
Expand All @@ -16,7 +16,7 @@ Red{nbsp}Hat provides support for using the {k8s} Gateway API with {SMProductNam

* The {SMProductName} Operator must be installed.

* The {istio} resource must be deployed.
* The {istio} resource must be deployed.

.Procedure

Expand All @@ -31,7 +31,7 @@ $ oc get crd gateways.gateway.networking.k8s.io &> /dev/null || { oc kustomize
+
[source,terminal]
----
$ oc apply -f https://raw.githubusercontent.com/istio/istio/release-1.23/samples/bookinfo/gateway-api/bookinfo-gateway.yaml -n bookinfo
$ oc apply -f https://raw.githubusercontent.com/istio/istio/release-1.24/samples/bookinfo/gateway-api/bookinfo-gateway.yaml -n bookinfo
----
+
[NOTE]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Gateway injection uses the same mechanisms as {istio} sidecar injection to creat

* The {SMProductName} Operator must be installed.

* The {istio} resource must be deployed.
* The {istio} resource must be deployed.

.Procedure

Expand All @@ -26,14 +26,14 @@ $ oc apply -n bookinfo -f ingress-gateway.yaml
+
[NOTE]
====
This example uses a sample `ingress-gateway.yaml` https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/chart/samples/ingress-gateway.yaml[file] that is available in the Istio community repository.
This example uses a sample `ingress-gateway.yaml` https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/chart/samples/ingress-gateway.yaml[file] that is available in the Istio community repository.
====

. Configure the `bookinfo` application to use the new gateway. Apply the gateway configuration by running the following command:
. Configure the `bookinfo` application to use the new gateway. Apply the gateway configuration by running the following command:
+
[source,terminal]
----
$ oc apply -f https://raw.githubusercontent.com/istio/istio/release-1.23/samples/bookinfo/networking/bookinfo-gateway.yaml -n bookinfo
$ oc apply -f https://raw.githubusercontent.com/istio/istio/release-1.24/samples/bookinfo/networking/bookinfo-gateway.yaml -n bookinfo
----
+
[NOTE]
Expand Down Expand Up @@ -78,7 +78,7 @@ spec:
----
<1> This example sets the the maximum replicas to `5` and the minimum replicas to `2`. It also creates another replica when utilization reaches 80%.

. Specify the minimum number of pods that must be running on the node.
. Specify the minimum number of pods that must be running on the node.
+
.Example configuration
[source,yaml]
Expand Down Expand Up @@ -110,5 +110,5 @@ $ HOST=$(oc get route istio-ingressgateway -n bookinfo -o jsonpath='{.spec.host}
+
[source,terminal]
----
$ echo productpage URL: http://$HOST/productpage
$ echo productpage URL: http://$HOST/productpage
----
2 changes: 1 addition & 1 deletion modules/ossm-cert-manager-installing-istio-resource.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ kind: Istio
metadata:
name: default
spec:
version: v1.23.0
version: v1.24.3
namespace: istio-system
values:
global:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -33,10 +33,10 @@ $ helm upgrade cert-manager-istio-csr jetstack/cert-manager-istio-csr \
--set "volumes[0].name=root-ca" \
--set "volumes[0].secret.secretName=istio-root-ca" \
--set "app.istio.namespace=istio-system" \
--set "app.istio.revisions={default-v1-23-0}"
--set "app.istio.revisions={default-v1-24-3}"
----
+
[NOTE]
====
Revision names use the following format, `<istio-name>-v<major_version>-<minor_version>-<patch_version>`. For example: `default-v1-23-0`.
Revision names use the following format, `<istio-name>-v<major_version>-<minor_version>-<patch_version>`. For example: `default-v1-24-3`.
====
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ If you deployed your Istio resource using the revision based update strategy, yo

.Example update for RevisionBased control plane

In this example, the `controlplane` is being updated from `v1.23.0` to `1.23.1.`
In this example, the `controlplane` is being updated from `v1.24.0` to `1.24.1.`

. Update the `istio-csr` deployment with the new revision by running the following command:
+
Expand All @@ -25,8 +25,8 @@ $ helm upgrade cert-manager-istio-csr jetstack/cert-manager-istio-csr \
--set "app.istio.revisions={<old_revision>,<new_revision>}"
----
where:
`old_revision` :: Specifies the old revision in the `<istio-name>-v<major_version>-<minor_version>-<patch_version>` format. For example: `default-v1-23-0`.
`new_revision` :: Specfies the new revision in the `<istio-name>-v<major_version>-<minor_version>-<patch_version>` format. For example: `default-v1-23-1`.
`old_revision` :: Specifies the old revision in the `<istio-name>-v<major_version>-<minor_version>-<patch_version>` format. For example: `default-v1-24-0`.
`new_revision` :: Specifies the new revision in the `<istio-name>-v<major_version>-<minor_version>-<patch_version>` format. For example: `default-v1-24-1`.

. Update the `istio.spec.version` in the `Istio` object similar to the following example:
+
Expand All @@ -40,7 +40,7 @@ metadata:
spec:
version: <new_revision> # <1>
----
<1> Update to the new revision prefixed with the letter _v_, such as `v1.23.1`
<1> Update to the new revision prefixed with the letter _v_, such as `v1.24.1`

. Remove the old revision from your `istio-csr` deployment by running the following command:
+
Expand All @@ -51,7 +51,7 @@ helm upgrade cert-manager-istio-csr jetstack/cert-manager-istio-csr \
--namespace cert-manager \
--wait \
--reuse-values \
--set "app.istio.revisions={default-v1-23-1}"
--set "app.istio.revisions={default-v1-24-1}"
----


Expand Down
2 changes: 1 addition & 1 deletion modules/ossm-config-otel.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ $ oc label namespace curl istio.io/rev=default-v1-23-0
+
[source, terminal]
----
$ oc apply -f https://raw.githubusercontent.com/istio/istio/release-1.23/samples/bookinfo/platform/kube/bookinfo.yaml -n bookinfo
$ oc apply -f https://raw.githubusercontent.com/istio/istio/release-1.24/samples/bookinfo/platform/kube/bookinfo.yaml -n bookinfo
----

. Generate traffic to the `productpage` pod to generate traces:
Expand Down
18 changes: 9 additions & 9 deletions modules/ossm-deploy-application-workloads-in-each-mesh.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -42,8 +42,8 @@ $ oc get istiorevisions
[source,terminal]
----
$ oc apply -n app-ns-1 \
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.23/samples/sleep/sleep.yaml \
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.23/samples/httpbin/httpbin.yaml
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/sleep/sleep.yaml \
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/httpbin/httpbin.yaml
----

. Wait for the `httpbin` and `sleep` pods to run with sidecars injected by running the following command:
Expand All @@ -61,7 +61,7 @@ httpbin-7f56dc944b-kpw2x 2/2 Running 0 2m26s
sleep-5577c64d7c-b5wd2 2/2 Running 0 91m
----

. Create a second applicatiom namespace called `app-ns-2` by running the following command:
. Create a second application namespace called `app-ns-2` by running the following command:
+
[source,terminal]
----
Expand All @@ -82,22 +82,22 @@ $ oc create namespace app-ns-3
$ oc label namespace app-ns-2 app-ns-3 istio-discovery=mesh-2 istio.io/rev=mesh-2
----

. Deploy the `sleep` and `httbin` applications to the `app-ns-2` namespace by running the following command:
. Deploy the `sleep` and `httpbin` applications to the `app-ns-2` namespace by running the following command:
+
[source,terminal]
----
$ oc apply -n app-ns-2 \
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.23/samples/sleep/sleep.yaml \
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.23/samples/httpbin/httpbin.yaml
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/sleep/sleep.yaml \
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/httpbin/httpbin.yaml
----

. Deploy the `sleep` and `httbin` applications to the `app-ns-3` namespace by running the following command:
. Deploy the `sleep` and `httpbin` applications to the `app-ns-3` namespace by running the following command:
+
[source,terminal]
----
$ oc apply -n app-ns-3 \
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.23/samples/sleep/sleep.yaml \
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.23/samples/httpbin/httpbin.yaml
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/sleep/sleep.yaml \
-f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/httpbin/httpbin.yaml
----

. Optional: Use the following command to wait for a deployment to be available:
Expand Down
8 changes: 4 additions & 4 deletions modules/ossm-deploying-bookinfo-application.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -21,15 +21,15 @@

. Enter `bookinfo` in the *Project name* field.
+
The *Display name* and *Description* fields provide supplementary information and are not required.
The *Display name* and *Description* fields provide supplementary information and are not required.

. Click *Create*.

. Apply the {Istio} discovery selector and injection label to the `bookinfo` namespace by entering the following command:
+
[source,terminal]
----
$ oc label namespace bookinfo istio-discovery=enabled istio-injection=enabled
$ oc label namespace bookinfo istio-discovery=enabled istio-injection=enabled
----
+
[NOTE]
Expand All @@ -41,7 +41,7 @@ In this example, the name of the Istio resource is `default`. If the Istio resou
+
[source,terminal]
----
oc apply -f https://raw.githubusercontent.com/istio/istio/release-1.23/samples/bookinfo/platform/kube/bookinfo.yaml -n bookinfo
oc apply -f https://raw.githubusercontent.com/istio/istio/release-1.24/samples/bookinfo/platform/kube/bookinfo.yaml -n bookinfo
----

.Verification
Expand Down Expand Up @@ -88,5 +88,5 @@ When the `Ready` columns displays `2/2`, the proxy sidecar was successfully inje
+
[source,terminal]
----
$ oc exec "$(oc get pod -l app=ratings -n bookinfo -o jsonpath='{.items[0].metadata.name}')" -c ratings -n bookinfo -- curl -sS productpage:9080/productpage | grep -o "<title>.*</title>"
$ oc exec "$(oc get pod -l app=ratings -n bookinfo -o jsonpath='{.items[0].metadata.name}')" -c ratings -n bookinfo -- curl -sS productpage:9080/productpage | grep -o "<title>.*</title>"
----
4 changes: 2 additions & 2 deletions modules/ossm-enabling-sidecar-injection.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,7 @@ productpage-v1-54f48db985-gd5q9 2/2 Running 0 55s
ratings-v1-5d645c985f-xsw7p 2/2 Running 0 55s
reviews-v1-bd5f54b8c-zns4v 2/2 Running 0 55s
reviews-v2-5d7b9dbf97-wbpjr 2/2 Running 0 55s
reviews-v3-5fccc48c8c-bjktn 2/2 Running 0 55sz
reviews-v3-5fccc48c8c-bjktn 2/2 Running 0 55s
----

[id="ossm-enabling-sidecar-injection-exclude-workload-from-mesh_{context}"]
Expand Down Expand Up @@ -230,7 +230,7 @@ spec:
+
[NOTE]
====
Adding the label to the `Deployment`'s top-level `labels` section does not impact sidecar injection.
Adding the label to the top-level `labels` section of the `Deployment` resource does not impact sidecar injection.
====
+
Updating the deployment triggers a rollout, creating a new ReplicaSet with the updated pod(s).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ You can adapt these instructions for a mesh spanning more than two clusters.
+
[source,terminal]
----
$ export ISTIO_VERSION=1.24.1
$ export ISTIO_VERSION=1.24.3
----

. Install {istio} on the East cluster:
Expand Down
14 changes: 7 additions & 7 deletions modules/ossm-installing-primary-remote-multi-network-mesh.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@

:_mod-docs-content-type: PROCEDURE
[id="ossm-installing-primary-remote-multi-network-mesh_{context}"]
= Installing a primary-remote multi-network mesh
= Installing a primary-remote multi-network mesh

Install {istio} in a primary-remote multi-network topology on two {ocp-product-title} clusters.
Install {istio} in a primary-remote multi-network topology on two {ocp-product-title} clusters.

[NOTE]
====
Expand All @@ -18,7 +18,7 @@ You can adapt these instructions for a mesh spanning more than two clusters.

* You have installed the {SMProduct} 3 Operator on all of the clusters that comprise the mesh.

* You have completed "Creating certificates for a multi-cluster mesh".
* You have completed "Creating certificates for a multi-cluster mesh".

* You have completed "Applying certificates to a multi-cluster topology".

Expand All @@ -32,7 +32,7 @@ You can adapt these instructions for a mesh spanning more than two clusters.
+
[source,terminal]
----
$ export ISTIO_VERSION=1.24.1
$ export ISTIO_VERSION=1.24.3
----

. Install {istio} on the East cluster:
Expand Down Expand Up @@ -63,7 +63,7 @@ spec:
clusterName: cluster1
network: network1
externalIstiod: true <1>
EOF
EOF
----
<1> This enables the control plane installed on the East cluster to serve as an external control plane for other remote clusters.

Expand Down Expand Up @@ -120,11 +120,11 @@ spec:
namespace: istio-system
profile: remote
values:
istiodRemote:
istiodRemote:
injectionPath: /inject/cluster/cluster2/net/network2
global:
remotePilotAddress: ${DISCOVERY_ADDRESS}
EOF
EOF
----

.. Annotate the `istio-system` namespace in the West cluster so that it is managed by the control plane in the East cluster by running the following command:
Expand Down