add blog for e2e debug (#195)

blog/e2e-debug.md

@@ -0,0 +1 @@
+Placeholder. DO NOT DELETE.

docs/dev/e2e-debug.md

@@ -0,0 +1 @@
+Placeholder. DO NOT DELETE.

i18n/zh-cn/docusaurus-plugin-content-blog/e2e-debug.md

@@ -0,0 +1,140 @@
+---
+title: 教程：如何在本地进行higress调试和端到端测试
+keywords: [higress]
+description: 在本地快速完成e2e测试并实现debug功能
+author: SJC
+date: 2023-12-19
+custom_edit_url: https://github.com/higress-group/higress-group.github.io/blob/main/i18n/en/docusaurus-plugin-content-blog/e2e-debug.md
+---
+
+## 背景说明
+
+### 本地调试
+
+本地调试旨在在开发者的本地开发环境中识别、定位和修复代码中的错误（bug）。这个阶段的主要目标是确保单个模块或组件的正确性，以便更容易理解和解决问题。
+
+开发者通常使用本地集成开发环境（IDE）或调试器来逐步执行代码、查看变量的值、观察程序的流程，并通过打断点来检查代码的执行过程。
+
+本地调试是一个快速、迅速定位问题并进行修复的阶段，能够提供实时的反馈。它有助于确保代码的局部正确性，而不需要考虑整个系统的交互。
+
+### 端到端测试
+
+e2e测试是一种端到端的测试，是一种全面的测试方法，用于验证整个软件系统在真实环境中的功能和性能。它模拟用户的实际使用情况，确保整个系统的各个部分正确协同工作，以达到用户期望的功能。
+
+端到端测试关注整个系统的集成和交互，旨在发现不同组件之间的问题以及在实际使用场景中可能出现的 bug。这有助于确保系统在生产环境中的稳定性和可靠性。
+
+在higress中，e2e测试的主要流程可用下图来表示：
+
+```mermaid
+graph LR;
+    删除kind集群 --> 创建kind集群 --> 构建镜像  --> 加载镜像 --> 安装higress --> 运行e2e测试 --> 删除kind集群
+```
+
+### 弊端
+
+在本地开发的过程中，我们需要频繁的进行e2e测试，但是每次都要重新构建镜像、加载镜像、安装higress、运行e2e测试，这样的过程非常耗时，因此我们需要一个快速的方法来完成e2e测试。
+另外makefile命令不支持debug功能，我们也需要一个方法来实现debug功能。
+
+### 解决方案
+
+可分为端到端测试的优化和在端到端测试中实现本地调试的功能，端到端优化可采用实现测试环境复用的方法，通过修改makefile文件来减少环境的创建等开销。
+
+而在端到端测试中实现本地调试的功能，可通过Goland来实现，提前准备好测试环境，修改e2e测试的部分代码来减少e2e环境创建的开销，更加方便的实现debug功能。
+
+## 具体实现
+
+### 端到端测试优化
+
+通过makefile来完成，包含启动系列环境和执行e2e测试。
+
+以运行插件测试为例，其make命令如下：
+
+```makefile
+.PHONY: higress-wasmplugin-test
+higress-wasmplugin-test: $(tools/kind) delete-cluster create-cluster docker-build kube-load-image install-dev-wasmplugin run-higress-e2e-test-wasmplugin delete-cluster
+```
+
+开发者首次运行环境可先删除最后一个`delete-cluster`的操作，第二次运行e2e测试的时候可以删除前面的操作，只保留`run-higress-e2e-test-wasmplugin`的操作，这样就可以减少很多时间。
+
+然而make命令不支持添加到goland里面实现debug功能，运行出错的时候也不方便定位问题，更推荐使用下面这个方法。
+
+### 在e2e中实现本地调试
+
+通过Goland来完成，提前准备好环境，修改Goland启动参数来完成本地调试。
+
+- e2e测试之前的准备
+
+根据各自的需求来定制环境，如果测试环境中需要用到higress的controller、gateway等组件，需要提前本地安装好环境，安装教程可参考[这里](https://higress.io/zh-cn/docs/user/quickstart/)。
+
+使用helm安装好higress后，可以使用如下命令来查看higress的pod是否正常运行：
+
+```shell
+kubectl get pods --all-namespaces
+```
+
+显示结果如下图所示：
+
+![1.png](../../../static/img/blog/e2e-debug1.png)
+
+都显示Running状态，说明higress已经正常运行。
+
+- e2e的flag修改
+
+在`test/e2e/conformance/utils/flags`目录下，有一个`flags.go`文件，里面定义了e2e测试的flag：
+
+```go
+var (
+    IngressClassName     = flag.String("ingress-class", "higress", "Name of IngressClass to use for tests")
+    ShowDebug            = flag.Bool("debug", false, "Whether to print debug logs")
+    CleanupBaseResources = flag.Bool("cleanup-base-resources", true, "Whether to cleanup base test resources after the run")
+    SupportedFeatures    = flag.String("supported-features", "", "Supported features included in conformance tests suites")
+    ExemptFeatures       = flag.String("exempt-features", "", "Exempt Features excluded from conformance tests suites")
+    IsWasmPluginTest     = flag.Bool("isWasmPluginTest", false, "Determine if run wasm plugin conformance test")
+    WasmPluginType       = flag.String("wasmPluginType", "GO", "Define wasm plugin type, currently supports GO, CPP")
+    WasmPluginName       = flag.String("wasmPluginName", "", "Define wasm plugin name")
+    IsEnvoyConfigTest    = flag.Bool("isEnvoyConfigTest", false, "Determine if run envoy config conformance test")
+)
+```
+可临时修改这些flag的初始值，也可以在Goland编辑器中定义启动参数，例如设置`IsWasmPluginTest`为true可只运行wasm插件的e2e测试。
+
+修改好flag之后，我们就可以在Goland中通过debug的方式运行e2e测试。可先在如下位置添加一个断点，等待e2e环境准备完毕：
+
+![2.png](../../../static/img/blog/e2e-debug2.png)
+
+e2e测试在前期环境准备的过程中会创建一些namespace并启动一些pod，可以手动查看一下pod的启动情况。
+
+![img.png](../../../static/img/blog/e2e-debug3.png)
+
+在这张图里面，除了我们提前安装好的higress组件之外，还有一些其他的pod，这些pod是e2e测试过程中创建的，如果有些pod在本地e2e测试中用不到，可手动修改代码来减少前期环境的准备时间。
+
+> 注意：如果设置了cleanup-base-resources为false，那么e2e测试结束之后，这些pod不会被删除，但是重启的时候会报错，例如：
+> ```
+> Pod "consul-standlone" is invalid: spec: Forbidden: pod updates may not change fields other than `spec.containers[*].image`, `spec.initContainers[*].image`, `spec.activeDeadlineSeconds`, `spec.tolerations` (only additions to existing tolerations) or `spec.terminationGracePeriodSeconds` (allow it to be set to 1 if it was previously negative)
+> ```
+
+> 建议设置为true，每次测试完需要等待pod的销毁，然后重新测试，这些过程一般很快，也可以修改代码来减少一些pod的创建。
+
+- e2e测试环境优化
+
+例如只需要higress环境，而不需要`higress-conformance-infra`,`higress-conformance-app-backend`等namespace环境，可以手动在如下几行代码里添加注释，来跳过这些环境的创建，然后测试中只用到了higress的组件：
+
+![img.png](../../../static/img/blog/e2e-debug4.png)
+
+在这里，我只需要运行`EnvoyConfigTracing`的Test测试，它只跟higress有关，注释掉了其他namespace的准备环境，可以看到e2e测试不到1s就结束了。
+
+如果需要其他namespace的环境，而不需要nacos/consul等环境，可以在suite的New方法里找到以下代码块，根据需要进行注释：
+
+```go
+// apply defaults
+if suite.BaseManifests == nil {
+	suite.BaseManifests = []string{
+		"base/manifests.yaml",
+		"base/consul.yaml",
+		"base/eureka.yaml",
+		"base/nacos.yaml",
+		"base/dubbo.yaml",
+	}
+}
+```
+
+解决好e2e测试的环境相关问题，我们就可以在Goland里添加自己想要的断点，来debug测试用例了。

i18n/zh-cn/docusaurus-plugin-content-docs/current/dev/e2e-debug.md

@@ -0,0 +1,10 @@
+---
+title: 本地开发Debug指引
+keywords: [higress]
+description: 在本地快速完成e2e测试并实现debug功能
+author: SJC
+date: 2023-12-19
+custom_edit_url: https://github.com/higress-group/higress-group.github.io/blob/main/i18n/zh-cn/docusaurus-plugin-content-docs/current/dev/e2e-debug.md
+---
+
+[教程链接](https://higress.io/zh-cn/blog/e2e-debug)