From 9849c979c610817da2f02021a327d76876c3b1d6 Mon Sep 17 00:00:00 2001 From: OoO Date: Wed, 13 May 2026 09:09:51 +0800 Subject: [PATCH] =?UTF-8?q?=E6=A8=99=E8=A8=98=20aiops-core=20=E7=82=BA?= =?UTF-8?q?=E6=AD=B7=E5=8F=B2=E8=8D=89=E7=A8=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- aiops-core/README.md | 206 ++---------------------------------- aiops-core/requirements.txt | 56 ---------- 2 files changed, 11 insertions(+), 251 deletions(-) delete mode 100644 aiops-core/requirements.txt diff --git a/aiops-core/README.md b/aiops-core/README.md index 380be21..5ca1c15 100644 --- a/aiops-core/README.md +++ b/aiops-core/README.md @@ -1,200 +1,16 @@ # WOOO AIOps Core -智慧雲端運維平台核心模組 +> Historical stub only. Do not install dependencies or deploy services from this +> directory. -## 架構概覽 +This directory originally sketched a standalone AIOps SaaS module, but the +actual production implementation now lives in the main momo-pro-system codebase: -``` -aiops-core/ -├── deploy_engine/ # 部署引擎 -│ ├── deploy_service.py # 主部署服務 -│ ├── template_renderer.py # Jinja2 模板渲染 -│ └── k8s_client.py # Kubernetes 客戶端 -│ -├── monitor_engine/ # 監控引擎 -│ ├── monitor_service.py # 監控服務 -│ ├── prometheus_client.py # Prometheus API -│ └── alert_manager.py # Alertmanager API -│ -├── repair_engine/ # 自動修復引擎 -│ ├── repair_service.py # 修復決策引擎 -│ ├── repair_executor.py # 修復執行器 -│ └── repair_strategies.py # 修復策略 -│ -├── templates/ # K8s 部署模板 -│ ├── base/ # 基礎模板 -│ │ ├── namespace.yaml.j2 -│ │ ├── service.yaml.j2 -│ │ └── ingress.yaml.j2 -│ └── frameworks/ # 框架專用模板 -│ ├── fastapi/ -│ ├── flask/ -│ ├── express/ -│ └── nextjs/ -│ -├── api/ # FastAPI 後端 -│ ├── main.py # 應用入口 -│ └── routers/ # API 路由 -│ ├── auth.py # 認證 -│ ├── apps.py # 應用管理 -│ ├── deployments.py # 部署管理 -│ ├── monitoring.py # 監控 -│ ├── repairs.py # 自動修復 -│ └── users.py # 用戶管理 -│ -└── web/ # React 前端 - ├── src/ - │ ├── pages/ # 頁面 - │ ├── components/ # 組件 - │ └── lib/ # 工具庫 - └── package.json -``` +- Current AutoHeal service: `services/auto_heal_service.py` +- Current Aider heal executor: `services/aider_heal_executor.py` +- Architecture decision: `docs/adr/ADR-013-aiops-autoheal.md` +- Full-auto code-heal decision: `docs/adr/ADR-020-code-review-full-autoheal.md` -## 核心功能 - -### 1. Deploy Engine - 一鍵部署 - -```python -from aiops_core.deploy_engine import DeployService - -deploy_service = DeployService() - -# 部署新應用 -result = deploy_service.deploy( - app=AppConfig( - name="my-api", - framework="fastapi", - git_repo="https://github.com/user/repo.git", - branch="main" - ) -) -``` - -### 2. Monitor Engine - 智能監控 - -```python -from aiops_core.monitor_engine import MonitorService - -monitor_service = MonitorService() - -# 設置監控 -monitor_service.setup_monitoring( - config=MonitorConfig( - app_name="my-api", - namespace="default", - telegram_chat_id="123456789" - ) -) - -# 取得健康狀態 -health = monitor_service.get_app_health("my-api", "default") -``` - -### 3. Repair Engine - 自動修復 - -```python -from aiops_core.repair_engine import RepairService - -repair_service = RepairService() - -# 處理告警，自動決定並執行修復 -repair_service.process_alert({ - "labels": { - "alertname": "HighMemoryUsage", - "app": "my-api", - "namespace": "default" - } -}) -``` - -## 支援的框架 - -| 框架 | 狀態 | 預設端口 | -|------|------|---------| -| FastAPI | ✅ | 8000 | -| Flask | ✅ | 5000 | -| Express.js | ✅ | 3000 | -| Next.js | ✅ | 3000 | -| Django | 🚧 | 8000 | -| NestJS | 🚧 | 3000 | - -## 自動修復策略 - -| 告警類型 | 修復動作 | -|---------|---------| -| AppDown | 重啟 Pod | -| HighMemoryUsage | 重啟 Pod | -| PodOOMKilled | 增加記憶體限制 +50% | -| HighCPUUsage | 擴容 +50% | -| HighHTTP5xxRate | 回滾到上一版本 | -| PostgresHighConnections | VACUUM ANALYZE | -| DiskSpaceLow | 清理快取 | - -## API 端點 - -### 認證 -- `POST /api/auth/login` - 登入 -- `POST /api/auth/register` - 註冊 -- `GET /api/auth/me` - 取得當前用戶 - -### 應用管理 -- `GET /api/apps` - 列出應用 -- `POST /api/apps` - 創建應用 -- `GET /api/apps/{id}` - 取得應用詳情 -- `PUT /api/apps/{id}` - 更新應用 -- `DELETE /api/apps/{id}` - 刪除應用 -- `POST /api/apps/{id}/start` - 啟動應用 -- `POST /api/apps/{id}/stop` - 停止應用 -- `POST /api/apps/{id}/restart` - 重啟應用 - -### 部署 -- `GET /api/deployments` - 列出部署記錄 -- `POST /api/deployments` - 創建部署 -- `POST /api/deployments/{id}/cancel` - 取消部署 -- `POST /api/deployments/{id}/rollback` - 回滾部署 - -### 監控 -- `GET /api/monitoring/dashboard` - 儀表板概覽 -- `GET /api/monitoring/apps/{id}/metrics` - 應用指標 -- `GET /api/monitoring/apps/{id}/health` - 健康狀態 -- `GET /api/monitoring/alerts` - 告警列表 - -### 自動修復 -- `GET /api/repairs` - 修復記錄 -- `GET /api/repairs/stats` - 修復統計 -- `POST /api/repairs/apps/{id}/trigger` - 手動觸發修復 - -## 快速開始 - -### 啟動 API 服務 - -```bash -cd aiops-core/api -pip install -r requirements.txt -uvicorn main:app --reload --port 8000 -``` - -### 啟動 Web 前端 - -```bash -cd aiops-core/web -npm install -npm run dev -``` - -## 環境變數 - -```bash -# API -JWT_SECRET=your-secret-key -PROMETHEUS_URL=http://prometheus:9090 -ALERTMANAGER_URL=http://alertmanager:9093 -TELEGRAM_BOT_TOKEN=your-bot-token - -# Web -NEXT_PUBLIC_API_URL=http://localhost:8000/api -``` - -## 授權 - -© 2026 WOOO TECH. All rights reserved. +The previous `aiops-core/requirements.txt` listed dependencies for non-existent +FastAPI, React, Kubernetes, Redis, and Celery modules. It was removed to avoid +dependency drift and accidental installation in CI or local setup scripts. diff --git a/aiops-core/requirements.txt b/aiops-core/requirements.txt deleted file mode 100644 index 70c5709..0000000 --- a/aiops-core/requirements.txt +++ /dev/null @@ -1,56 +0,0 @@ -# ============================================================================= -# WOOO AIOps - Python Dependencies -# ============================================================================= - -# Web Framework -fastapi>=0.109.0 -uvicorn[standard]>=0.27.0 -python-multipart>=0.0.6 - -# Database -sqlalchemy>=2.0.0 -psycopg2-binary>=2.9.9 -alembic>=1.13.0 - -# Authentication -pyjwt>=2.8.0 -passlib[bcrypt]>=1.7.4 - -# Template Rendering -jinja2>=3.1.2 -pyyaml>=6.0.1 - -# HTTP Client -requests>=2.31.0 -httpx>=0.26.0 - -# Kubernetes -kubernetes>=29.0.0 - -# Monitoring & Alerting -prometheus-client>=0.19.0 - -# Caching -redis>=5.0.0 - -# Task Queue (可選) -celery>=5.3.0 - -# Utilities -python-dotenv>=1.0.0 -pydantic>=2.5.0 -pydantic-settings>=2.1.0 - -# Logging -structlog>=24.1.0 - -# Testing -pytest>=7.4.0 -pytest-asyncio>=0.23.0 -httpx>=0.26.0 - -# Security -cryptography>=41.0.0 - -# Date/Time -python-dateutil>=2.8.2