微服務(wù)后端開(kāi)發(fā)的最大痛點(diǎn)之一就是調(diào)試?yán)щy，非常影響我們的開(kāi)發(fā)效率。

如果我們想與其他微服務(wù)進(jìn)行聯(lián)動(dòng)調(diào)試，則需要在本地環(huán)境中啟動(dòng)對(duì)應(yīng)的微服務(wù)模塊，這可能需要大量的配置和構(gòu)建時(shí)間，同時(shí)也會(huì)占用我們本地很多資源，可能還會(huì)出現(xiàn)”帶不動(dòng)“的情況。

雖然說(shuō)我們可以在測(cè)試服務(wù)器上進(jìn)行調(diào)試，但整個(gè)流程也是比較漫長(zhǎng)，「提交代碼 -> 觸發(fā)CI/CD -> 等待構(gòu)建成功」，可能簡(jiǎn)單的 BUG 我們提交代碼打個(gè)日志就能解決問(wèn)題，當(dāng)遇到復(fù)雜的 BUG 時(shí)通過(guò)這個(gè)方式在服務(wù)器上調(diào)試就非常難受了，太浪費(fèi)時(shí)間了，「提交 -> 等待」，反反復(fù)復(fù)，始終沒(méi)有本地開(kāi)發(fā)工具直接調(diào)試的方便。

下面介紹的工具將遠(yuǎn)程和本地融為一體，讓本地開(kāi)發(fā)更加流暢。

Telepresence

Telepresence 是一個(gè)開(kāi)源工具，用于在本地開(kāi)發(fā)環(huán)境中模擬 Kubernetes 集群中的微服務(wù)，它允許開(kāi)發(fā)人員在本地開(kāi)發(fā)環(huán)境中運(yùn)行和調(diào)試微服務(wù)，而不必?fù)?dān)心環(huán)境的復(fù)雜性和配置困難。

簡(jiǎn)單來(lái)說(shuō) Telepresence 將 Kubernetes 集群中服務(wù)的流量代理到本地，Telepresence 主要有四個(gè)服務(wù)：

「Telepresence Daemon:」 本地的守護(hù)進(jìn)程，用于集群通信和攔截流量。

「Telepresence Traffic Manager:」 集群中安裝的流量管理器，代理所有相關(guān)的入站和出站流量，并跟蹤主動(dòng)攔截。

「Telepresence Traffic Agent:」 攔截流量的 sidecar 容器，會(huì)注入到工作負(fù)載的 POD 中。

「Ambassador Cloud:」 SaaS 服務(wù)，結(jié)合 Telepresence 一起使用，主要是生成預(yù)覽 URL 和一些增值服務(wù)。

全局流量攔截

全局流量攔截是將 Orders 的所有流量都攔截到我們本地開(kāi)發(fā)機(jī)上，如下圖。

個(gè)人流量攔截

「?jìng)€(gè)人流量攔截」允許選擇性地?cái)r截服務(wù)的部分流量，而不會(huì)干擾其余流量。這使我們可以與團(tuán)隊(duì)中的其他人共享一個(gè)集群，而不會(huì)干擾他們的工作。每個(gè)開(kāi)發(fā)人員都可以只針對(duì)他們的請(qǐng)求攔截 Orders 服務(wù)，同時(shí)共享開(kāi)發(fā)環(huán)境的其余部分。

個(gè)人攔截需要配合 Ambassador Cloud 使用，這是一項(xiàng)收費(fèi)服務(wù)，免費(fèi)用戶可以最多攔截 3 個(gè)服務(wù)。

結(jié)合 Telepresence 開(kāi)發(fā)調(diào)試 Rainbond 上的微服務(wù)

• 基于主機(jī)安裝 Rainbond ^[1]或基于 Helm 安裝 Rainbond^[2]。

安裝 Telepresence

MacOS：

#Intel
brewinstalldatawire/blackbird/telepresence

#M1
brewinstalldatawire/blackbird/telepresence-arm64

Windows：

#使用管理員身份打開(kāi)Powershell

#下載壓縮包
Invoke-WebRequesthttps://app.getambassador.io/download/tel2/windows/amd64/latest/telepresence.zip-OutFiletelepresence.zip

#解壓縮包
Expand-Archive-Pathtelepresence.zip-DestinationPathtelepresenceInstaller/telepresence
Remove-Item'telepresence.zip'
cdtelepresenceInstaller/telepresence

