xops play
以下列出命令用法和可用选项。已安装版本支持的参数以 --help 为准。
text
从 YAML 文件加载并执行声明式编排任务 (Playbook)。
支持多步骤顺序执行和多主机并行执行,步骤类型包括:
shell — 在远程主机执行命令
script — 上传并执行本地脚本文件
copy — 上传本地文件到远程主机
ensure — 幂等性状态收敛:先检查,不满足时执行修复
template — 渲染 Go 模板后上传
用法示例:
xops play deploy.yaml
xops play deploy.yaml --var version=2.1.0 --var env=prod
xops play deploy.yaml --concurrency 5
xops play deploy.yaml --dry-run
xops play deploy.yaml --limit web-1,web-2
xops play deploy # 从 ~/.xops/playbooks/ 按名称查找
Usage:
xops play <playbook-file> [flags]
Flags:
-j, --concurrency uint 最大并发主机数(覆盖 Playbook settings.concurrency)
--dry-run 仅解析并预览 Playbook 步骤,不实际执行
-h, --help help for play
--limit string 限制执行的目标节点(逗号分隔的节点名,覆盖 Playbook targets)
--sudo 强制全局提权执行(覆盖 Playbook settings.sudo)
--var stringArray 覆盖或追加变量,格式: key=value(可多次指定)
Global Flags:
--color string ANSI 颜色输出 (auto=自动检测管道/重定向, never=禁用, always=强制启用)
--debug 开启调试模式 (等同于 --log-level=debug)
--lang string 界面语言 (zh/en)
--log-level string 设置内部诊断日志级别 (debug, info, warn, error)