https://pgsty.pro/zh/module/vibe/ Recent content in VIBE on Pigsty v5.0 Hugo zh-CN Mon, 01 Jan 0001 00:00:00 +0000 https://pgsty.pro/zh/docs/vibe/ Mon, 01 Jan 0001 00:00:00 +0000 https://pgsty.pro/zh/docs/vibe/ <p>VIBE 模块提供一套 <strong>浏览器化开发环境</strong>，包含 Code-Server、JupyterLab、Node.js、Claude Code 与 Codex CLI， 并可与 <a href="https://pgsty.pro/zh/docs/juice/"><code>JUICE</code></a> 共享存储和 <a href="https://pgsty.pro/zh/docs/pgsql/"><code>PGSQL</code></a> 数据库能力配合使用。</p> https://pgsty.pro/zh/docs/vibe/config/ Mon, 01 Jan 0001 00:00:00 +0000 https://pgsty.pro/zh/docs/vibe/config/ <p>VIBE 模块支持按需启用组件，并通过统一的工作目录和 Nginx 入口对外提供服务。</p> <hr> <h2 id="配置概览">配置概览 </h2> <div class="td-table-scroll td-table-scroll--full td-table-scroll--static"> <table class="full-width"> <thead> <tr> <th scope="col" style="text-align: left">组件</th> <th scope="col" style="text-align: left">启用参数</th> <th scope="col" style="text-align: center">默认状态</th> <th scope="col" style="text-align: left">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left">Code-Server</td> <td style="text-align: left"><code>code_enabled</code></td> <td style="text-align: center">启用</td> <td style="text-align: left">浏览器 VS Code</td> </tr> <tr> <td style="text-align: left">JupyterLab</td> <td style="text-align: left"><code>jupyter_enabled</code></td> <td style="text-align: center">禁用</td> <td style="text-align: left">Notebook/终端/编辑器</td> </tr> <tr> <td style="text-align: left">Node.js</td> <td style="text-align: left"><code>nodejs_enabled</code></td> <td style="text-align: center">启用</td> <td style="text-align: left">Node.js 运行时与 npm</td> </tr> <tr> <td style="text-align: left">Claude Code</td> <td style="text-align: left"><code>claude_enabled</code></td> <td style="text-align: center">启用</td> <td style="text-align: left">CLI 安装、配置与可观测性</td> </tr> <tr> <td style="text-align: left">Codex CLI</td> <td style="text-align: left"><code>codex_enabled</code></td> <td style="text-align: center">启用</td> <td style="text-align: left">仅安装 CLI，不托管配置</td> </tr> </tbody> </table> </div> <p>说明：模块默认 <code>jupyter_enabled: false</code>，但 <code>conf/vibe.yml</code> 预置模板会显式设置为 <code>true</code>。</p> https://pgsty.pro/zh/docs/vibe/param/ Mon, 01 Jan 0001 00:00:00 +0000 https://pgsty.pro/zh/docs/vibe/param/ <p>VIBE 模块共有 <strong>18</strong> 个参数，分为：</p> <ul> <li>通用参数</li> <li>Code-Server 参数</li> <li>JupyterLab 参数</li> <li>Node.js 参数</li> <li>Claude Code 参数</li> <li>Codex CLI 参数</li> </ul> <hr> <h2 id="参数概览">参数概览 </h2> <div class="td-table-scroll td-table-scroll--full td-table-scroll--static"> <table class="full-width"> <thead> <tr> <th scope="col" style="text-align: left">参数</th> <th scope="col" style="text-align: center">类型</th> <th scope="col" style="text-align: center">级别</th> <th scope="col" style="text-align: left">默认值</th> <th scope="col" style="text-align: left">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#vibe_data"><code>vibe_data</code></a></td> <td style="text-align: center"><code>path</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>/fs</code></td> <td style="text-align: left">工作目录</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#code_enabled"><code>code_enabled</code></a></td> <td style="text-align: center"><code>bool</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>true</code></td> <td style="text-align: left">启用 Code-Server</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#code_port"><code>code_port</code></a></td> <td style="text-align: center"><code>port</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>8443</code></td> <td style="text-align: left">Code-Server 端口</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#code_data"><code>code_data</code></a></td> <td style="text-align: center"><code>path</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>/data/code</code></td> <td style="text-align: left">Code-Server 数据目录</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#code_password"><code>code_password</code></a></td> <td style="text-align: center"><code>string</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>Vibe.Coding</code></td> <td style="text-align: left">Code-Server 密码</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#code_gallery"><code>code_gallery</code></a></td> <td style="text-align: center"><code>enum</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>openvsx</code></td> <td style="text-align: left">扩展市场</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#jupyter_enabled"><code>jupyter_enabled</code></a></td> <td style="text-align: center"><code>bool</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>false</code></td> <td style="text-align: left">启用 JupyterLab</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#jupyter_port"><code>jupyter_port</code></a></td> <td style="text-align: center"><code>port</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>8888</code></td> <td style="text-align: left">JupyterLab 端口</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#jupyter_data"><code>jupyter_data</code></a></td> <td style="text-align: center"><code>path</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>/data/jupyter</code></td> <td style="text-align: left">JupyterLab 数据目录</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#jupyter_password"><code>jupyter_password</code></a></td> <td style="text-align: center"><code>string</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>Vibe.Coding</code></td> <td style="text-align: left">JupyterLab Token</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#jupyter_venv"><code>jupyter_venv</code></a></td> <td style="text-align: center"><code>path</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>/data/venv</code></td> <td style="text-align: left">Python venv 路径</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#nodejs_enabled"><code>nodejs_enabled</code></a></td> <td style="text-align: center"><code>bool</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>true</code></td> <td style="text-align: left">启用 Node.js</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#nodejs_registry"><code>nodejs_registry</code></a></td> <td style="text-align: center"><code>url</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>''</code></td> <td style="text-align: left">npm 镜像地址</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#npm_packages"><code>npm_packages</code></a></td> <td style="text-align: center"><code>string[]</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>[]</code></td> <td style="text-align: left">额外全局 npm 包</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#claude_enabled"><code>claude_enabled</code></a></td> <td style="text-align: center"><code>bool</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>true</code></td> <td style="text-align: left">安装并配置 Claude Code</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#claude_package"><code>claude_package</code></a></td> <td style="text-align: center"><code>string</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>@anthropic-ai/claude-code</code></td> <td style="text-align: left">Claude Code npm 包</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#claude_env"><code>claude_env</code></a></td> <td style="text-align: center"><code>dict</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>{}</code></td> <td style="text-align: left">Claude 环境变量</td> </tr> <tr> <td style="text-align: left"><a href="https://pgsty.pro/zh/docs/vibe/param/#codex_enabled"><code>codex_enabled</code></a></td> <td style="text-align: center"><code>bool</code></td> <td style="text-align: center"><code>C</code></td> <td style="text-align: left"><code>true</code></td> <td style="text-align: left">安装 Codex CLI</td> </tr> </tbody> </table> </div> <hr> <h2 id="默认参数">默认参数 </h2> <p>定义于 <a href="https://github.com/pgsty/pigsty/blob/main/roles/vibe/defaults/main.yml"><code>roles/vibe/defaults/main.yml</code></a>：</p> https://pgsty.pro/zh/docs/vibe/playbook/ Mon, 01 Jan 0001 00:00:00 +0000 https://pgsty.pro/zh/docs/vibe/playbook/ <p>VIBE 模块提供 <code>vibe.yml</code> 剧本，用于部署 Code-Server、JupyterLab、Node.js、Claude Code 与 Codex CLI。</p> <blockquote> <p><code>vibe.yml</code> 只包含 <code>node_id</code> 与 <code>vibe</code> 角色，不包含 <code>node/infra</code>。 建议先执行 <a href="https://pgsty.pro/zh/docs/deploy/"><code>deploy.yml</code></a> 或显式运行 <a href="https://pgsty.pro/zh/docs/node/playbook/"><code>node.yml</code></a> 与 <a href="https://pgsty.pro/zh/docs/infra/playbook/"><code>infra.yml</code></a>。</p> https://pgsty.pro/zh/docs/vibe/admin/ Mon, 01 Jan 0001 00:00:00 +0000 https://pgsty.pro/zh/docs/vibe/admin/ <hr> <h2 id="服务管理">服务管理 </h2> <div class="td-code td-code--untitled" id="td-code-7d31e1d2-fence-0" data-td-code data-td-code-auto-id data-td-language="bash" data-td-line-count="4"> <div class="td-code__viewport" id="td-code-7d31e1d2-fence-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">systemctl status code-server </span></span><span class="line"><span class="cl">systemctl restart code-server </span></span><span class="line"><span class="cl">systemctl status jupyter </span></span><span class="line"><span class="cl">systemctl restart jupyter</span></span></code></pre></div></div> </div> <p>查看日志：</p> <div class="td-code td-code--untitled" id="td-code-7d31e1d2-fence-1" data-td-code data-td-code-auto-id data-td-language="bash" data-td-line-count="2"> <div class="td-code__viewport" id="td-code-7d31e1d2-fence-1-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">journalctl -u code-server -f </span></span><span class="line"><span class="cl">journalctl -u jupyter -f</span></span></code></pre></div></div> </div> <hr> <h2 id="工作目录与上下文">工作目录与上下文 </h2> <p><code>vibe_dir</code> 会在 <code>vibe_data</code> 下创建：</p> https://pgsty.pro/zh/docs/vibe/monitor/ Mon, 01 Jan 0001 00:00:00 +0000 https://pgsty.pro/zh/docs/vibe/monitor/ <p>VIBE 的监控主要集中在 Claude Code 的 OpenTelemetry 数据。 Code-Server 与 JupyterLab 本身不暴露 Prometheus 指标，可通过 systemd 与日志进行健康检查。</p> <hr> <h2 id="claude-code-可观测性">Claude Code 可观测性 </h2> <p>VIBE 在 <code>~/.claude/settings.json</code> 中写入默认 OpenTelemetry 环境变量：</p> https://pgsty.pro/zh/docs/vibe/faq/ Mon, 01 Jan 0001 00:00:00 +0000 https://pgsty.pro/zh/docs/vibe/faq/ <hr> <h2 id="部署问题">部署问题 </h2> <h3 id="code-server-软件包找不到">code-server 软件包找不到 </h3> <p>确认已部署 <a href="https://pgsty.pro/zh/docs/node/"><code>NODE</code></a> 与仓库配置：</p> <div class="td-code td-code--untitled" id="td-code-d659a770-fence-0" data-td-code data-td-code-auto-id data-td-language="bash" data-td-line-count="3"> <div class="td-code__viewport" id="td-code-d659a770-fence-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">yum repolist <span class="c1"># EL</span> </span></span><span class="line"><span class="cl">apt update <span class="c1"># Debian/Ubuntu</span> </span></span><span class="line"><span class="cl">./infra.yml -t repo</span></span></code></pre></div></div> </div> <h3 id="jupyterlab-安装失败">JupyterLab 安装失败 </h3> <p><code>jupyter_venv</code> 必须存在：</p>