Skip to content

Tier A connect console + ADR-0001 (Tier B bastion) - #43

Merged
joy-software merged 1 commit into
mainfrom
feature/connect-console
Jun 8, 2026
Merged

Tier A connect console + ADR-0001 (Tier B bastion)#43
joy-software merged 1 commit into
mainfrom
feature/connect-console

Conversation

@joy-software

Copy link
Copy Markdown
Contributor

Tier A — unified connect console (shipped)

spero top's s key now opens a session into any target with the operator's own tools, not just pods. New core.shell.connect_argv dispatches on the provider:

  • k8s:...kubectl exec -it <pod> -- sh
  • ssh:[user@]host[:port]ssh -t [-p port] <dest>
  • local$SHELL

It brokers nothing and holds no spero credentials — access stays bounded by your kubeconfig / ssh config, and it's local-only (never --remote/dial-home). So spero top becomes a k9s-style console over the mixed host+k8s fleet spero already inventories.

Tests: connect_argv for ssh (user+port / host-only), local, and k8s-delegates-to-exec. 269 passed, ruff/mypy clean.

ADR-0001 — Tier B brokered bastion (decision doc)

adr/0001-tier-b-brokered-bastion.md records the call on the bigger idea: authenticating users and relaying recorded sessions into unreachable clusters over the dial-home reverse tunnel. Status: Proposed / not-by-default — ship Tier A and integrate with an existing access plane (Teleport/Boundary/SSM) unless the reverse-tunnel-into-unreachable-clusters wedge is a deliberate bet, in which case the security gates (per-user OIDC, JIT authz, session recording, no standing creds, bounded agent blast radius) are blocking. (/docs/ is gitignored here, so the ADR lives in a tracked top-level adr/.)

…bastion

Tier A: `spero top`'s `s` key now opens a session into any target with the
operator's own tools, not just pods. core.shell.connect_argv dispatches on the
provider -- kubectl exec for a kubernetes pod, ssh -t for an ssh host, a local
shell for a local target -- so `top` is a unified console over the fleet spero
already inventories. It brokers nothing and uses no spero-held credentials; access
stays bounded by your kubeconfig / ssh config, and it stays local-only.

ADR-0001 records the decision on the larger idea: a Tier B brokered bastion that
authenticates users and relays recorded sessions into unreachable clusters over the
dial-home reverse tunnel. Status: Proposed / not-by-default -- ship Tier A and
integrate with an existing access plane (Teleport/Boundary/SSM) unless the
reverse-tunnel-into-unreachable-clusters wedge is a deliberate bet, in which case
the listed security gates are blocking.
@joy-software
joy-software merged commit 46f8804 into main Jun 8, 2026
8 checks passed
@joy-software
joy-software deleted the feature/connect-console branch June 8, 2026 22:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant