Skip to content

docs: update gateway deployment architecture#1108

Merged
drew merged 8 commits intomainfrom
remove-k3s
May 5, 2026
Merged

docs: update gateway deployment architecture#1108
drew merged 8 commits intomainfrom
remove-k3s

Conversation

@drew
Copy link
Copy Markdown
Collaborator

@drew drew commented May 1, 2026

Summary

Rewrite the OpenShell documentation and architecture references away from the embedded k3s cluster image model and toward a gateway plus compute-platform model.

Related Issue

None.

Changes

  • Reframed published docs around registered gateway endpoints backed by Docker, Podman, Kubernetes, or MicroVM compute platforms.
  • Kept the Helm chart as the Kubernetes deployment path while removing cluster image/bootstrap publishing language from docs.
  • Reworked architecture docs for gateway deployment, packaging, security, system diagrams, sandbox image delivery, and inference/gateway wording.
  • Updated agent and contributor docs, including troubleshooting skills, to diagnose gateway deployment/runtime issues instead of k3s cluster bootstrap.

Testing

  • mise run docs
  • helm lint deploy/helm/openshell
  • git diff --check
  • mise run pre-commit
  • Unit tests added/updated (docs only)
  • E2E tests added/updated (docs only)

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)
  • Architecture docs updated

@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented May 1, 2026

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

Copy link
Copy Markdown

@cgwalters cgwalters left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Only skimmed, just approving the direction! Will be a big improvement.

Comment thread .agents/skills/debug-openshell-cluster/SKILL.md Outdated
@drew drew marked this pull request as ready for review May 4, 2026 22:37
@drew drew requested a review from a team as a code owner May 4, 2026 22:37
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 4, 2026

TaylorMutch
TaylorMutch previously approved these changes May 4, 2026
@drew drew merged commit f56c09c into main May 5, 2026
25 checks passed
@drew drew deleted the remove-k3s branch May 5, 2026 05:52
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.

3 participants