\350\267\250APP\350\260\203\350\257\225\346\226\271\346\263\225.md
... ...
@@ -0,0 +1,76 @@
1
+
2
+## 准备环境
3
+
4
+为了实现跨应用的调试，我们需要准备两套环境：远程环境和本地环境。
5
+
6
+### 1. 远程环境
7
+
8
+远程环境是一套完整的Kubernetes (K8s) 开发环境。你需要确保该环境已经正确安装并配置好Kubesphere平台。比如类似于下图的环境：
9
+
10
+[[http://iidp.chinasie.com:9999/iidpminio/remote-debug/ks.png]]
11
+
12
+### 2. 本地环境
13
+
14
+本地环境则是我们日常开发所用的环境。我们可以选择使用IDEA或其他任何支持调试的应用程序开发环境。除了常规的开发工具外，我们还需要搭建一套本地与远程环境互通的隧道系统。
15
+
16
+#### 本地与远程环境互通的隧道
17
+
18
+这里我们将使用阿里巴巴开源的KT Connect工具来实现这一目标。详细使用方式及其实现原理请参阅 [kt-connect 官方文档](https://alibaba.github.io/kt-connect/#/zh-cn/guide/quickstart)，[github源码](https://github.com/alibaba/kt-connect)
19
+
20
+### 搭建本地与远程环境互通的隧道
21
+
22
+1. **安装 KT Connect**
23
+
24
+ 根据你的操作系统下载并安装KT Connect。对于Windows用户，可以直接下载预编译的二进制文件。
25
+
26
+2. **启动KT Connect**
27
+
28
+ 打开终端或命令提示符窗口，执行以下命令启动KT Connect：
29
+
30
+ ```sh
31
+ ktctl connect -n=<命名空间> -c=<k8s集群kubeconfig>
32
+ ```
33
+
34
+ 替换 `<命名空间>` 和 `<k8s集群kubeconfig>` 为实际值。
35
+
36
+ 下图是我本地，展示了启动过程中详细的流程和功能
37
+
38
+ [[http://iidp.chinasie.com:9999/iidpminio/remote-debug/ktctl.png]]
39
+
40
+ 启动成功后，ktctl会在本地创建一个tun设备：
41
+
42
+ [[http://iidp.chinasie.com:9999/iidpminio/remote-debug/tun.png]]
43
+
44
+ 同时也会在远程k8s集群创建一个pod
45
+
46
+ [[http://iidp.chinasie.com:9999/iidpminio/remote-debug/ks2.png]]
47
+
48
+## 开始本地调试
49
+
50
+一旦所有准备工作就绪，接下来就是具体的调试流程。
51
+
52
+### 开启IDEA Debug模式
53
+
54
+1. **打开项目**
55
+
56
+ 在IDEA中打开你要调试的项目。也是我们经常使用的在 IDEA中iidp-server 和app或者引擎源码的开发方式
57
+
58
+2. **启动Debug**
59
+
60
+我们查看debug调试过程中的集中情况，
61
+如果路由在本地，则直接执行本地方法。
62
+
63
+[[http://iidp.chinasie.com:9999/iidpminio/remote-debug/local-route.png]]
64
+
65
+
66
+如果路由是在其他服务中，也就是跨app且这个app安装在其他服务中
67
+
68
+[[http://iidp.chinasie.com:9999/iidpminio/remote-debug/remote-route.png]]
69
+
70
+可以发现虽然跨app访问的ip是远程集群内网ip，但是由于ktctl打通了这个隧道，我们依然可以在本地访问远程的ip
71
+
72
+[[http://iidp.chinasie.com:9999/iidpminio/remote-debug/call-success.png]]
73
+
74
+## 结论
75
+
76
+通过以上步骤，你应该能够顺利地实现本地和远程跨app的调试.如果想继续探索远程k8s流量转发到本地来进行调试，可以使用ktctl.exe exchange，感兴趣的可以参考ktctl官方文档各种功能并自行实现。