1.9. 在服务网格中添加服务

流程

1. 登陆到 OpenShift Container Platform Web 控制台。

2. 如果您还没有网格服务，或者您从头开始，请为您的应用程序创建一个项目。它必须与安装 Service Mesh control plane 的项目不同。

   1. 浏览至 Home Project。
   2. 在 Name 字段中输入一个名称。
   3. 点 Create。
3. 导航到 Operators Installed Operators。
4. 点 Project 菜单，从列表中选择部署 ServiceMeshControlPlane 资源的项目，如 istio-system。
5. 点 Red Hat OpenShift Service Mesh Operator。
6. 点 Istio Service Mesh Member Roll 选项卡。
7. 点 Create ServiceMeshMemberRoll
8. 单击 Members，然后在 Value 字段中输入项目名称。您可以添加多个项目，但每个项目只能属于一个 ServiceMeshMemberRoll 资源。
9. 点 Create。

流程

1. 登录 OpenShift Container Platform CLI。

   $ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443

2. 如果您还没有网格服务，或者您从头开始，请为您的应用程序创建一个项目。它必须与安装 Service Mesh control plane 的项目不同。

   $ oc new-project <your-project>

3. 要添加项目作为成员，请修改以下示例 YAML:您可以添加多个项目，但每个项目只能属于一个 ServiceMeshMemberRoll 资源。在本例中，istio-system 是 Service Mesh control plane 项目的名称。

   servicemeshmemberroll-default.yaml 示例

   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
     namespace: istio-system
   spec:
     members:
       # a list of projects joined into the service mesh
       - your-project-name
       - another-project-name

4. 运行以下命令，在 istio-system 命名空间中上传并创建 ServiceMeshMemberRoll 资源。

   $ oc create -n istio-system -f servicemeshmemberroll-default.yaml

5. 运行以下命令，以验证 ServiceMeshMemberRoll 是否已成功创建。

   $ oc get smmr -n istio-system default

   当 STATUS 列为 Configured 时，安装成功完成。

流程

1. 登陆到 OpenShift Container Platform Web 控制台。
2. 导航到 Operators Installed Operators。
3. 点 Project 菜单，从列表中选择部署了 ServiceMeshControlPlane 资源的项目。例如 istio-system。
4. 点 Red Hat OpenShift Service Mesh Operator。
5. 点 Istio Service Mesh Member Roll 选项卡。
6. 点 default 链接。
7. 点 YAML 标签。

8. 修改 YAML 以添加项目作为成员（或删除它们来删除现有成员）。您可以添加多个项目，但每个项目只能属于一个 ServiceMeshMemberRoll 资源。

   servicemeshmemberroll-default.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

9. 点 Save。
10. 点 Reload。

流程

1. 登录 OpenShift Container Platform CLI。

2. 编辑 ServiceMeshMemberRoll 资源。

   $ oc edit smmr -n <controlplane-namespace>

3. 修改 YAML 以添加或删除作为成员的项目。您可以添加多个项目，但每个项目只能属于一个 ServiceMeshMemberRoll 资源。

   servicemeshmemberroll-default.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

4. 保存文件并退出编辑器。

流程

1. 登陆到 OpenShift Container Platform Web 控制台。
2. 导航到 Operators Installed Operators。
3. 点 Project 菜单，然后从下拉列表中选择您要添加到网格的项目。例如： istio-system。
4. 点 Red Hat OpenShift Service Mesh Operator。
5. 点 Istio Service Mesh Member 选项卡。
6. 点 Create ServiceMeshMember
7. 接受 ServiceMeshMember 的默认名称。
8. 点击以展开 ControlPlaneRef。
9. 在 Namespace 字段中，选择 ServiceMeshControlPlane 资源所属的项目。例如： istio-system。
10. 在 Name 字段中输入此命名空间所属的 ServiceMeshControlPlane 资源的名称。例如，basic。
11. 点 Create。
12. 确认创建了 ServiceMeshMember 资源，并且项目已添加到网格中。点资源名称，例如 default。查看屏幕末尾显示的 Conditions 部分。确认 Reconciled 和 Ready 条件的 Status 为 True。如果 Status 为 False，请参阅 Reason 和 Message 列以了解更多信息。

流程

1. 登录 OpenShift Container Platform CLI。

2. 为 ServiceMeshMember 清单创建 YAML 文件。清单将 my-application 项目添加到由 istio-system 命名空间中部署的 ServiceMeshControlPlane 资源创建的服务网格中：

   apiVersion: maistra.io/v1
   kind: ServiceMeshMember
   metadata:
     name: default
     namespace: my-application
   spec:
     controlPlaneRef:
       namespace: istio-system
       name: basic

