1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-07 00:48:01 +01:00
Files
openshift-docs/modules/ossm-member-roll-modify.adoc
2024-03-28 19:11:54 +00:00

91 lines
2.7 KiB
Plaintext

// Module included in the following assemblies:
//
// * service_mesh/v1x/installing-ossm.adoc
// * service_mesh/v2x/installing-ossm.adoc
:_mod-docs-content-type: PROCEDURE
[id="ossm-member-roll-modify_{context}"]
= Adding or removing projects from the service mesh
You can add or remove projects from an existing {SMProductShortName} `ServiceMeshMemberRoll` resource using the web console.
* You can add any number of projects, but a project can only belong to one `ServiceMeshMemberRoll` resource.
* The `ServiceMeshMemberRoll` resource is deleted when its corresponding `ServiceMeshControlPlane` resource is deleted.
[id="ossm-member-roll-modify-console_{context}"]
== Adding or removing projects from the member roll using the web console
.Prerequisites
* An installed, verified {SMProductName} Operator.
* An existing `ServiceMeshMemberRoll` resource.
* Name of the project with the `ServiceMeshMemberRoll` resource.
* Names of the projects you want to add or remove from the mesh.
.Procedure
. Log in to the {product-title} web console.
. Navigate to *Operators* -> *Installed Operators*.
. Click the *Project* menu and choose the project where your `ServiceMeshControlPlane` resource is deployed from the list, for example `istio-system`.
. Click the {SMProductName} Operator.
. Click the *Istio Service Mesh Member Roll* tab.
. Click the `default` link.
. Click the YAML tab.
. Modify the YAML to add or remove projects as members. You can add any number of projects, but a project can only belong to one `ServiceMeshMemberRoll` resource.
. Click *Save*.
. Click *Reload*.
[id="ossm-member-roll-modify-cli_{context}"]
== Adding or removing projects from the member roll using the CLI
You can modify an existing {SMProductShortName} member roll using the command line.
.Prerequisites
* An installed, verified {SMProductName} Operator.
* An existing `ServiceMeshMemberRoll` resource.
* Name of the project with the `ServiceMeshMemberRoll` resource.
* Names of the projects you want to add or remove from the mesh.
* Access to the OpenShift CLI (`oc`).
.Procedure
. Log in to the {product-title} CLI.
. Edit the `ServiceMeshMemberRoll` resource.
+
[source,terminal]
----
$ oc edit smmr -n <controlplane-namespace>
----
+
. Modify the YAML to add or remove projects as members. You can add any number of projects, but a project can only belong to one `ServiceMeshMemberRoll` resource.
+
.Example servicemeshmemberroll-default.yaml
[source,yaml]
----
apiVersion: maistra.io/v1
kind: ServiceMeshMemberRoll
metadata:
name: default
namespace: istio-system #control plane project
spec:
members:
# a list of projects joined into the service mesh
- your-project-name
- another-project-name
----