运枢:服务运维

远端入口与连接

在服务器或集群上准备受限入口,建立业务和资源组,登记连接。

准备远端入口

运枢不会在远端安装任何东西,也不接受浏览器或模型传来的命令。每个连接只能通过远端事先准备好的固定入口操作登记过的服务,所以要先在远端做好下面的准备。入口脚本 entry.py 和白名单示例的取得方式,请联系交付团队。

Linux 服务器

  • 放一个受限入口脚本 /opt/yunshu/entry.py,属主为 root,普通用户不可写。它管理已部署的 Docker 容器和 systemd 服务,不接受 shell、SQL、动态命令或任意路径。服务器上需要已安装 Python 3,以及 Docker 或 systemd。
  • 建立 root 拥有的服务白名单 /etc/yunshu/targets.json。每一项写明服务别名、资源标识、管理方式(Docker 或 systemd)、实际目标,以及是否允许重启和重载。运枢资源里的「服务别名」必须与白名单的名字逐项匹配,白名单没有的服务不能操作。白名单最多 50 个目标,文件必须由 root 拥有,且不能被组或其他用户写入。
  • 建立权限为 0700 的回执目录 /var/lib/yunshu/receipts。它们的所有上层目录同样不能由 SSH 使用者改写。
  • 建一个专用的 SSH 账户,并在它的 authorized_keys 里把公钥固定到入口:restrict,command="/usr/bin/python3 /opt/yunshu/entry.py" ssh-ed25519 <专用公钥>。不要给这个账户额外的 shell、任意 sudo,或改写脚本和白名单的权限。这个账户需要有读取 Docker 或 systemd 服务状态、并执行重启的权限。
  • 日志检索需要入口支持协议 2,配置重载需要协议 3。升级只需替换 entry.py,旧协议的请求继续可用。

Kubernetes 集群

  • 建一个专用的 ServiceAccount,只授予登记资源所需的最小权限,不要用集群管理员令牌。权限按能力拆分:
能力需要的 RBAC 权限
读取状态登记名称的 deployments 或 statefulsets 的 get
读取日志pods 的 list,pods/log 的 get;Deployment 另需 replicasets 的 list
重启登记名称的 deployments 或 statefulsets 的 patch
扩缩容登记名称的 deployments/scale 的 patch
回滚登记名称的 deployments 的 patch,加 replicasets 的 list
  • 不需要也不应授予 secrets、pods/exec、pods/attach、RBAC 修改、删除或集群管理权限。只读的部署身份去掉 patch 即可。
  • Pod 日志的授权范围是命名空间,不能在 Role 里细到某个 Deployment。请把受管工作负载放进专用的命名空间。运枢会沿 Deployment、ReplicaSet、Pod 的所有权链核对日志归属,这是应用层的过滤,不等于 Kubernetes 原生的 Deployment 级日志隔离。
  • 运枢直接用 HTTPS 访问 API Server,用你提供的 CA 和令牌,不读取 kubeconfig,也不运行 kubeconfig 里的 exec 插件。

业务与资源组

入口:「运维(运枢) › 接入管理 › 业务」和「运维(运枢) › 接入管理 › 资源组」。先建业务,再在业务下建资源组。服务器、集群和服务都可以归属到业务和资源组,资源默认继承所在连接的归属,也可以单独指定。

字段含义
业务标识、资源组标识字母或数字开头,可含 _ 和 -,最多 64 个字符。保存后不能改。
业务名称、资源组名称必填。
所属业务只在建资源组时出现,必填。
负责人 / 团队、说明选填,说明最多 500 个字符。

已经被资源组、连接或资源使用的业务和资源组不能删除,列表会写明被谁使用。资源组还有三个用处:变更治理里的冻结窗口、维护窗口和规模上限可以按资源组设置;运行手册的一步可以直接指向一个资源组;监控和巡检的目标范围可以按业务、资源组筛选。分组不会扩大任何已有授权。

资源的归属变化会撤销这个资源原来的 Key 授权,并使相关旧计划失效。新资源不会自动继承已有授权,按资源组批量授权时,保存的也只是当时明确选中的资源。

连接

