Files

Ivan087 985369d40f fix: resolve deployment API errors and enable E2E deployment flow

Backend fixes:
- instance_dto: add Version field with Normalize() to support both 'version'
  and 'tag' field names from frontend
- instance_handler: add version empty validation before creating instance
- authz.go: fix unused variable compilation error
- registry_repository: fix GetByID/GetByName to use correct DB schema
  (add workspace_id, owner_id, is_shared fields); decrypt password
  gracefully when encryption key mismatches instead of returning error

Frontend:
- charts/page: add Template and Storage dropdown selectors to Deploy Modal

Testing:
- add e2e_test.py: 5-step Playwright E2E test (admin login → create
  workspace → create user → user login → deploy chart)
- add tasks/lesson.md: document 4 bug root causes and fixes
- add tasks/todo.md: track implementation progress
- add PLAN_E2E_DEPLOYMENT.md: comprehensive implementation plan

Verification: confirmed deployment creates instance with status=deployed,
chart downloads from Harbor OCI to /tmp/charts/, Helm release deploys to K8s

2026-04-16 18:39:23 +08:00

2.0 KiB

Raw Blame History

Lessons Learned

Bug 1: Frontend/Bulk Field Name Mismatch (2026-04-16)

现象: 部署 API 返回 400 "invalid version"，即使前端传了正确的 version 根因: 前端发送 JSON 字段 version，但 DTO 只有 Tag（json: tag），handler 读 req.Tag 始终为空修复: 在 CreateInstanceRequest 中添加 Version 字段，并在 Normalize() 中将 Version 复制到 Tag How to apply: 前后端接口字段名必须一致。DTO 的 json tag 应与前端发送的字段名匹配，或在 Normalize() 中做兼容映射

Bug 2: Registry Decrypt Fails with Key Mismatch (2026-04-16)

现象: GET /registries 列表正常，但 GET /registries/{id} 返回 404 "failed to decrypt password" 根因: 旧数据用不同 ENCRYPTION_KEY 加密，GetByID/GetByName 解密失败直接返回 error 修复: 解密失败时返回空密码而非错误（与 List 方法行为一致） Why: 列表查询不触发解密（_ = r.encryptor.Decrypt），但单条查询需要解密。密钥不匹配不应阻断核心业务流程 How to apply: 涉及敏感数据解密时，对密钥不匹配的情况做 graceful fallback 而非直接报错

Bug 3: Docker Compose Project Conflict (2026-04-16)

现象: 从 backend/ 目录运行 docker compose 时报错 "container name already in use" 根因: 容器通过不同 compose 项目启动（ocdp-go vs backend），但使用了相同的容器名修复: 直接用 docker 命令重启旧容器：docker stop/rm 后用 docker run 启动新镜像 How to apply: 当有多个 compose 文件管理同一网络时，docker run 方式更灵活

Bug 4: InitSchema vs Actual DB Schema Mismatch (2026-04-16)

现象: InitSchema() 创建的 registries 表缺少 workspace_id, owner_id, is_shared 字段根因: 代码中的 InitSchema 与实际 init-db.sql 不同步影响: GetByID/GetByName 查询时字段数不匹配会报错 Fix: 修复 GetByID/GetByName 的查询和 Scan，使用实际的 DB schema How to apply: InitSchema() 和实际 DB schema 必须保持同步

2.0 KiB Raw Blame History Unescape Escape