Skip to content

docs: rewrite the CoreWeave (CKS) guide as a full 0-100 deployment walkthrough#12

Merged
mscolnick merged 4 commits into
mainfrom
ms/cks-deploy-guide
Jul 21, 2026
Merged

docs: rewrite the CoreWeave (CKS) guide as a full 0-100 deployment walkthrough#12
mscolnick merged 4 commits into
mainfrom
ms/cks-deploy-guide

Conversation

@mscolnick

@mscolnick mscolnick commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Cluster + node pool creation, enabling the sandbox runner, sandbox profile
authoring/binding via cwic file import, the CoreWeave Traefik/cert-manager
ingress stack, CAIOS bucket setup, the Helm install, and wildcard kernel TLS

  • each step opinionated on one path with links to the official CoreWeave docs,
    plus optional add-ons (auto CAIOS creds, GPU profiles, custom domain).

Also fix docs-wide inaccuracies found along the way: the health endpoint is
/api/health (there is no /healthz route), and MARIMOHUB_COMPUTE_COREWEAVE_PROFILE
selects runner binding names, not ingress/egress modes.


Summary by cubic

Rewrote the CoreWeave (CKS) deployment guide into a complete 0→100 walkthrough, covering cluster and node pools, enabling the managed sandbox runner, profile authoring/binding via cwic, ingress stack, CAIOS storage, Helm install, and wildcard TLS for kernels. Also updated docs to use /api/health, aligned MARIMOHUB_COMPUTE_COREWEAVE_PROFILE, and added pre-commit checks to keep generated docs and wizard snapshots in sync.

  • New Features

    • Full CKS setup: create cluster and two node pools; enable the managed sandbox runner.
    • Sandbox profile: import via cwic with per-sandbox hostnames; bind under profile_name marimohub.
    • Ingress: install CoreWeave traefik and cert-manager with automatic DNS-01 for *.coreweave.app.
    • Storage: create a CAIOS bucket and access keys; wire S3 config.
    • Helm: deploy the hub with separate app and sandbox hosts, node pool pinning, and org label for sandbox reachability.
    • TLS: add a wildcard cert and Traefik TLSStore default for kernel hosts; plus validation, troubleshooting, and optional add-ons.
  • Bug Fixes

    • Updated all guides to use /api/health (there is no /healthz).
    • Corrected MARIMOHUB_COMPUTE_COREWEAVE_PROFILE usage and examples across the config registry, docs, and the deployment wizard snapshots (now marimohub), and added pre-commit checks to run docs-sync and wizard snapshot tests to catch drift locally.

Written for commit 6bdc31d. Summary will update on new commits.

Review in cubic

…lkthrough

Cluster + node pool creation, enabling the sandbox runner, sandbox profile
authoring/binding via cwic file import, the CoreWeave Traefik/cert-manager
ingress stack, CAIOS bucket setup, the Helm install, and wildcard kernel TLS
- each step opinionated on one path with links to the official CoreWeave docs,
plus optional add-ons (auto CAIOS creds, GPU profiles, custom domain).

Also fix docs-wide inaccuracies found along the way: the health endpoint is
/api/health (there is no /healthz route), and MARIMOHUB_COMPUTE_COREWEAVE_PROFILE
selects runner binding names, not ingress/egress modes.
@vercel

vercel Bot commented Jul 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
marimohub-docs Ready Ready Preview, Comment Jul 21, 2026 4:56pm

Request Review

…nfig registry

docs/configuration.md is generated from spec.ts; the hand-edited row broke the
docs-sync test.
…guard generated docs in pre-commit

vp staged now runs the config docs-sync test and the wizard snapshot tests
when their generated sources are staged, so drift fails locally instead of in CI.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Review completed against the latest diff

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread docs/configuration.md
@mscolnick
mscolnick merged commit 531f4ff into main Jul 21, 2026
7 checks passed
@mscolnick
mscolnick deleted the ms/cks-deploy-guide branch July 21, 2026 17:00
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