Chancel's blog

1871 字 7 分钟阅读

Agentic Coding 之运维指南

  • Agentic Coding

可直接复制作为运维仓库的 AGENTS.md 模板使用。

运维 Agent 仓库

本文件为运维 Agent 仓库的设定指南,提供初始化、管理和运维的参考流程,帮助用户在遵循安全和权限要求的前提下高效管理运维任务。

仓库参考设计如下:

example/                                                                                                                                        
├── README.md          # 唯一总导航
├── AGENTS.md          # 操作与授权规则
├── HOST.yaml          # 主机登记和等级信息
├── secrets/           # 存放敏感信息和凭证,600 权限,补充 env 文件
├── history/           # 历史操作记录和归档,每一次操作都完整记录入内
│   ├── ops-20260101-001/
│   ├── ops-20260101-002/
│   └── ...
├── docs/              # 公共文档、协作资料、经验和历史资料                                                                                        

目录说明:

  • README.md:仓库总导航,提供整体说明和使用指南。
  • AGENTS.md:定义和管理各类 Agent 的权限、操作规范和使用说明。
  • HOST.yaml:记录主机的登记信息和等级。
  • history/:存放历史操作记录和归档,每一次操作都完整记录,记录内容要包括执行过程到哪一步以及相关结果。
  • docs/:存放公共文档、协作资料、经验和历史资料。

仓库 AGENTS.md

在仓库的根目录下,应存在 AGENTS.md 文件,用于定义和管理仓库中各类 Agent 的权限、操作规范和使用说明。该文件是运维 Agent 执行操作的重要依据,确保所有操作符合安全和权限要求。

原则底线

借助本仓库,做好一个高级工程师应尽的职责,负责本机与远程调查、配置、自动化开发和发布。共同原则遵循 AGENTS.md,本文件规定运维操作流程。

运维实施应遵循最小权限原则。对于可能产生重大风险的操作,需提前说明后果并取得用户确认。

实施方案要确保安全、可控、可回滚,并在执行前获得用户批准,对于对系统造成严重破坏的操作,必须向用户进行 question 双次确认。

在权限上,要求:

  • 私密文件绝对禁止:不允许读取 *.pem、*.key、任意层级 id_rsa/id_ed25519 及 secrets/**
  • 不允许破坏性操作:执行关机、重启、停机断电等破坏性指令,也不允许指定 mkfs、dd 等磁盘初始化、格式化的破坏性操作
  • 危险命令模式禁止:递归执行、fork 炸弹、递归强删根目录或根下内容、切到根目录后删除、递归 chmod 000、递归 chown 根目录等危险操作

授权与主机等级

Local 指当前机器或仓库,按用户请求和项目约定操作,不使用主机等级。

Remote 指远程服务器目标,通常采用 ssh 进行连接,是较为常见的情况,分为 Low 和 High 两个等级,具体区别如下

等级 说明 只读侦查 写入变更 删除操作
Low 允许在任务范围内自主操作的普通运维环境 允许 允许 允许,但需用户授权,详见下方
High 用户或项目指定的重要环境,变更前需要确认。 允许 允许,但需用户授权 允许,但需用户批准,详见下方

等级登记在仓库下 HOSTS.yaml 文件中,记录每台主机的等级和相关信息,新建文件后可搜索仓库引入历史主机记录。

目标明确的只读连接、调查和验证均无需额外确认。DNS、数据库、重启等操作不会自动改变主机等级,但调查中需要修改系统时仍按写入处理。

对于 High 主机来说,任何写入变更都必须经过用户确认,且在执行前明确方案、影响和恢复办法,未经确认不得擅自操作,且即便用户允许,也不应执行破坏性质操作,仅可提供操作建议/指令和风险警告。

需要确认的情况

对于 High 目标而言,任何有歧义、执行中需扩大授权,或发现系统破坏、重要数据不可逆损失、管理连接失效等重大风险时,先说明具体后果,再取得用户确认方可考虑执行。

删除操作界定为两种:

  • D0:批准后可删除的内容。
  • D1:即使授权也不得删除的内容,即使用户明确批准也不予执行或展示删除方法,比如系统目录/分区/内核/引导、数据库 drop、批量关键数据、跨租户删除、绕过审计等。

对于 Low 主机 / Local 而言,删除在获得用户批准后即可执行,对于 High 主机而言,在获得用户许可后,需明确删除范围、影响和有无恢复方案,并在执行前再次取得用户确认后给出删除指令,不代为执行删除操作。

连接与主机管理

先确认机器、账户和执行位置,区分客户端、宿主与容器。优先沿用项目主机清单和 SSH 配置,名称冲突或无法唯一定位时询问,不试连猜测。

批量操作先明确目标集合。主机和跳板都要核实身份与信任,不通过关闭校验或删除冲突记录接受未知、变化的密钥。

操作 要求
添加主机 提供公钥、服务器指纹及来源、主机等级。说明登记位置,按授权完成接入,验证成功后登记。
删除登记 仅删除指定条目,不顺带撤销远端权限或清理共享 SSH 配置。
检查配置 说明检查的是本地配置还是实际连接,不把前者当作后者的证明。
测试连接 验证实际认证和远端身份。指定公钥时须证明使用该公钥,不能用旧连接复用代替。

使用环境已有的认证方式,不因失败擅自更换目标、身份或降低校验。网络采集的指纹不能自行证明服务器可信。

登记只保存必要信息,不进入公开配置归档。写前检查冲突,部分失败时说明哪些已完成,不把连接成功说成登记成功。

数据与凭证

删除前核对具体对象、递归范围及影响,不能把含糊的“清理”当作任意删除许可。

需要用户提供凭证时,将创建 600 文件,要求用户在终端自行填入,提前准备好凭证内容文件,等待用户填入,而非让用户创建。

运维和实施

在处理问题的过程中遵循:

  1. 调查-讨论循环直到明确问题和用户需求,调查充足,提高对话效率,减少对话轮次。
  2. 形成方案,并向用户说明方案内容,寻求用户批准。
  3. 严格按照已批准的方案执行操作,确保安全、可控、可回滚,并在执行过程中持续与用户保持沟通。
  4. 方案实施后进行简短总结汇报。

本仓库不记录任何源码,运维不建立任何源码仓库,如有脚本存储、源码建设需求,可在对应现场建立,并保留 README.md 说明用途和内容。

绝不在本仓库内新建任何源码仓库,避免与远程现场出现分叉情况。

历史归档

所有操作记录应完整归档至 history/ 目录下,按任务归属登记入内,一个任务对应一个ops-xxx编号。

历史归档内容作为参考资料,但参考时一定要连接到对应现场做只读侦查,不以历史为唯一事实依据。