预置剧本
VIBE 模块的 Ansible 剧本使用说明。
VIBE 模块提供 vibe.yml 剧本，用于部署 Code-Server、JupyterLab、Node.js、Claude Code 与 Codex CLI。
vibe.yml 只包含 node_id 与 vibe 角色，不包含 node/infra。
建议先执行 deploy.yml 或显式运行 node.yml 与 infra.yml。
vibe.yml
vibe.yml 内容：
YAML
- name: VIBE
hosts: all
become: true
gather_facts: no
roles:
- { role: node_id, tags: id }
- { role: vibe, tags: vibe }
任务结构
BASH
vibe
├── vibe_dir # 创建工作目录与上下文文件
├── code # Code-Server
│ ├── code_install
│ ├── code_dir
│ ├── code_config
│ └── code_launch
├── jupyter # JupyterLab
│ ├── jupyter_install
│ ├── jupyter_dir
│ ├── jupyter_config
│ └── jupyter_launch
├── nodejs # Node.js Runtime 与额外 npm 包
│ ├── nodejs_install
│ ├── nodejs_config
│ └── nodejs_pkg
├── codex # Codex CLI
│ └── codex_install
└── claude # Claude Code
├── claude_install
└── claude_config
说明：
jupyter_install 使用 uv pip，不会创建 venvnodejs_pkg 只安装 npm_packages 中声明的额外包，默认列表为空claude_install 使用 claude_package 安装 Claude CLI，claude_config 写入 ~/.claude 配置codex_install 安装 @openai/codex，不托管 Codex 配置
常用命令
完整部署：
组件级部署：
BASH
./vibe.yml -l <host> -t code
./vibe.yml -l <host> -t jupyter
./vibe.yml -l <host> -t nodejs
./vibe.yml -l <host> -t claude
./vibe.yml -l <host> -t codex
配置更新：
BASH
./vibe.yml -l <host> -t code_config,code_launch
./vibe.yml -l <host> -t jupyter_config
ssh <host> sudo systemctl restart jupyter
./vibe.yml -l <host> -t claude_config
在本次执行中跳过组件：
BASH
./vibe.yml -l <host> -e code_enabled=false
./vibe.yml -l <host> -e jupyter_enabled=false
./vibe.yml -l <host> -e nodejs_enabled=false
./vibe.yml -l <host> -e claude_enabled=false
./vibe.yml -l <host> -e codex_enabled=false
这些开关是任务执行条件：设为 false 只会跳过对应安装与配置任务，不会停止、禁用或卸载此前已经部署的服务/软件。若要退役 Code-Server 或 JupyterLab，需要另行执行 systemctl disable --now code-server 或 systemctl disable --now jupyter；VIBE 当前没有独立的移除剧本。
Node.js 是 Claude Code 与 Codex CLI 的运行时依赖：只设置 nodejs_enabled=false，但 claude_enabled 或 codex_enabled 仍为 true 时，nodejs 阶段依然会执行。只有三个开关都为 false 时才会跳过 Node.js 阶段。
部署顺序
BASH
./deploy.yml # 清单中已定义的 NODE、INFRA、ETCD、MINIO 与 PGSQL
./juice.yml # 可选共享存储
./vibe.yml # VIBE
幂等性
vibe.yml 支持重复执行，配置变更后可直接重跑。