4.2. 使用 OpenShift Service Mesh 控制台插件
OpenShift Service Mesh Console (OSSMC)插件使用 Service Mesh 菜单扩展 OpenShift Container Platform Web 控制台,并增强了工作负载和服务标签页。
4.2.1. 关于 OpenShift Service Mesh 控制台插件 复制链接链接已复制到粘贴板!
OpenShift Service Mesh Console (OSSMC)插件是 OpenShift Container Platform Web 控制台的扩展,可让您了解您的 Service Mesh。
OSSMC 插件只支持一个 Kiali 实例,无论其项目访问范围是什么。
OSSMC 插件使用以下菜单选项在主 OpenShift Container Platform Web 控制台导航中提供一个新的类别 Service Mesh :
- 概述
- 提供网格概述,显示为代表网格中的命名空间的卡。
- 流量图形
- 提供网格的完整拓扑视图,由节点和边缘表示。每个节点代表网格的一个组件,每个边缘代表通过组件间的网格流的流量。
- Istio 配置
- 提供网格中所有 Istio 配置文件的列表,并提供一个列,以便快速了解每个资源的配置是否有效。
- Mesh(网格)
- 提供有关 Istio 基础架构状态的详细信息。它显示了一个基础架构拓扑视图,其中包含核心和附加组件组件、其健康状况,以及它们如何相互连接。
在 web 控制台 Workloads 详情页面中,OSSMC 插件添加具有以下子选项卡的 Service Mesh 标签页:
- 概述
- 显示所选工作负载的摘要,包括显示具有所有入站和出站边缘和节点的工作负载的本地化拓扑图。
- 流量
- 显示有关所有入站和出站流量到工作负载的信息。
- 日志
- 显示工作负载容器的日志。您可以按日志时间单独查看容器日志,以及 Envoy sidecar 代理日志如何与工作负载的应用程序日志相关。您可以启用追踪范围集成,允许您查看哪些日志与 trace 范围对应。
- 指标
- 在对应的子选项卡中显示入站和出站指标图。所有工作负载指标都在此处,提供工作负载性能的详细视图。您可以启用追踪范围集成,允许您查看与指标同时发生的 span。通过图中的 span 标记,您可以看到与该时间线相关的特定范围。
- trace
- 提供了一个图表,显示给定时间段内收集的 trace 范围。trace span 显示工作负载应用程序中最低级详情。追踪详情进一步显示 heatmaps 提供了与同一时间线内与其他请求和 span 的关系一个跨度的比较。
- Envoy
- 显示有关 Envoy sidecar 配置的信息。
在 web 控制台 网络 详情页面中,OSSMC 插件添加了一个与 Workloads 详情页面类似的 Service Mesh 标签页。
在 web 控制台 Projects 详情页面中,OSSMC 插件添加了一个 Service Mesh 选项卡,它提供有关该项目的流量图形信息。它与 Traffic Graph 页面中显示的信息相同,但特定于该项目。
4.2.2. 安装 OpenShift Service Mesh 控制台插件 复制链接链接已复制到粘贴板!
您可以通过创建带有相应插件设置的 OSSMConsole
资源来使用 Kiali Operator 安装 OSSMC 插件。建议您安装 Kiali Operator 的最新版本,即使安装以前的 OSSMC 插件版本,因为它包括最新的 z-stream 版本。
OSSM 版本 | Kiali Server 版本 | OSSMC 插件版本 | OCP 版本 |
---|---|---|---|
3.1 | v2.11 | v2.11 | 4.16+ |
3.0 | v2.4 | v2.4 | 4.15+ |
2.6 | v1.73 | v1.73 | 4.15-4.18 |
2.5 | v1.73 | v1.73 | 4.14-4.18 |
OSSMC 插件只在 OpenShift Container Platform 4.15 及更高版本中被支持。对于 OpenShift Container Platform 4.14 用户,只能访问独立的 Kiali 控制台。
您可以使用 OpenShift Container Platform Web 控制台或 OpenShift CLI (oc
)安装 OSSMC 插件。
您可以使用 OpenShift Container Platform Web 控制台安装 OpenShift Service Mesh Console (OSSMC)插件。
先决条件
- 具有 OpenShift Container Platform Web 控制台的管理员访问权限。
- 已安装 OpenShift Service Mesh (OSSM)。
-
您已从 OSSM 3.0 安装了
Istio
control plane。 - 已安装 Kiali Server 2.4。
流程
- 进入 Installed Operators。
- 点 由红帽提供的 Kiali Operator。
- 在 Red Hat OpenShift Service Mesh Console 标题上点 Create instance。您还可以在 OpenShift Service Mesh Console 选项卡中点 Create OSSMConsole 按钮。
使用 Create OSSMConsole 表单创建
OSSMConsole
自定义资源 (CR) 的实例。Name 和 Version 是必填字段。注意Version 字段必须与 Kiali 自定义资源(CR)中的
spec.version
字段匹配。如果 Version 值是字符串default
,Kiali Operator 会安装与 Operator 相同的版本的 OpenShift Service Mesh Console (OSSMC)。spec.version
字段需要版本号中的v
前缀。版本号必须只包含主版本和次版本号(而不是补丁号),例如:v1.73
。- 点 Create。
验证
- 等待 web 控制台通知您安装了 OSSMC 插件并提示您刷新。
- 验证 Service Mesh 类别是否在主 OpenShift Container Platform Web 控制台导航中添加。
4.2.2.2. 使用 CLI 安装 OSSMC 插件 复制链接链接已复制到粘贴板!
您可以使用 OpenShift CLI 安装 OpenShift Service Mesh 控制台(OSSMC)插件。
先决条件
-
以管理员身份访问集群中的 OpenShift CLI (
oc
)。 - 已安装 OpenShift Service Mesh (OSSM)。
-
您已从 OSSM 3.0 安装了
Istio
control plane。 - 已安装 Kiali Server 2.4。
流程
运行以下命令,创建一个
OSSMConsole
自定义资源(CR)来安装插件:Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意OpenShift Service Mesh Console (OSSMC)版本必须与 Kiali Server 版本匹配。如果
spec.version
字段值是字符串default
或 未指定,Kiali Operator 将安装 OSSMC,其版本与 Operator 相同。spec.version
字段需要版本号中的v
前缀。版本号必须只包含主版本和次版本号(而不是补丁号),例如:v1.73
。插件资源部署到与
OSSMConsole
CR 相同的命名空间中。可选:如果在集群中安装了多个 Kiali 服务器,请运行以下命令来指定 OSSMC CR 中的
spec.kiali
设置,如下例所示:Copy to Clipboard Copied! Toggle word wrap Toggle overflow
验证
- 进入 OpenShift Container Platform Web 控制台。
- 验证 Service Mesh 类别是否在主 OpenShift Container Platform Web 控制台导航中添加。
- 如果还没有安装 OSSMC 插件,请等待 web 控制台通知您安装了 OSSMC 插件,并提示您刷新。
4.2.3. 卸载 OpenShift Service Mesh 控制台插件 复制链接链接已复制到粘贴板!
您可以使用 OpenShift Container Platform Web 控制台或 OpenShift CLI (oc
)卸载 OSSMC 插件。
在删除 Kiali Operator 前,您必须卸载 OSSMC 插件。首先删除 Operator 可能会保留 OSSMC 和 Kiali CR,需要手动删除终结器。使用以下命令,将 < ;custom_resource_type&
gt; 作为 kiali
或 ossmconsole
来删除终结器(如果需要):
oc patch <custom_resource_type> <custom_resource_name> -n <custom_resource_namespace> -p '{"metadata":{"finalizers": []}}' --type=merge
$ oc patch <custom_resource_type> <custom_resource_name> -n <custom_resource_namespace> -p '{"metadata":{"finalizers": []}}' --type=merge
4.2.3.1. 使用 Web 控制台卸载 OSSMC 插件 复制链接链接已复制到粘贴板!
您可以使用 OpenShift Container Platform Web 控制台卸载 OpenShift Service Mesh Console (OSSMC) 插件。
流程
- 进入 Installed Operators。
- 点 Kiali Operator。
- 选择 OpenShift Service Mesh Console 选项卡。
- 从条目菜单中点 Delete OSSMConsole 选项。
- 确认您要删除插件。
4.2.3.2. 使用 CLI 卸载 OSSMC 插件 复制链接链接已复制到粘贴板!
您可以使用 OpenShift CLI (oc
)卸载 OpenShift Service Mesh Console (OSSMC)插件。
流程
运行以下命令来删除 OSSMC 自定义资源(CR):
oc delete ossmconsoles <custom_resource_name> -n <custom_resource_namespace>
$ oc delete ossmconsoles <custom_resource_name> -n <custom_resource_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
验证
运行以下命令,验证所有 CR 已从所有命名空间中删除:
for r in $(oc get ossmconsoles --ignore-not-found=true --all-namespaces -o custom-columns=NS:.metadata.namespace,N:.metadata.name --no-headers | sed 's/ */:/g'); do oc delete ossmconsoles -n $(echo $r|cut -d: -f1) $(echo $r|cut -d: -f2); done
$ for r in $(oc get ossmconsoles --ignore-not-found=true --all-namespaces -o custom-columns=NS:.metadata.namespace,N:.metadata.name --no-headers | sed 's/ */:/g'); do oc delete ossmconsoles -n $(echo $r|cut -d: -f1) $(echo $r|cut -d: -f2); done
Copy to Clipboard Copied! Toggle word wrap Toggle overflow