keyfil/教程/20250402-使用KtConnect实现本地Debug.md

20250402-使用KtConnect实现本地Debug

前置说明

• 快速开始：https://github.com/alibaba/kt-connect/blob/master/docs/zh-cn/guide/quickstart.md

使用

下载 kt-connect

• 访问 release 页面：https://github.com/alibaba/kt-connect/releases/tag/v0.3.7
• 或者直接使用wget下载

wget https://github.com/alibaba/kt-connect/releases/download/v0.3.7/ktctl_0.3.7_Windows_x86_64.zip

Mesh 服务

用于将指定服务的部分流量重定向到本地。基本用法如下：

ktctl mesh <目标服务名> --expose <本地端口>:<目标服务端口>

命令可选参数：

--mode value         实现流量重定向的路由方式，可选值为 "auto"（默认）和 "manual"
--expose value       指定目标服务的一个或多个端口，格式为`port`或`local:remote`，多个端口用逗号分隔，例如：7001,8080:80
--versionMark value  指定本地服务路由的版本标签值，格式可以是 `<标签值>`，`<标签名>:` 或 `<标签名>:<标签值>`
--skipPortChecking   不必检查指定的本地端口是否有服务监听
--routerImage value  （仅用于auto模式）指定Router Pod使用的镜像地址

关键参数说明：

• --mode提供了两种服务重定向路由的方式。 默认的auto模式采用Router Pod实现HTTP请求的自动路由，无需额外配置服务网格组件，适用于集群中未部署服务网格的场景。 manual模式仅将本地服务"混入"集群中，并打上特定的版本Label，开发者自行通过服务网格组件（如Istio）灵活配置路由规则。
• --expose是一个必须的参数，它的值应当与目标Service的port属性值相同，若本地运行服务的端口与目标Service的port属性值不一致，则应当使用<本地端口>:<目标Service端口>的方式来指定。
• --versionMark用于指定路由到本地的Header或Label名称和值。默认值为"version:<随机生成值>"，可仅指定标签值，如--versionMark demo；可用标签名加冒号的格式仅指定标签名，如--versionMark kt-mark:；也可以同时指定标签的名称和值，如--versionMark kt-mark:demo。 在auto模式下，该值实际上是用于路由的Header。在manual模式下，该值为附加在通往本地服务的Shadow Pod上额外的Label。

例子

• KubeConfig 文件需要找运维拿

.\ktctl.exe mesh <目标服务名> --namespace qifu --expose <本地端口>:<目标服务端口> --kubeconfig /env/.kube/KubeConfig