#安裝
powershell.exe-ExecutionPolicybypass-c".'.install-telepresence.ps1';"

安裝 Telepresence 流量管理器到集群中

可以使用 Telepresence 快速安裝 Traffic Manager，本地需要有 kubeconfig 文件 ~/.kube/config。

$telepresencehelminstall
...
TrafficManagerinstalledsuccessfully

或者在 Kubernetes 集群中使用 Helm 安裝 Traffic Manager^[3]。

本地連接遠(yuǎn)程服務(wù)

本地使用 telepresence connect 連接遠(yuǎn)程 Kubernetes API Server，本地需要有 kubeconfig 文件 ~/.kube/config

$telepresenceconnect
connectedtocontext

在 Rainbond 上快速部署 Pig 微服務(wù)應(yīng)用

通過(guò) Rainbond 開(kāi)源應(yīng)用商店快速部署 Pig 微服務(wù)應(yīng)用，部署后如下圖

后面會(huì)以 pig-auth 這個(gè)服務(wù)為例，演示本地開(kāi)發(fā)調(diào)試的流程，這里需要做一些小改動(dòng)：

1. 從應(yīng)用商店安裝的應(yīng)用默認(rèn) Workload 是字符串，需要修改 Workload 為易于查看的，這里以 pig-auth 為例，進(jìn)入組件中編輯組件名稱，修改組件英文名稱為 auth

2. 簡(jiǎn)單來(lái)說(shuō) telepresence 的工作原理就是代理 k8s service，默認(rèn) gateway 到 auth 是使用的 nacos 做的負(fù)載均衡，這樣的話 telepresence 是無(wú)法攔截到流量的，我們需要修改 gateway 配置使用 k8s service 做負(fù)載均衡。

• 打開(kāi) pig-register 組件的 8848 對(duì)外端口，訪問(wèn) nacos，修改 pig-gateway-dev.yml 的 spring.cloud.gateway.routes.uri: http://gr795b69:3000 ，gr795b69:3000 通過(guò) pig-auth 組件內(nèi)的端口訪問(wèn)地址獲取。

• 如果本地只啟動(dòng)一個(gè) pig-auth 服務(wù)，pig-auth 需要連接 pig-register 和 redis，那么就需要將這倆服務(wù)的對(duì)外端口打開(kāi)，并修改配置文件讓本地的 pig-auth 服務(wù)可以連接遠(yuǎn)程到 pig-register 和 redis。

在本地調(diào)試 auth 服務(wù)

使用 IDEA 或 VScode 在本地啟動(dòng) pig-auth 服務(wù)。

在本地使用 telepresence 攔截 pig-auth 流量，命令如下：

$telepresenceintercept--port<local-port>:-n

命令拆解：

#
#需要攔截流量的服務(wù)workload
$kubectlgetdeploy-nzq
NAMEREADYUP-TO-DATEAVAILABLEAGE
pig-auth1/111146m

#本地端口

#
#需要攔截流量的服務(wù)的serviceportname
$kubectlgetsvcgr795b69-nzq-oyaml
...
ports:
-name:http-3000
port:3000
protocol:TCP
targetPort:3000
...

#命名空間

最終命令：

$telepresenceinterceptpig-auth--port3000:http-3000-nzq
UsingDeploymentpig-auth
intercepted
Interceptname:pig-auth-zq
State:ACTIVE
Workloadkind:Deployment
Destination:127.0.0.1:3000
ServicePortIdentifier:http-3000
VolumeMountError:sshfsisnotinstalledonyourlocalmachine
Intercepting:allTCPrequests

我們?cè)诒镜亟o退出登陸這塊邏輯打上斷點(diǎn)，然后通過(guò)線上的前端退出登陸，打到我們本地 IDEA上，整體效果如下：

最后

Telepresence 可以幫助我們簡(jiǎn)化本地開(kāi)發(fā)流程，同時(shí)保證代碼的正確性和可靠性。還能使我們?cè)诩褐休p松調(diào)試和測(cè)試代碼，提高開(kāi)發(fā)效率。結(jié)合 Rainbond 的部署簡(jiǎn)化，從開(kāi)發(fā)到部署都非常的簡(jiǎn)單，讓我們專注于代碼編寫(xiě)。