3. 应用 YAML 文件以创建 ServiceMeshMember 资源：

   $ oc apply -f <file-name>

4. 创建 ServiceMeshMember 资源后，验证命名空间是否是网格的一部分。运行以下命令，确认值 True 出现在 READY 列中：

   $ oc get smm default -n my-application

   另外，如果可以访问 ServiceMeshMemberRoll 资源，您还可以确认 my-application 命名空间显示在 ServiceMeshMemberRoll 资源的 status.members 和 status.configuredMembers 字段中。

流程

1. 登陆到 OpenShift Container Platform Web 控制台。
2. 导航到 Operators Installed Operators。
3. 点 Project 菜单，从下拉菜单中选择部署 ServiceMeshMemberRoll 资源的项目。例如：istio-system。
4. 点 Red Hat OpenShift Service Mesh Operator。
5. 点 Istio Service Mesh Member Roll 选项卡。
6. 点 Create ServiceMeshMember Roll。
7. 接受 ServiceMeshMemberRoll 的默认名称。

8. 在 Labels 字段中输入键值对，以定义标识服务网格中要包含哪些命名空间的标签。如果项目命名空间具有选择器指定的标签，则项目命名空间会包含在服务网格中。您不需要同时包含这两个标签。

   例如，输入 mykey=myvalue 包括具有此标签的所有命名空间作为网格的一部分。当选择器标识匹配项时，项目命名空间将添加到服务网格中。

   输入 myotherkey=myothervalue 包括具有此标签的所有命名空间作为网格的一部分。当选择器标识匹配项时，项目命名空间将添加到服务网格中。

9. 点 Create。

流程

1. 登录 OpenShift Container Platform CLI。

2. 编辑 ServiceMeshMemberRoll 资源。

   $ oc edit smmr -n <controlplane_project>

   上例使用 <controlplane_project> 作为示例。只要 Service Mesh control plane 与包含服务的项目分开，就可以将 Service Mesh control plane 部署到任何项目中。

3. 修改 YAML 文件，以在 ServiceMeshMemberRoll 资源的 spec.memberSelectors 字段中包含命名空间标签选择器。

   注意

   您还可以使用选择器中的 matchExpressions 字段，而不使用 matchLabels 字段。

   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
     namespace: istio-system
   spec:
     memberSelectors: 1
     - matchLabels: 2
         mykey: myvalue 3
     - matchLabels: 4
         myotherkey: myothervalue 5

   1

   包含用于标识服务网格中包含的项目命名空间的标签选择器。如果项目命名空间具有选择器指定的标签，则项目命名空间会包含在服务网格中。项目命名空间不需要同时包含这两个标签。

   2 3

   使用 mykey=myvalue 标签指定所有命名空间。当选择器标识匹配项时，项目命名空间将添加到服务网格中。

   4 5

   使用 myotherkey=myothervalue 标签指定所有命名空间。当选择器标识匹配项时，项目命名空间将添加到服务网格中。

流程

1. 以具有 cluster-admin 权限的用户身份登录到 OpenShift Container Platform web 控制台。如果使用 Red Hat OpenShift Dedicated，则必须有一个具有 dedicated-admin 角色的帐户。
2. 点 Home Projects。
3. 点击 Create Project。

4. 在 Project Name 中输入 info，输入 Display Name 及 Description，然后点 Create。

   • 或者，也可以通过 CLI 运行这个命令来创建 info 项目。

     $ oc new-project info

5. 点 Operators Installed Operators。
6. 点 Project 菜单，使用 Service Mesh control plane 命名空间。在这个示例中，使用 istio-system。
7. 点 Red Hat OpenShift Service Mesh Operator。

8. 点 Istio Service Mesh Member Roll 选项卡。

   1. 如果您已经创建了 Istio Service Mesh Member Roll，请名称，然后点击 YAML 标签来打开 YAML 编辑器。
   2. 如果您还没有创建 ServiceMeshMemberRoll，点 Create ServiceMeshMemberRoll。
9. 单击 Members，然后在 Value 字段中输入项目名称。

10. 点 Create 保存更新的 Service Mesh Member Roll。

    1. 或者，将以下示例保存到 YAML 文件中。

       Bookinfo ServiceMeshMemberRoll 示例 servicemeshmemberroll-default.yaml

       apiVersion: maistra.io/v1
       kind: ServiceMeshMemberRoll
       metadata:
         name: default
       spec:
         members:
         - info

    2. 运行以下命令上传该文件，并在 istio-system 命名空间中创建 ServiceMeshMemberRoll 资源。在本例中，istio-system 是 Service Mesh control plane 项目的名称。

       $ oc create -n istio-system -f servicemeshmemberroll-default.yaml

