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 资源。
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

流程

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

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

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

     $ oc new-project bookinfo

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:
         - bookinfo

    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   ["bookinfo"]

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

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

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

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

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

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

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

    gateway.networking.istio.io/bookinfo-gateway created
    virtualservice.networking.istio.io/bookinfo 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 bookinfo -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.2/samples/bookinfo/networking/destination-rule-all.yaml

   • 如果启用了 nutual TLS：

     $ oc apply -n bookinfo -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.2/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 bookinfo

   所有容器集的状态都应为 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 列表中选择 bookinfo，从 Graph Type 列表中选择 App graph。

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

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

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