opsctl batch

并行执行多条命令，仅需一次审批。支持在单个批次中混合使用 exec（SSH）、sql 和 redis 命令类型。

语法

# 位置参数模式
opsctl [全局参数] batch '<asset>:<command>' ...
opsctl [全局参数] batch '<type>:<asset>:<command>' ...

# Stdin JSON 模式
echo '{"commands":[...]}' | opsctl [全局参数] batch

输入模式

位置参数

格式：asset:command（默认类型 exec）或 type:asset:command。

第一个 : 前的内容会被检查——如果是已知类型（exec、sql、redis），则作为类型前缀；否则整体作为资产标识，类型默认为 exec。

# 默认 exec
opsctl batch 'web-01:uptime' 'db-server:df -h'

# 混合类型
opsctl batch 'web-01:uptime' 'sql:prod-db:SELECT 1' 'redis:cache:PING'

# 分组/名称方式引用资产
opsctl batch 'exec:production/web-01:uptime'

Stdin JSON

主要面向 AI 和脚本的输入模式。每条命令指定 asset、type（可选，默认 exec）和 command。

echo '{"commands":[
  {"asset": "web-01", "type": "exec", "command": "uptime"},
  {"asset": "prod-db", "type": "sql", "command": "SELECT COUNT(*) FROM users"},
  {"asset": "cache", "type": "redis", "command": "INFO keyspace"}
]}' | opsctl batch

输出

结构化 JSON，包含每条命令的执行结果：

{
  "results": [
    {
      "asset_id": 1,
      "asset_name": "web-01",
      "type": "exec",
      "command": "uptime",
      "exit_code": 0,
      "stdout": " 14:32:01 up 30 days...\n",
      "stderr": ""
    },
    {
      "asset_id": 2,
      "asset_name": "prod-db",
      "type": "sql",
      "command": "SELECT COUNT(*) FROM users",
      "exit_code": 0,
      "stdout": "{\"columns\":[\"COUNT(*)\"],\"rows\":[[42]]}",
      "error": ""
    }
  ]
}

退出码：

• 0 — 批量机制本身成功（即使个别命令失败；需检查每条结果的 exit_code 和 error）
• 1 — 所有命令均失败，或批量级别错误（解析失败、全部被拒）

审批

batch 命令使用专门的审批流程：

1. 策略预检 — 每条命令独立检查资产策略（白名单/黑名单）。自动放行的命令跳过审批；自动拒绝的命令在输出中报告错误。
2. 单次批量审批 — 所有需要确认的命令在桌面应用中以单个审批弹窗呈现，列出每条命令及其类型标签。
3. 并行执行 — 审批通过后，所有命令并发执行（最多 10 条并行）。

桌面应用离线时，仅执行匹配策略或授权模式的命令；其余命令将被拒绝并提示允许的命令。

示例

# 检查多台服务器的运行时间
opsctl batch '1:uptime' '2:uptime' '3:uptime'

# 从不同类型的资产收集信息
opsctl batch \
  'web-01:free -h' \
  'sql:prod-db:SELECT version()' \
  'redis:cache:INFO server'

# 使用显式会话
opsctl --session $ID batch '1:uptime' '2:hostname'

# 使用 JSON 输入执行复杂查询
cat <<'EOF' | opsctl batch
{"commands":[
  {"asset":"web-01","command":"kubectl get pods -A --no-headers | wc -l"},
  {"asset":"web-01","command":"kubectl get namespaces --no-headers"},
  {"asset":"db-01","type":"sql","command":"SELECT table_name FROM information_schema.tables LIMIT 10"}
]}
EOF