Agent Skills
返回列表
🔒

MinIO AIops 运维

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_993b98b1/minio-aiops。

技能介绍

要解决什么问题

MinIO 集群一满盘,备份和写入就开始失败;桶策略是否对公网可读、生命周期是否形同虚设、纠删集还能再坏几块盘——这些问题往往散落在控制台、API 和运维笔记里,Agent 若直接调写接口又缺少统一审计与回滚依据。本技能面向 MinIO 对象存储(社区维护,与 MinIO, Inc. 无隶属关系),把日常排障与受控变更收敛到同一套 MCP/CLI 能力上。

技能如何工作

共 48 个 MCP 工具(28 读、18 写、2 个 undo),每个调用都经过内置 @governed_tool 治理:本地统一审计(默认 ~/.minio-aiops/)、token/失控预算防护、undo token 记录,以及每条审计行上的 risk tier 描述。Access Key 的 Secret 以 Fernet + scrypt 写入 secrets.enc,不在磁盘明文落盘。

读侧除 health_*、cluster_status、fleet_overview 等健康与概览外,有六类「人话结论 + 建议动作」的旗舰分析:

  • capacity_rca:容量根因(近满、离线盘/节点、热点等)
  • bucket_exposure_audit:暴露面排序(公读/公写、缺加密、未开版本、无生命周期等)
  • lifecycle_gap_analysis:可回收空间估算(无界非当前版本、遗留 multipart 等)
  • healing_health:纠删集在线盘 vs 写 quorum、 heal 积压
  • diagnose_retention_gaps / diagnose_iam_exposure:WORM 保留与 IAM 暴露

写操作(策略、生命周期、配额、空桶删除、IAM、Object Lock 等)支持 --dry-run;不可逆操作另有二次确认。变更前配置会被捕获,可通过 undo_list / undo_apply 回放(部分合规保留类写入 deliberately 无 undo)。

常见路径示例:空间告警 → capacity_rca + usage_by_bucket → lifecycle_gap_analysis → 治理化清理上传/设 lifecycle;疑似公网可读 → bucket_exposure_audit → bucket_info → set_bucket_policy 并审计确认;盘故障 → healing_health 看 failureToleranceRemaining,近写 quorum 边缘时先换盘再动数据。

适用边界

  • 只针对 MinIO;Ceph/RGW 用 ceph-aiops,TrueNAS 用 truenas-aiops,其它基础设施选对应 AIops-tools 技能。
  • 本工具不负责授权决策:能否写入取决于 Agent 判断或所连 Access Key 的 IAM;只读策略会在服务端拒绝写。保证的是 每次调用都有审计,而非内置只读开关或审批门。
  • 容量根因若是 DRIVES_OFFLINE 而非真实数据增长,应先恢复纠删集健康,不要在降级状态下 purge 数据。
  • Object Lock 未在创桶时开启则无法原地启用 WORM;需新桶迁移。COMPLIANCE 保留为真不可逆,set_object_retention 会拒绝缩短已生效保留。

使用场景

  • 备份或写入失败且集群报近满时,用容量根因分析区分真实数据增长与离线盘/节点,再按桶用量与生命周期缺口决定清理 multipart 或设 noncurrent 规则。
  • 接到某业务桶可能公网可读/可写的情报后,跑暴露面审计按风险排序,结合 bucket_info 改策略并在 undo 列表里确认可回滚。
  • 单块或多块盘离线后,用 healing_health 查看各纠删集在线盘数、写 quorum 与 failureToleranceRemaining,决定能否继续维护还是先换盘。
  • 合规审计追问保留数据是否受 Object Lock 保护时,用 diagnose_retention_gaps 查默认保留与生命周期矛盾,再治理化设置 default retention(区分 GOVERNANCE/COMPLIANCE)。

适合人员

  • 负责生产 MinIO 集群的 SRE/平台工程师,需要在近满或 heal 积压时快速给出根因与可执行动作而非零散 API 结果
  • 存储或基础设施安全工程师,要定期排查桶策略公网暴露、缺加密、未开版本等项并留下可审计的变更记录
  • 管理纠删集与硬件更换的运维,在 WRITE_QUORUM_AT_EDGE 场景下需明确还能容忍几次盘故障再动数据
  • 对接内外部审计的合规/数据治理同学,需验证 Object Lock、默认保留与生命周期是否自相矛盾并给出可验证修复路径