OSSM-6347: SM 3.0 Deploying Istio

_attributes/common-attributes.adoc

@@ -18,6 +18,7 @@
 :istio: Istio
 :product-rosa: Red Hat OpenShift Service on AWS
 :product-dedicated: Red Hat OpenShift Dedicated
+:istio: Istio
 //service mesh v2
 :SMProductVersion: 2.4.5
 :MaistraVersion: 2.4

install/ossm-installing-openshift-service-mesh.adoc

@@ -9,6 +9,10 @@ toc::[]
 Installing {ocp-short-name} {SMProductShortName} consists of three main tasks: installing the {ocp-short-name} Operator, deploying {istio}, and customizing the {istio} configuration. Then, you can also choose to install the sample `bookinfo` application to push data through the mesh and explore mesh functionality.
 
 include::modules/ossm-installing-operator.adoc[leveloffset=+1]
-include::modules/ossm-deploying-istio.adoc[leveloffset=+1]
+include::modules/ossm-about-istio-deployment.adoc[leveloffset=+1]
+include::modules/ossm-creating-istio-project-using-console.adoc[leveloffset=+2]
+include::modules/ossm-creating-istio-resource-using-console.adoc[leveloffset=+2]
+include::modules/ossm-creating-istio-cni-project-using-console.adoc[leveloffset=+2]
+include::modules/ossm-creating-istiocni-resource-using-console.adoc[leveloffset=+2]
 include::modules/ossm-installing-bookinfo.adoc[leveloffset=+1]
 include::modules/ossm-customizing-istio-configuration.adoc[leveloffset=+1]

modules/ossm-about-istio-deployment.adoc

@@ -0,0 +1,13 @@
+:_mod-docs-content-type: Concept
+[id="about-istio-deployment"]
+= About Istio deployment
+:context: ossm-about-istio-deployment
+
+To deploy {istio}, you must create two resources: `Istio` and `IstioCNI`. The `Istio` resource deploys and configures the {istio} Control Plane. The `IstioCNI` resource deploys and configures the {istio} Container Network Interface (CNI) plugin. You should create these resources in separate projects; therefore, you must create two projects as part of the {istio} deployment process.
+
+You can use the {ocp-short-name} web console or the OpenShift CLI (oc) to create a project or a resource in your cluster.
+
+[NOTE]
+====
+In the {ocp-product-title}, a project is essentially a Kubernetes namespace with additional annotations, such as the range of user IDs that can be used in the project. Typically, the {ocp-product-title} web console uses the term project, and the CLI uses the term namespace, but the terms are essentially synonymous.
+====

modules/ossm-creating-istio-cni-project-using-console.adoc

@@ -0,0 +1,22 @@
+:_mod-docs-content-type: Procedure
+[id="ossm-creating-istio-cni-project"]
+= Creating the IstioCNI project using the web console
+:context: ossm-creating-istio-cni-project-using-console
+
+The {SMProductShortName} Operator deploys the {istio} CNI plugin to a project that you create. In this example, `istio-cni` is the name of the project.
+
+.Prerequisties
+
+* The {SMProductName} Operator must be installed.
+
+* You are logged in to the {ocp-product-title} web console as cluster-admin.
+
+.Procedure
+
+. In the {ocp-product-title} web console, click *Home* -> *Projects*.
+
+. Click *Create Project*.
+
+. At the prompt, you must enter a name for the project in the *Name* field. For example, `istio-cni`. The other fields provide supplementary information and are optional.
+
+. Click *Create*.

modules/ossm-creating-istio-project-using-console.adoc

@@ -0,0 +1,22 @@
+:_mod-docs-content-type: Procedure
+[id="ossm-creating-istio-project"]
+= Creating the Istio project using the web console
+:context: ossm-creating-istio-project-using-console
+
+The {SMProductShortName} Operator deploys the {istio} control plane to a project that you create. In this example, `istio-system` is the name of the project.
+
+.Prerequisties
+
+* The {SMProductName} Operator must be installed.
+
+* You are logged in to the {ocp-product-title} web console as cluster-admin.
+
+.Procedure
+
+. In the {ocp-product-title} web console, click *Home* -> *Projects*.
+
+. Click *Create Project*.
+
+. At the prompt, enter a name for the project in the *Name* field. For example, `istio-system`. The other fields provide supplementary information to the `Istio` resource definition and are optional.
+
+. Click *Create*. The {SMProductShortName} Operator deploys {istio} to the project you specified.

modules/ossm-creating-istio-resource-using-console.adoc

@@ -0,0 +1,30 @@
+:_mod-docs-content-type: Procedure
+[id="ossm-creating-istio-resource"]
+= Creating the Istio resource using the web console
+:context: ossm-creating-istio-resource-using-console
+
+Create the {istio} resource that will contain the YAML configuration file for your {istio} deployment. The {SMProductShortName} Operator uses information in the YAML file to create an instance of the {istio} control plane.
+
+.Prerequisties
+
+* The {SMProductName} Operator must be installed.
+
+* You are logged in to the {ocp-product-title} web console as cluster-admin.
+
+.Procedure
+
+. In the {ocp-product-title} web console, click *Operators* -> *Installed Operators*.
+
+. Select `istio-system` in the *Project* drop-down menu.
+
+. Click the Sail Operator.
+
+. Click *Istio*.
+
+. Click *Create Istio*.
+
+. Select the `istio-system` project from the *Namespace* drop-down menu.
+
+. Click *Create*. This action deploys the {istio} control plane.
++
+When `State: Healthy` appears in the *Status* column, {istio} is successfully deployed.

modules/ossm-creating-istiocni-resource-using-console.adoc

@@ -0,0 +1,30 @@
+:_mod-docs-content-type: Procedure
+[id="ossm-creating-istiocni-resource"]
+= Creating the IstioCNI resource using the web console
+:context: ossm-creating-istiocni-resource
+
+Create an {istio} Container Network Interface (CNI) resource, which contains the configuration file for the Istio CNI plugin. The {SMProductShortName} Operator uses the configuration specified by this resource to deploy the CNI pod.
+
+.Prerequisties
+
+* The {SMProductName} Operator must be installed.
+
+* You are logged in to the {ocp-product-title} web console as cluster-admin.
+
+.Procedure
+
+. In the {ocp-product-title} web console, click *Operators* -> *Installed Operators*.
+
+. Select `istio-cni` in the *Project* drop-down menu.
+
+. Click the Sail Operator.
+
+. Click *IstioCNI*.
+
+. Click *Create IstioCNI*.
+
+. Ensure that the name is `default`.
+
+. Click *Create*. This action deploys the Istio CNI plugin.
++
+When `State: Healthy` appears in the *Status* column, the Istio CNI plugin is successfully deployed.