bascule-oss/charts/bascule/README.md
Tyler King 2fa92f8635 docs: comprehensive documentation + developer experience polish
New files:
  CONTRIBUTING.md — dev setup, code style, PR process
  CLAUDE.md — workspace context for Claude Code
  Makefile — build, test, lint, fmt, docker, helm-lint, dev, ci
  .editorconfig — consistent formatting
  rustfmt.toml — Rust formatting config
  docs/kubernetes.md — Helm install, values, architecture
  docs/bascule-shell.md — client shell install, config, TPM
  charts/bascule/README.md — Helm quick start

Updated:
  README.md — accurate feature matrix, clear shipped vs planned
  config/bascule.example.toml — full reference (72 lines, all fields)

All 15 README links verified valid.
Helm lint clean. Build passes. 0 substrate deps.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-05 10:53:08 -04:00

837 B

Bascule Helm Chart

Deploy Bascule SSH proxy on Kubernetes.

Install

helm install bascule charts/bascule/

Connect

ssh -p 2222 $(kubectl get svc bascule -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

Common Configurations

# NodePort
helm install bascule charts/bascule/ --set service.type=NodePort

# SSH keys from Secret
kubectl create secret generic bascule-keys --from-file=authorized_keys=$HOME/.ssh/authorized_keys
helm install bascule charts/bascule/ --set auth.authorizedKeysSecret=bascule-keys

# Custom shell image
helm install bascule charts/bascule/ --set shell.image.tag=net-ops

Architecture

Pod with two containers:

  • bascule — SSH proxy (port 2222)
  • shell — operator environment (exec'd into on connect)

See values.yaml for all options.