mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
109 lines
3.4 KiB
Plaintext
109 lines
3.4 KiB
Plaintext
////
|
|
This module is included in the following assemblies:
|
|
* service_mesh/v2x/ossm-create-smcp.adoc
|
|
////
|
|
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="ossm-deploy-cluster-wide-control-plane-cli_{context}"]
|
|
= Configuring the control plane for cluster-wide deployment with the CLI
|
|
|
|
You can configure the `ServiceMeshControlPlane` resource for cluster-wide deployment using the CLI. In this example, `istio-system` is the name of the Service Mesh control plane namespace.
|
|
|
|
.Prerequisites
|
|
|
|
* The {SMProductName} Operator is installed.
|
|
* You have access to the OpenShift CLI (`oc`).
|
|
ifndef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
|
|
* You are logged in to {product-title} as`cluster-admin`.
|
|
endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
|
|
ifdef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
|
|
* You are logged in to {product-title} as a user with the `dedicated-admin` role.
|
|
endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
|
|
|
|
.Procedure
|
|
|
|
. Create a project named `istio-system`.
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc new-project istio-system
|
|
----
|
|
|
|
. Create a `ServiceMeshControlPlane` file named `istio-installation.yaml` using the following example:
|
|
+
|
|
ifndef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
|
|
.Example version {MaistraVersion} istio-installation.yaml
|
|
[source,yaml, subs="attributes,verbatim"]
|
|
----
|
|
apiVersion: maistra.io/v2
|
|
kind: ServiceMeshControlPlane
|
|
metadata:
|
|
name: basic
|
|
namespace: istio-system
|
|
spec:
|
|
version: v{MaistraVersion}
|
|
mode: ClusterWide
|
|
----
|
|
endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
|
|
ifdef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
|
|
.Example `ServiceMeshControlPlane` resource
|
|
[source,yaml, subs="attributes,verbatim"]
|
|
----
|
|
apiVersion: maistra.io/v2
|
|
kind: ServiceMeshControlPlane
|
|
metadata:
|
|
name: basic
|
|
namespace: istio-system
|
|
spec:
|
|
version: v{MaistraVersion}
|
|
mode: ClusterWide <1>
|
|
security:
|
|
identity:
|
|
type: ThirdParty <2>
|
|
----
|
|
<1> Specifies that the resource is for a cluster-wide deployment.
|
|
ifdef::openshift-rosa,openshift-rosa-hcp[]
|
|
<2> Specifies a required setting for {product-rosa}.
|
|
endif::openshift-rosa,openshift-rosa-hcp[]
|
|
ifdef::openshift-dedicated[]
|
|
<2> Specifies a required setting for {product-dedicated}.
|
|
endif::openshift-dedicated[]
|
|
endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
|
|
|
|
. Run the following command to deploy the {SMProductShortName} control plane:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc create -n istio-system -f <istio_installation.yaml>
|
|
----
|
|
+
|
|
where:
|
|
+
|
|
--
|
|
<istio_installation.yaml>:: Specifies the full path to your file.
|
|
--
|
|
|
|
.Verification
|
|
|
|
. To monitor the progress of the pod deployment, run the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get pods -n istio-system -w
|
|
----
|
|
+
|
|
You should see output similar to the following example:
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
NAME READY STATUS RESTARTS AGE
|
|
grafana-b4d59bd7-mrgbr 2/2 Running 0 65m
|
|
istio-egressgateway-678dc97b4c-wrjkp 1/1 Running 0 108s
|
|
istio-ingressgateway-b45c9d54d-4qg6n 1/1 Running 0 108s
|
|
istiod-basic-55d78bbbcd-j5556 1/1 Running 0 108s
|
|
jaeger-67c75bd6dc-jv6k6 2/2 Running 0 65m
|
|
kiali-6476c7656c-x5msp 1/1 Running 0 43m
|
|
prometheus-58954b8d6b-m5std 2/2 Running 0 66m
|
|
----
|