Skip to content

docs(self-hosting): close GKE guide gaps from infra #495 - #325

Merged
khaliqgant merged 1 commit into
mainfrom
docs/gke-guide-gaps
Nov 19, 2026
Merged

khaliqgant merged 1 commit into
mainfrom
docs/gke-guide-gaps

Conversation

@AgentRelayBot

@AgentRelayBot AgentRelayBot commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Mirrors AgentWorkforce/infra#495 into the website's GKE guide. Merge after infra#495: the served first-admin.sh is a copy of infra's at the #495 head (1e4692a2), with the website's own comment line 2 kept.

What changed

#495 item Where it landed here
Desktop feed bucket only once the signing key exists install-gke.md step 4 (leave desktop_feed_bucket_name out during the install, the error it causes); feed section item 1 (don't rerun helm upgrade until item 3); new Troubleshooting section relay-control exits: signer and storage must be set together with the jq 'del(.["relay-control"].extraEnv)' recovery
Pinned SERVICES_IMAGE, PSQL_IMAGE, chart .tgz Step 7: they belong to agent-relay-2026.11.16 (chart 0.7.54); how to read them from another release's release/release-manifest.json, and infra/releases/<tag>/pins.json for the services image
Ingress 15 to 20 minutes, harmless Translation failed ... no BackendConfig warning Step 14, and Troubleshooting › Expected during the install
502 on closed paths (edge-deny backend) is intended Step 14 list, and Troubleshooting › Expected during the install
first-admin.sh API_HOST and PASSWORD_FILE Served script updated; step 15 documents both; agent note: never read the password file

Left out, on purpose

  • helm dependency build for installing from a checkout: the website guide installs only the released .tgz (step 11 and 13 use release/agent-relay-0.7.54.tgz); it never tells a reader to install the chart from the infra checkout. The checkout half of #495's pins note is left out for the same reason.
  • desktop_feed_has_signing_keys: exists only on infra main after #495, not in agent-relay-2026.11.16, which this guide pins. The Troubleshooting entry says the pinned Terraform has no such setting and gives the jq recovery instead. Add the variable when the guide moves to a release that has it.
  • #495's teardown line ("with PASSWORD_FILE, delete that file"): the website teardown page doesn't cover the first-admin secret today, so there is no matching line.

Checks

  • node scripts/selfhost-files.mjs write, then check: selfhost-files: up to date (exit 0)
  • npm test: 637 + 319 passed; npm run lint: exit 0; npm run typecheck: exit 0
  • shellcheck and bash -n on first-admin.sh: clean
  • infra's scripts/selfhost/tests/gcp-first-admin-test.sh (at the #495 head) run against this repo's copy: all passed
  • jq line from step 7 run against the agent-relay-2026.11.16 release manifest: prints the same digests the guide pins

🤖 Generated with Claude Code


Autofix with [code]smith
Open in [code]smith · Need help on this PR? Tag @codesmith-bot with what you need.


Summary by cubic

Syncs the GKE self-hosting guide and its first-admin.sh script with the fixes from infra#495, so the install docs no longer steer readers into failures.

  • Desktop feed bucket: the guide now says to leave desktop_feed_bucket_name unset during install; enabling storage without the signing key makes relay-control exit repeatedly. Adds a Troubleshooting entry with a jq recovery, and warns not to rerun helm upgrade until the key exists.
  • Version pins: documents that SERVICES_IMAGE, PSQL_IMAGE, and agent-relay-0.7.54.tgz belong to release agent-relay-2026.11.16 and how to read the correct ones for a different release.
  • Ingress behavior: notes the 15–20 minute address wait, that a one-off Translation failed ... no BackendConfig warning is harmless, and that 502 on closed paths is expected when no Cloud Armor policy is set.
  • first-admin.sh: adds optional API_HOST and PASSWORD_FILE; the password can now be kept in a local file instead of Secret Manager. SHA256SUMS and the downloads table updated.

Written for commit d19afe8. Summary will update on new commits.

View guided diff Turn on auto-fix

- Step 4: leave desktop_feed_bucket_name out during the install; the bucket
  without a signing key makes relay-control exit. Recovery in Troubleshooting.
- Step 7: the services, psql and chart pins belong to agent-relay-2026.11.16;
  how to read them for another release.
- Step 14: the Ingress takes 15 to 20 minutes; a one-off BackendConfig
  translation warning is harmless; 502 on closed paths is intended.
- Step 15: first-admin.sh gains optional API_HOST and PASSWORD_FILE (copied
  from infra at the #495 head, keeping the website's own line 2).
- Regenerate SHA256SUMS and the downloads table.

Co-Authored-By: Claude <noreply@anthropic.com>
@AgentRelayBot AgentRelayBot added the merge-train:hold Do not merge without Khaliq's direct OK label Nov 19, 2026
@composalagent

composalagent Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

Composal Verify · PR #325

Skipped Skipped · commit d19afe8e5cfd

Warning

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

No high-confidence scenario matches were found; no preview or browser run is needed

Diff assessment: Updates browser-rendered self-hosting documentation, including GKE installation guidance, troubleshooting sections, and download checksums. Also updates the publicly downloadable first-admin.sh script with API_HOST and PASSWORD_FILE options.

Why no scenarios were selected

No saved scenario matched this change.

Recent verification history
Commit Result Started
d19afe8e5cfd Skipped Skipped 2026-11-19 12:54 UTC

@coderabbitai

coderabbitai Bot commented Nov 19, 2026

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: e3924dd2-7c5c-4d36-81ee-aeb554427e70
  • 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

@github-actions

Copy link
Copy Markdown
Contributor

Preview deployed!

Environment URL
Web https://8359878c-agentrelay-web.agent-workforce.workers.dev

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

@khaliqgant
khaliqgant merged commit 2f807ec into main Nov 19, 2026
5 of 6 checks passed
@khaliqgant
khaliqgant deleted the docs/gke-guide-gaps branch November 19, 2026 13:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

merge-train:hold Do not merge without Khaliq's direct OK

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants