vxrdhxn/Kontext

# Kōntext Kōntext 通过为 Kubernetes 资源添加组织和操作元数据，使工程师能够快速识别服务归属、部署历史、runbook 以及在生产事件期间所需的其他上下文信息。 ## 概述 Kubernetes 提供了全面的基础设施状态，但缺乏有效的事件响应所需的组织上下文。工程师通常需要花费大量宝贵时间在多个系统中搜索，以确定归属、查找文档或识别最近的更改，然后才能开始排查问题。 Kōntext 通过收集集群事件、使用上下文元数据对其进行丰富，并通过 Web 仪表板和 REST API 呈现统一的操作视图，从而集中管理这些信息。 ## 功能 - Kubernetes 事件监控 - 资源归属映射 - 部署历史跟踪 - Runbook 集成 - 事件时间线生成 - 操作上下文聚合 - RESTful API - 基于 Web 的仪表板 - 基于 PostgreSQL 的持久化存储 - Redis 缓存层 - 基于 Helm 的部署 ## 架构 ``` Kubernetes Cluster │ ▼ Kōntext Kubernetes Agent │ ▼ Fastify REST API Server │ ┌──────────────┴──────────────┐ │ │ ▼ ▼ PostgreSQL Redis Cache │ ▼ Next.js Dashboard ``` ## 技术栈 | 层级 | 技术 | |--------|------------| | 前端 | Next.js 14 | | 样式 | Tailwind CSS | | 后端 | Fastify | | 运行时 | Node.js | | 语言 | TypeScript | | 数据库 | PostgreSQL 16 | | 缓存 | Redis 7 | | Kubernetes 客户端 | @kubernetes/client-node | | 打包 | Helm | | GitOps | Argo CD | | 容器化 | Docker | ## 仓库结构 ``` kontext/ ├── agent/ ├── api/ ├── dashboard/ ├── charts/ ├── docker/ ├── docs/ ├── scripts/ └── README.md ``` ## 前置条件 - Node.js 22 或更高版本 - PostgreSQL 16 - Redis 7 - Docker - Kubernetes 1.30+ - Helm 3.x ## 快速开始 ### 克隆仓库 ``` git clone https://github.com//kontext.git cd kontext ``` ### 安装依赖 ``` npm install ``` ### 配置环境变量 ``` cp .env.example .env ``` 在启动应用之前更新配置值。 ### 启动开发环境 ``` npm run dev ``` ## 部署 使用 Helm 部署 Kōntext。 ``` helm install kontext ./charts/kontext ``` ## API 后端暴露了以下用途的 REST endpoint： - 事件摄取 - 上下文检索 - 归属查找 - 部署历史 - 事件时间线 示例： ``` POST /internal/events ``` ## 开发 在开发过程中启动各个独立服务。 ### 后端 ``` cd api npm install npm run dev ``` ### 仪表板 ``` cd dashboard npm install npm run dev ``` ### Kubernetes Agent ``` cd agent npm install npm run dev ``` ## 路线图 ### 当前 - Kubernetes Agent - 事件收集 - Context API - 仪表板 - PostgreSQL 集成 - Redis 集成 - Helm 部署 ### 计划中 - 多集群支持 - GitHub 集成 - Prometheus 集成 - Grafana 集成 - 服务依赖图 - AI 辅助事件摘要 - RBAC 支持 - 审计日志 ## 许可证 本项目基于 MIT License 授权。 ## 文档 `docs/` 目录中提供了更多文档。 - 架构 - API 参考 - 部署指南 - 开发指南 - 贡献指南

标签：Fastify, MITM代理, PostgreSQL, 可见性, 搜索引擎查询, 测试用例, 请求拦截, 运维监控