2.8. 在 Service Mesh 上部署应用程序

流程

1. 以集群管理员身份登录到 OpenShift Container Platform CLI。

2. 在 CLI 中运行这个命令，在 openshift-operators 项目中创建名为smcp-templates 的 ConfigMap，并将 <templates-directory> 替换成本地磁盘上的ServiceMeshControlPlane 文件的位置：

   $ oc create configmap --from-file=<templates-directory> smcp-templates -n openshift-operators

3. 找到 Operator 集群服务版本名称。

   $ oc get clusterserviceversion -n openshift-operators | grep 'Service Mesh'

   输出示例

   maistra.v1.0.0            Red Hat OpenShift Service Mesh   1.0.0                Succeeded

4. 编辑 Operator 集群服务版本，指定 Operator 使用 smcp-templates ConfigMap。

   $ oc edit clusterserviceversion -n openshift-operators maistra.v1.0.0

5. 在 Operator 部署中添加卷挂载和卷。

   deployments:
     - name: istio-operator
       spec:
         template:
           spec:
             containers:
               volumeMounts:
                 - name: discovery-cache
                   mountPath: /home/istio-operator/.kube/cache/discovery
                 - name: smcp-templates
                   mountPath: /usr/local/share/istio-operator/templates/
             volumes:
               - name: discovery-cache
                 emptyDir:
                   medium: Memory
               - name: smcp-templates
                 configMap:
                   name: smcp-templates
   ...

6. 保存更改并退出编辑器。

7. 现在，您可以使用 ServiceMeshControlPlane 中的 template 参数来指定模板。

   apiVersion: maistra.io/v1
   kind: ServiceMeshControlPlane
   metadata:
     name: minimal-install
   spec:
     template: default

流程

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 组件列表视图，并确认它们是否正常运行。