wooo/ewoooc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

標記 aiops-core 為歷史草稿

Browse Source
This commit is contained in:
OoO
2026-05-13 09:09:51 +08:00
parent 992047ba2a
commit 9849c979c6
2 changed files with 11 additions and 251 deletions
Download Patch File Download Diff File Expand all files Collapse all files

206
aiops-core/README.md
View File

@@ -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.

56
aiops-core/requirements.txt
View File

@@ -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