Files
synapbus/specs/006-admin-cli-docker-fixes/quickstart.md
T
Algis DumbrisandClaude Opus 4.6 9dd27c4b9b feat: admin CLI & Docker fixes — alpine base, channels create/join, absolute socket path
Switch Docker runtime from scratch to alpine:3.19 so kubectl exec works
for admin CLI operations. Add `synapbus channels create` and
`synapbus channels join` CLI commands with corresponding admin socket
handlers. Change default socket path to /data/synapbus.sock (absolute).
Also add Helm envFrom support and NodePort configuration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 14:54:13 +02:00

1.4 KiB

Quickstart: Admin CLI & Docker Fixes

Feature: 006-admin-cli-docker-fixes

Build & Deploy

# Build Docker image (now uses alpine base)
docker build -t synapbus:dev .

# Run locally
./synapbus serve --port 8080 --data ./data

New CLI Commands

Create a channel

# With description
synapbus channels create --name news-feed --description "News feed channel"

# Without description
synapbus channels create --name alerts

Join an agent to a channel

synapbus channels join --channel news-feed --agent research-mcpproxy

In Kubernetes

# Now works because alpine base image provides /bin/sh
kubectl exec -n synapbus deploy/synapbus -- /synapbus channels create --name news-feed
kubectl exec -n synapbus deploy/synapbus -- /synapbus channels join --channel news-feed --agent my-agent
kubectl exec -n synapbus deploy/synapbus -- /synapbus channels list

Socket Path

The default socket path is now /data/synapbus.sock (absolute). Override with:

# Environment variable
export SYNAPBUS_SOCKET=/custom/path/synapbus.sock

# CLI flag
synapbus --socket /custom/path/synapbus.sock channels list

Verification

# Verify Docker image base
docker run --rm synapbus:dev sh -c "cat /etc/os-release"
# Should show Alpine Linux

# Verify socket path default
synapbus --help | grep socket
# Should show: --socket string   Path to admin Unix socket (default "/data/synapbus.sock")