入口:「运维(运枢) › 接入管理 › 连接管理」,点右上角「新增连接」。一个连接对应一台服务器或一个集群。

运枢连接管理列表
「运维(运枢) › 接入管理 › 连接管理」列表,每行有「只读测试」「编辑」和「更多」。截图来自测试环境,数据为示例。

要填什么

字段说明
连接标识字母或数字开头,可含 _ 和 -,最多 64 个字符。保存后不能改。
连接名称必填,最多 128 个字符。
平台Linux、Windows Server 或 Kubernetes。保存后不能改。Docker 容器经 Linux 连接的受限入口管理,选 Linux。Windows Server 的情况见「目前的边界」。
主机地址Linux 填主机名或 IPv4,不含协议和路径。Kubernetes 的字段名是「API Server 主机(HTTPS)」。
凭据来源下拉里有三项:「在面板中填写(加密保存在模块库)」「服务端凭据档案(文件引用)」「保持服务端文件(由 config.json 导入)」。选第一项时,在下面直接填凭据。
SSH 私钥Linux 用。专用账户的私钥,不带口令,因为运枢无人值守连接。
主机公钥(known_hosts)Linux 用。经可信渠道核对的主机公钥行。运枢强制校验主机身份,不会自动接受未知主机。
CA 证书Kubernetes 用。签发 API Server 证书的 CA,PEM 格式,用来校验集群身份。
访问令牌(Token)Kubernetes 用。专用服务账户的令牌,不含 Bearer 前缀。
高级设置:端口、专用 SSH 用户端口默认 SSH 22、Kubernetes 6443。Linux 的专用 SSH 用户默认是 ops,请改成远端准备好的专用账户。Kubernetes 没有用户字段。
高级设置:所属业务、资源组选填,下面登记的资源默认继承。
运枢新增连接弹窗
「新增连接」弹窗,这里是上半部分,高级设置在下方。截图来自测试环境,数据为示例。

凭据只写不读

凭据由运枢按部署的算法套件加密保存,保存后界面只显示每一项「已设置」或「未设置」,不会把值再返回浏览器,日志和错误信息里也不会出现。编辑已有连接时,留空的项保持原值,填写的项替换原值。凭据不能清空。

改动连接的任何设置(包括名称和更换凭据)都会生成新版本,此前冻结的计划随之失效,需要重新生成。没有任何改动的重复保存不受影响。

如果从备份恢复后某个连接的资源提示「连接凭据无法解密」,说明保存凭据用的密钥文件没有随数据卷一起恢复。在面板里重新填写这个连接的全部凭据即可,其他连接不受影响。

只读测试

连接下登记了资源后,连接列表里才会出现可用的「只读测试」。测试依次检查网络可达性、服务端身份与认证、远端驱动,再逐个检查登记的资源和授权。结果是「通过」「部分通过」或「未通过」,对话框里列出每一阶段和每个资源的结果。

  • 测试是只读的:只做读取,不会重启或修改任何服务。连接测试通过不等于变更已经验收,变更要用一次真实的计划来验证。
  • Linux 连接的「远端驱动」阶段会报告入口的协议版本,可以据此判断日志检索和重载能不能用。
  • Kubernetes 连接会对每个资源逐项检查当前令牌的权限,并按能力列出缺少的 RBAC 权限。
  • 更换凭据或地址后,建议再测一次。

停用、编辑与移除

每行有「只读测试」和「编辑」,「更多」菜单里有「查看关联资源」「停用连接」和「移除连接」,没有资源的连接还有「登记资源」。停用后,这个连接下所有资源的状态读取、日志、巡检、测试和变更计划都会被拒绝,已冻结的计划失效。资源、授权和历史保留,可以随时重新启用。有进行中或结果不明的任务时不能停用。连接或资源只要还有进行中或结果不明的任务(资源被锁),保存任何编辑都会被拒绝,提示先核验或人工释放。有关联资源的连接不能移除,没有资源的连接可以移除,同时删除它的加密凭据。

进一步交流

带一件正在做的事来聊

告诉我们你想让智能体接哪一类系统。我们在演示环境里把这件事走一遍,再一起判断合不合适。