AIOpsLab

🤖 概述 | 🚀 快速开始 | 📦 安装 | ⚙️ 使用 | 📂 项目结构 | 📄 如何引用

🤖 概述

alt text

AIOpsLab 是一个全方位的框架，旨在支持自主 AIOps Agent 的设计、开发和评估。此外，它还致力于构建可复现、标准化、可互操作且可扩展的基准测试。AIOpsLab 可以部署微服务云环境、注入故障、生成工作负载并导出遥测数据，同时编排这些组件，并提供与 Agent 进行交互及评估的接口。

此外，AIOpsLab 还内置了一套基准测试套件，提供一系列问题以在交互式环境中评估 AIOps Agent。该套件可以根据用户特定需求轻松扩展。查看问题列表请点击这里。

📦 安装

系统要求

Python >= 3.11
Helm
Poetry (推荐) 或 pip
其他要求取决于所选的部署选项，详见下一节

第一步：安装 Python 3.11

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

第二步：安装 Poetry (官方安装程序)

# 使用官方安装程序 (不要用 apt - apt 版本已过时)
curl -sSL https://install.python-poetry.org | python3.11 -
export PATH="$HOME/.local/bin:$PATH"

# 将其添加到 shell 配置文件以持久化
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

警告: 请勿使用 sudo apt install python3-poetry - 它安装的版本过旧，可能无法与 lock 文件配合使用。

第三步：克隆并安装

git clone --recurse-submodules 
cd AIOpsLab
poetry env use python3.11
poetry install
eval $(poetry env activate)

故障排查: 如果遇到 "lock file not compatible"（lock 文件不兼容）错误，请先运行 poetry lock，然后再运行 poetry install。

使用 pip 进行替代安装：

pip install -e .

🚀 快速开始

选择 a) 或 b) 中的一种方式来设置你的集群，然后进行后续步骤。

a) 本地模拟集群

AIOpsLab 可以使用本地机器上的 kind 在本地模拟集群中运行。请查看此 README 获取先决条件列表。

# x86 架构机器
kind create cluster --config kind/kind-config-x86.yaml

# ARM 架构机器
kind create cluster --config kind/kind-config-arm.yaml

如果遇到问题，请考虑按照此 README 为你的机器构建 Docker 镜像，同时也欢迎提交 issue。

[提示]

如果你在使用代理运行 AIOpsLab，请注意将 HTTP 代理导出为 172.17.0.1。创建 kind 集群时，集群中的所有节点都会从宿主机环境和 Docker 容器继承代理设置。

172.17.0.1 地址用于与宿主机通信。更多详情，请参考官方指南：Configure Kind to Use a Proxy。

此外，Docker 不直接支持 SOCKS5 代理。如果你使用 SOCKS5 协议代理，可能需要使用 Privoxy 将 SOCKS5 转发到 HTTP。

如果你正在本地运行 VLLM 和 LLM Agent，Privoxy 默认会代理 localhost，这会导致错误。为避免此问题，应设置以下环境变量：

export no_proxy=localhost

完成集群创建后，进入下一步“更新 config.yml”。

b) 远程集群 (使用 Ansible 手动设置)

AIOpsLab 支持任何 kubectl 上下文指向的远程 Kubernetes 集群，无论是云提供商的集群还是你自己构建的集群。我们提供了一些 Ansible Playbook 来在 CloudLab 等提供商或我们自己的机器上设置集群。请遵循此 README 来设置你自己的集群，然后进入下一步“更新 config.yml”。

c) 使用 Terraform + Ansible 的 Azure VM (云端推荐)

一条命令即可完成虚拟机供应、K8s 设置和 AIOpsLab 配置：

# 模式 B (AIOpsLab 在本地运行，远程 kubectl):
python3 scripts/terraform/deploy.py --apply --resource-group  --workers 2 --mode B

# 模式 A (AIOpsLab 在控制器 VM 上运行，支持完整的故障注入):
python3 scripts/terraform/deploy.py --apply --resource-group  --workers 2 --mode A

详情请参考 Terraform README

microsoft/AIOpsLab