e2e

name	e2e
description	LoongCollector E2E 测试全流程指南：设计、编写、运行和调试。当需要编写新 E2E 测试、运行现有测试、或排查 E2E 测试失败时使用此 skill。

LoongCollector E2E 测试指南

步骤模板见 reference.md。手动清理可选 scripts/e2e-cleanup.sh。

目录

1. 概览
2. 设计测试用例
3. 编写测试用例
4. 本地运行（docker-compose）
5. 调试
6. 已知陷阱

---

1 概览

基于 BDD Godog，.feature 描述场景，test/engine/steps.go 为步骤权威来源。

test/e2e/test_cases/<case_name>/case.feature
test/engine/          # setup / control / verify / cleanup

环境 tag：@e2e + @docker-compose（或 @host / @k8s）

CI：.github/workflows/e2e.yaml — 矩阵 job 每个 TEST_CASE 单独跑；镜像由 Dockerfile_edge_linux 构建后 docker load；环境变量 DOCKER_BUILDKIT=0、COMPOSE_DOCKER_CLI_BUILD=0。

测试框架（test/engine/setup/dockercompose/）：compose 侧车构建禁用 BuildKit；场景结束后先校验 agent PID 再 cleanup.All()；失败时 TryCopyCoreLogs 导出到 test/e2e/report/<case>_log/。

---

2 设计测试用例

编写 feature 文件前，先确定测试矩阵。按以下维度逐项评估是否需要覆盖：