AIOpsLab

环境要求

• Python >= 3.11
• Helm（用于部署微服务云环境）
• Poetry（推荐）或 pip
• 一个可用的 Kubernetes 集群，本机 kubectl context 已指向该集群（远程集群需配 Ansible，另见 scripts/ansible/
• 运行远程服务时需可访问的宿主机与端口

安装与启动步骤

1. 1安装 Python 3.11

   在 Linux 上用 apt 安装 Python 3.11 及其 venv、dev 组件，AIOpsLab 要求 Python 版本不低于 3.11。

   sudo apt update
   sudo apt install python3.11 python3.11-venv python3.11-dev -y

   复制

2. 2安装 Poetry

   使用官方安装脚本，不要用 apt 版本（已过时）；安装后把 Poetry 的 bin 目录加入 PATH。

   curl -sSL https://install.python-poetry.org | python3.11 -
   export PATH="$HOME/.local/bin:$PATH"

   复制

3. 3克隆仓库

   必须带 --recurse-submodules，否则子模块缺失会导致后续运行异常；示例使用官方仓库地址。

   git clone --recurse-submodules https://github.com/microsoft/AIOpsLab.git

   复制

4. 4安装项目依赖

   进入目录，指定 Python 3.11 作为 Poetry 环境，安装依赖并激活虚拟环境。若报 lock file 不兼容先跑 poetry lock。

   cd AIOpsLab
   poetry env use python3.11
   poetry install
   eval $(poetry env activate)

   复制

5. 5准备 Kubernetes 集群

   用远程集群需先按 docs 里的 Ansible README 搭建集群，然后更新 config.yml 中的集群配置；kubectl context 需指向目标集群。

6. 6运行本地 CLI 智能体

   启动交互式 CLI 后，输入 start 加问题 ID 开始任务，等待环境准备完成后用 submit("Yes") 提交解答。

   python3 cli.py

   复制

7. 7启动远程服务

   在资源更大的远程机器上启动 AIOpsLab 服务，通过环境变量指定监听地址、端口和工作进程数。

   SERVICE_HOST= SERVICE_PORT= SERVICE_WORKERS= python service.py

   复制

8. 8远程调用智能体

   先在远程机器启动 vLLM（可选），再从本地用 curl 提交 simulate 请求，指定问题、智能体与采样参数。

   chmod +x ./clients/launch_vllm.sh
   ./clients/launch_vllm.sh
   curl -X POST http://:/simulate -H "Content-Type: application/json" -d '{"problem_id": "misconfig_app_hotel_res-mitigation-1", "agent_name": "vllm", "max_steps": 10, "temperature": 0.7, "top_p": 0.9}'

   复制

关键配置

如何确认成功

远程服务可执行 curl http://:/health 检查健康状态，并可用 /problems、/agents 列出可用问题与智能体；本地 CLI 能正常 start 问题并 submit 解

常见问题

注意事项

• 克隆仓库必须加 --recurse-submodules，否则子模块不会拉取。
• Poetry 必须用官方安装脚本安装，apt 仓库中的版本过旧。
• 运行前确认 kubectl context 已指向目标 Kubernetes 集群，并已在 config.yml 中更新对应配置。
• 远程调用前需先启动 service.py 并确认 /health 可访问，使用 vLLM 时还需额外启动 vLLM 服务。