Skip to content

docs(self-hosting): present GKE and EKS as equal install paths - #269

Merged
kjgbot merged 3 commits into
mainfrom
docs/selfhost-eks-first-class
Nov 5, 2026
Merged

docs(self-hosting): present GKE and EKS as equal install paths#269
kjgbot merged 3 commits into
mainfrom
docs/selfhost-eks-first-class

Conversation

@kjgbot

@kjgbot kjgbot commented Nov 5, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

The gated /docs/self-hosting overview only offered a GKE install and a GKE-only guided-install prompt. The page now presents two equal install paths.

  • The description reads "on Google Cloud (GKE) or AWS (EKS)". The cards are Install on Google Cloud (GKE) and Install on AWS (EKS), plus the setup agent and the Helm chart.
  • The setup-agent section links both guided installs and has one copy-able prompt per cloud: selfhost:guided-gke-install and selfhost:guided-eks-install. GUIDED_INSTALL_DOC is replaced by GUIDED_INSTALL_DOCS.
  • The architecture diagram is still drawn for GKE. Its caption now says so and lists the AWS equivalents: ALB + ACM, Pod Identity, S3, RDS/Aurora or CloudNativePG. "Previews" in the diagram text becomes "optional".
  • Sidebar order: both installs first, then both guided installs.
  • No runbook text is added to this repo. A follow-up commit on this PR will regenerate security/selfhost-runbook-fingerprints.json from the relay-agent merge sha.

Companion: AgentWorkforce/relay-agent#102. No Cloud change is needed: /cloud/api/v1/me/selfhost-docs accepts any [a-z0-9-] doc name, and the MCP passes requests through to relay-agent.

Test plan

Agent-Session: helm-chief coordinator, Claude Code session 091f15c3-697e-4629-aa61-2c8f83eb94d9

🤖 Generated with Claude Code

kjgbot @claude
docs(self-hosting): present GKE and EKS as equal install paths
7fbebfe 
The overview names both clouds, links both reference installs and both
guided installs, and offers one setup-agent prompt per cloud
(selfhost:guided-gke-install, selfhost:guided-eks-install). The diagram
caption says it is drawn for GKE and gives the EKS equivalents.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@composalagent

composalagent Bot commented Nov 5, 2026 •
edited
Loading

Copy link
Copy Markdown

Composal Verify · PR #269

Failed Failed · 0 of 1 scenario passed · 1 finding · commit de20db2f203a

Warning

This request is merged; previous verification results remain in the history.

Preview: https://4e4f44f4-agentrelay-web.agent-workforce.workers.dev/

Diff assessment: The self-hosting page and supporting docs code are modified to present GKE and EKS install cards, cloud-specific guided-install links and copyable prompts, and updated diagram captions and sidebar ordering. These are browser-visible documentation and interaction changes.

Open run results Fix with agent

Findings

  1. P2 Not met: Each sidebar click opened an article whose heading matches the link, with no not-found page · View browser · Fix with agent
    • Unverified: Public address opens an article explaining public addresses under the broader heading “Forward deployed agents,” not an unrelated or missing page. Self-hosting is marked with a lock and redirects to sign-in, consistent with access gating rather than a broken docs link.
    • Expected “Each sidebar click opened an article whose heading matches the link, with no not-found page.”
    • What happened: Verify found that Public address opened with a different heading, and Self-hosting showed sign-in instead of the article. Both issues were in the app.

Scenarios

Result Scenario Persona Outcomes Duration
Failed Failed A reader can reach every current docs page from the sidebar Signed-out visitor 3/4 3m 40s
Why this scenario was selected
  • A reader can reach every current docs page from the sidebar: Path trigger: ./web/app/docs
Recent verification history
Commit Result Started
de20db2f203a Failed Failed 2026-11-05 08:44 UTC
5e5a1fe1cc91 Failed Failed 2026-11-05 08:26 UTC
7fbebfeb5aa8 Failed Failed 2026-11-05 08:18 UTC

@coderabbitai

coderabbitai Bot commented Nov 5, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Important

  • Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 67a0a402-880e-49ea-9b17-a93268192d76
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

cubic-dev-ai[bot]
cubic-dev-ai Bot reviewed Nov 5, 2026
View reviewed changes

@cubic-dev-ai cubic-dev-ai Bot left a comment •
edited
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

All reported issues were addressed across 3 files

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

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread web/lib/selfhost-docs.ts Resolved
@github-actions

github-actions Bot commented Nov 5, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Preview deployed!

Environment URL
Web https://4e4f44f4-agentrelay-web.agent-workforce.workers.dev

This is a Cloudflare Workers preview version of this PR's build.

@kjgbot
kjgbot merged commit fad47a0 into main Nov 5, 2026
5 of 6 checks passed
@kjgbot
kjgbot deleted the docs/selfhost-eks-first-class branch November 5, 2026 08:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@cubic-dev-ai cubic-dev-ai[bot] cubic-dev-ai[bot] left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@kjgbot