ai-workspace-infra/observability.svc.plus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
observability.svc.plus/roles/vibe/README.md
Haitao Pan e7e53c5c7e Remove sensitive files
2026-02-01 20:53:55 +08:00

5.3 KiB
Raw Permalink Blame History

Role: vibe

Deploy Development Tools (Code Server, JupyterLab, Claude Code)

Module VIBE
Docs https://pigsty.io/docs/vibe/
Related Roles node, juice

Overview

The vibe role deploys an integrated development environment:

  • Code Server: VS Code in browser
  • JupyterLab: Interactive computing notebooks
  • Claude Code: AI coding assistant with observability
  • Node.js: JavaScript runtime with npm

Quick Start

Use conf/vibe.yml for a complete AI coding sandbox:

./configure -c vibe
./deploy.yml
./juice.yml     # JuiceFS on PostgreSQL, mount on /fs
./vibe.yml      # Code Server, JupyterLab, Claude Code

Playbooks

Playbook Description
vibe.yml Deploy development tools

Tags

vibe
├── vibe_dir          # Create workspace, render CLAUDE.md
├── code              # VS Code Server
│   ├── code_install
│   ├── code_dir
│   ├── code_config
│   └── code_launch
├── jupyter           # JupyterLab
│   ├── jupyter_install
│   ├── jupyter_dir
│   ├── jupyter_config
│   └── jupyter_launch
├── claude            # Claude Code CLI
│   ├── claude_install
│   └── claude_config
└── nodejs            # Node.js Runtime
    ├── nodejs_install
    ├── nodejs_config
    └── nodejs_pkg

Variables

Workspace

Variable Default Description
vibe_data /fs Shared workspace directory

Code Server

Variable Default Description
code_enabled true Enable code-server
code_port 8443 Listen port
code_data /data/code Data directory
code_password Vibe.Coding Access password
code_gallery openvsx Extension gallery: openvsx/microsoft

JupyterLab

Variable Default Description
jupyter_enabled true Enable JupyterLab
jupyter_port 8888 Listen port
jupyter_data /data/jupyter Data directory
jupyter_password Vibe.Coding Access token
jupyter_venv /data/venv Python venv path

Claude Code

Variable Default Description
claude_enabled true Enable Claude Code
claude_env {} Extra env vars merged with defaults

Claude Code is pre-configured with OpenTelemetry, sending metrics and logs to VictoriaMetrics/VictoriaLogs for observability.

Node.js

Variable Default Description
nodejs_enabled true Enable Node.js installation
nodejs_registry '' npm registry URL, auto china mirror if empty
npm_packages [] List of global npm packages to install

When nodejs_registry is empty and region=china, npm is automatically configured to use https://registry.npmmirror.com.

Use npm_packages to install global npm packages like @anthropic-ai/claude-code:

npm_packages:
  - '@anthropic-ai/claude-code'
  - typescript
  - pnpm

Usage

./vibe.yml -l <host>              # Full deployment
./vibe.yml -l <host> -t code      # Code Server only
./vibe.yml -l <host> -t jupyter   # JupyterLab only
./vibe.yml -l <host> -t claude    # Claude Code only
./vibe.yml -l <host> -t nodejs    # Node.js only

Disable components:

./vibe.yml -l <host> -e code_enabled=false
./vibe.yml -l <host> -e jupyter_enabled=false
./vibe.yml -l <host> -e claude_enabled=false
./vibe.yml -l <host> -e nodejs_enabled=false

Access

Service Via Nginx Direct
Code Server https://<host>/code/ http://<host>:8443/
JupyterLab https://<host>/jupyter/ http://<host>:8888/

Using Alternative Models

To use other models with Claude Code, configure claude_env, take GLM as example:

claude_env:
  ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/anthropic
  ANTHROPIC_API_URL: https://open.bigmodel.cn/api/anthropic
  ANTHROPIC_AUTH_TOKEN: <your_api_key>
  ANTHROPIC_MODEL: glm-4.7
  ANTHROPIC_SMALL_FAST_MODEL: glm-4.5-air

See Also