11. 运行以下命令，以验证 ServiceMeshMemberRoll 是否已成功创建。

    $ oc get smmr -n istio-system -o wide

    当 STATUS 列为 Configured 时，安装成功完成。

    NAME      READY   STATUS       AGE   MEMBERS
    default   1/1     Configured   70s   ["info"]

12. 在 CLI 中，通过应用 bookinfo.yaml 文件在 `info` 项目中部署 Bookinfo：

    $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.4/samples/bookinfo/platform/kube/bookinfo.yaml

    您应该看到类似如下的输出：

    service/details created
    serviceaccount/info-details created
    deployment.apps/details-v1 created
    service/ratings created
    serviceaccount/info-ratings created
    deployment.apps/ratings-v1 created
    service/reviews created
    serviceaccount/info-reviews created
    deployment.apps/reviews-v1 created
    deployment.apps/reviews-v2 created
    deployment.apps/reviews-v3 created
    service/productpage created
    serviceaccount/info-productpage created
    deployment.apps/productpage-v1 created

13. 通过应用 info-gateway.yaml 文件创建入站网关 ：

    $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.4/samples/bookinfo/networking/bookinfo-gateway.yaml

    您应该看到类似如下的输出：

    gateway.networking.istio.io/info-gateway created
    virtualservice.networking.istio.io/info created

14. 设置 GATEWAY_URL 参数的值：

    $ export GATEWAY_URL=$(oc -n istio-system get route istio-ingressgateway -o jsonpath='{.spec.host}')

流程

1. 要添加目的地规则，请运行以下命令之一：

   • 如果没有启用 mutual TLS：

     $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.4/samples/bookinfo/networking/destination-rule-all.yaml

   • 如果启用了 nutual TLS：

     $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.4/samples/bookinfo/networking/destination-rule-all-mtls.yaml

     您应该看到类似如下的输出：

     destinationrule.networking.istio.io/productpage created
     destinationrule.networking.istio.io/reviews created
     destinationrule.networking.istio.io/ratings created
     destinationrule.networking.istio.io/details created

通过 CLI 的步骤

1. 登录 OpenShift Container Platform CLI。

2. 验证所有 pod 是否都与此命令就绪：

   $ oc get pods -n info

   所有容器集的状态都应为 Running。您应该看到类似如下的输出：

   NAME                              READY   STATUS    RESTARTS   AGE
   details-v1-55b869668-jh7hb        2/2     Running   0          12m
   productpage-v1-6fc77ff794-nsl8r   2/2     Running   0          12m
   ratings-v1-7d7d8d8b56-55scn       2/2     Running   0          12m
   reviews-v1-868597db96-bdxgq       2/2     Running   0          12m
   reviews-v2-5b64f47978-cvssp       2/2     Running   0          12m
   reviews-v3-6dfd49b55b-vcwpf       2/2     Running   0          12m

3. 运行以下命令来检索产品页面的 URL:

   echo "http://$GATEWAY_URL/productpage"

4. 在网页浏览器中复制并粘贴输出以验证是否已部署了 Bookinfo 产品页面。

来自 Kiali web 控制台的步骤

1. 获取 Kiali web 控制台的地址。

   1. 以具有 cluster-admin 权限的用户身份登录 OpenShift Container Platform web 控制台。如果使用 Red Hat OpenShift Dedicated，则必须有一个具有 dedicated-admin 角色的帐户。
   2. 进入 Networking Routes。

   3. 在 Routes 页面中，从 Namespace 菜单中选择 Service Mesh control plane 项目，如 istio-system。

      Location 列显示每个路由的链接地址。

   4. 点 Kiali 的 Location 列中的链接。
   5. 单击 Log In With OpenShift。Kiali Overview 屏幕显示每个项目命名空间的标题。
2. 在 Kiali 中，点 Graph。
3. 从 Namespace 列表中选择 info，从 Graph Type 列表中选择 App graph。

4. 从 Display 菜单中选择 Display idle nodes。

   这将显示定义的节点，但尚未收到或发送请求。它可以确认应用已正确定义，但未报告任何请求流量。

   
   • 使用 Duration 菜单增加时间段，以帮助确保捕获旧的流量。
   • 使用 Refresh Rate 菜单刷新流量频率或更小，或者根本不刷新流量。
5. 点 Services、Workloads 或 Istio Config 查看 info 组件的列表视图，并确认它们健康。