From ac64e727180ce3bf9ee5452cc0261b797d12d08e Mon Sep 17 00:00:00 2001 From: kjgbot Date: Tue, 17 Nov 2026 09:08:23 -0800 Subject: [PATCH] docs(self-hosting): AKS, GKE and EKS guides install agent-relay-2026.11.16 (chart 0.7.54) AKS from 2026.11.5 (chart 0.7.10), GKE from 2026.11.9 (5370050a, chart 0.7.21), EKS from 2026.11.5 (ef3f69ab, chart 0.7.10). Tag commit ece71b9d. EKS: the Images table, the ECR mirror loop, settings.sh and files/eks/values.yaml move to the 2026.11.16 digests from release-manifest.json (relay-control 0.5.34 377bc2b9, relay-webapp da0cc804, Relaycast 12.10.0 ec062ef9, sessions-pipeline fd2efd61). GKE: SERVICES_IMAGE fd2efd61. Overview: 2026.11.16 is the current release. SHA256SUMS and downloads.md regenerated with selfhost-files.mjs. Render-only: 2026.11.16 was not installed. Co-Authored-By: Claude Opus 5.5 --- web/content/self-hosting/downloads.md | 2 +- web/content/self-hosting/install-aks.md | 16 ++++----- web/content/self-hosting/install-eks.md | 33 ++++++++++--------- web/content/self-hosting/install-gke.md | 23 ++++++------- web/content/self-hosting/overview.md | 3 +- web/public/self-hosting/files/eks/SHA256SUMS | 2 +- web/public/self-hosting/files/eks/values.yaml | 8 ++--- 7 files changed, 45 insertions(+), 42 deletions(-) diff --git a/web/content/self-hosting/downloads.md b/web/content/self-hosting/downloads.md index 2070777c..35165655 100644 --- a/web/content/self-hosting/downloads.md +++ b/web/content/self-hosting/downloads.md @@ -29,7 +29,7 @@ Used by [this guide](/docs/self-hosting/install-eks). Checksums: [`SHA256SUMS`]( | [`opensearch-roles-via-cluster.sh`](https://agentrelay.com/self-hosting/files/eks/opensearch-roles-via-cluster.sh) | `b43755a02f2972ad9f8b405b8f2c3acd20cf1f6d999009f1cbe644f3f4fa90b8` | | [`rds-session-erase-search.sql`](https://agentrelay.com/self-hosting/files/eks/rds-session-erase-search.sql) | `148e8ca95cc74a398eb404b01d2e01c896252b516368f364d0886bccc1c19216` | | [`rds-setup.sh`](https://agentrelay.com/self-hosting/files/eks/rds-setup.sh) | `c29aea950c6112eb10d974cb28e79a3273ae2af7b2ba8484a07afed48a9e0a83` | -| [`values.yaml`](https://agentrelay.com/self-hosting/files/eks/values.yaml) | `0e4ab38da4b033e341123227473c950ce8e67dc323aa348a8ba1eb9229822662` | +| [`values.yaml`](https://agentrelay.com/self-hosting/files/eks/values.yaml) | `dfd14e34f46285c6551114459b874d3e03a6a313e6a061106da203929ba8b3b5` | ## Google Cloud (GKE) diff --git a/web/content/self-hosting/install-aks.md b/web/content/self-hosting/install-aks.md index 2aa88cc0..57b45b0d 100644 --- a/web/content/self-hosting/install-aks.md +++ b/web/content/self-hosting/install-aks.md @@ -8,7 +8,7 @@ Install Agent Relay on Azure Kubernetes Service. It follows forces. Run the steps in order and check each **Done when** line before you move on. -**Release:** `agent-relay-2026.11.5` (chart 0.7.10). **Community-contributed**: +**Release:** `agent-relay-2026.11.16` (chart 0.7.54). **Community-contributed**: proven once on AKS, see [Known limits](#known-limits). **Status: community-contributed, proven once.** One fresh install on @@ -19,8 +19,8 @@ operator device approval worked, two agents exchanged messages through Relaycast, and an uploaded session was indexed. See [Known limits](#known-limits) before a production rollout. -This guide installs release **agent-relay-2026.11.5** (chart agent-relay 0.7.10, -sessions-pipeline 0.8.33). `searchIndexer.locker.credentials` first shipped +This guide installs release **agent-relay-2026.11.16** (chart agent-relay 0.7.54, +sessions-pipeline 0.8.47). `searchIndexer.locker.credentials` first shipped in agent-relay-2026.11.2. Earlier releases do not render the indexer's MinIO keys, so its uploads are never indexed. @@ -63,15 +63,15 @@ command runs in `docs/azure-install`: ```sh git clone https://github.com/AgentWorkforce/infra.git && cd infra/docs/azure-install -mkdir release && gh release download agent-relay-2026.11.5 -R AgentWorkforce/infra -D release -(cd release && shasum -a 256 -c SHA256SUMS && tar -xzf agent-relay-0.7.10.tgz) | tail -1 +mkdir release && gh release download agent-relay-2026.11.16 -R AgentWorkforce/infra -D release +(cd release && shasum -a 256 -c SHA256SUMS && tar -xzf agent-relay-0.7.54.tgz) | tail -1 # Public GHCR images: no mirror root. sed 's#__IMAGE_MIRROR_ROOT__/##' release/release-images.values.yaml > release-images.values.yaml -CHART=release/agent-relay-0.7.10.tgz +CHART=release/agent-relay-0.7.54.tgz ``` No `gh`? Download the same assets from the -[release page](https://github.com/AgentWorkforce/infra/releases/tag/agent-relay-2026.11.5) +[release page](https://github.com/AgentWorkforce/infra/releases/tag/agent-relay-2026.11.16) into `release/`. **Done when:** every checksum line ends in `OK` (the last is @@ -307,7 +307,7 @@ codes and verification are in the ## Known limits - Any release other than agent-relay-2026.11.0 (patched); `values.yaml` renders - against agent-relay-2026.11.5 but was not installed from it. + against agent-relay-2026.11.16 but was not installed from it. - The output facts bootstrap (step 10). - Azure Database for PostgreSQL, Azure Blob Storage, Application Gateway. - NetworkPolicy enforcement beyond a default install, private clusters, diff --git a/web/content/self-hosting/install-eks.md b/web/content/self-hosting/install-eks.md index 1dcfa9fd..5827f4b6 100644 --- a/web/content/self-hosting/install-eks.md +++ b/web/content/self-hosting/install-eks.md @@ -7,11 +7,12 @@ Run the steps in order. Copy each block, replace every `<...>`, and check the **Done when** line before you move on. Expect about two hours, most of it waiting on AWS. -**Release:** `agent-relay-2026.11.5` (infra commit `ef3f69ab`, chart 0.7.10). +**Release:** `agent-relay-2026.11.16` (infra commit `ece71b9d`, chart 0.7.54). These steps were run end to end on an existing EKS cluster on 2026-11-14: -installed with `agent-relay-2026.11.3`, then upgraded to this release with -[Upgrades](/docs/self-hosting/upgrades). To run a newer release, install this -one and then follow Upgrades. +installed with `agent-relay-2026.11.3`, then upgraded to `agent-relay-2026.11.5` +with [Upgrades](/docs/self-hosting/upgrades). `values.yaml` renders against +`agent-relay-2026.11.16` but was not installed from it. To run a newer release, +install this one and then follow Upgrades. **You need:** @@ -49,8 +50,8 @@ curl -fsSLO "$base/SHA256SUMS" for f in $(awk '{print $2}' SHA256SUMS); do curl -fsSLO "$base/$f"; done shasum -a 256 -c SHA256SUMS git clone https://github.com/AgentWorkforce/infra.git -git -C infra checkout agent-relay-2026.11.5 -test "$(git -C infra rev-parse HEAD)" = ef3f69ab8e557fb9282eb292b6975c210501c61f && echo "release ok" +git -C infra checkout agent-relay-2026.11.16 +test "$(git -C infra rev-parse HEAD)" = ece71b9df93df64cb63676d2a0ca2767eccc6599 && echo "release ok" ``` Tools: `terraform` 1.11 or later, `helm` 3.10 or later (Helm 3, not Helm 4), @@ -252,7 +253,7 @@ export AWS_REGION= export ALB_SUBNET_CIDR_A= export ALB_SUBNET_CIDR_B= export IMAGE_REPO_PREFIX=ghcr.io/agentworkforce -export SERVICES_IMAGE=ghcr.io/agentworkforce/sessions-pipeline@sha256:ba02f1498d53a089da7ff8fdb7e47215f561c55d9f292e1995b7b5c97d9c37a1 +export SERVICES_IMAGE=ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9 export PSQL_IMAGE=ghcr.io/cloudnative-pg/postgresql:17-standard-trixie@sha256:ed6923f9ba2399cf9070379a353c710c29ced8a294be73986a2c3dae7e599ce3 export NAMESPACE=agent-relay export INSTALL_DIR="$PWD" # run "source settings.sh" from the agent-relay-install folder @@ -725,10 +726,10 @@ first four; `rds-setup.sh` runs the services image and the PostgreSQL client. | Image | Version | `image@digest` | |---|---|---| -| Control API | `c276e638` | `ghcr.io/agentworkforce/relay-control@sha256:46e2cb514ba2ab3ec753fb3f3c0e17caff562350cbb671dbfc9f49b9463e0d49` | -| Dashboard | `0090a040` | `ghcr.io/agentworkforce/relay-webapp@sha256:9414d55446bbd4db9c82e344c109a4e829d76f536a49bd5917e7ebcc86ed3f23` | -| Relaycast | 12.8.0-pg.3 | `ghcr.io/agentworkforce/relaycast-self-host@sha256:cc2a79f02d39978fa04322b5a45497737ff137bc2a5db5615c7eee690030de83` | -| Sessions services | `f8ac49b3` | `ghcr.io/agentworkforce/sessions-pipeline@sha256:ba02f1498d53a089da7ff8fdb7e47215f561c55d9f292e1995b7b5c97d9c37a1` | +| Control API | 0.5.34 (`2258889a`) | `ghcr.io/agentworkforce/relay-control@sha256:377bc2b9477d0bbd966cccd61380dd9d7f6e022a76ff0f7ad80e391d56ec0a83` | +| Dashboard | `be770cac` | `ghcr.io/agentworkforce/relay-webapp@sha256:da0cc80476eac734299c0c6ceb94e2bca7dae7913cce56a8ca8592cf086dd02e` | +| Relaycast | 12.10.0 | `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af15cf575b53a71d7eb09f2e6ab6e7c0d5be2da35339a275a5c6cc` | +| Sessions services | `b96e1e1e` | `ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9` | | PostgreSQL client | 17-standard-trixie | `ghcr.io/cloudnative-pg/postgresql:17-standard-trixie@sha256:ed6923f9ba2399cf9070379a353c710c29ced8a294be73986a2c3dae7e599ce3` | Each image line in `values.yaml` sits under `x-pins`. Don't swap an image on @@ -749,10 +750,10 @@ export ECR=.dkr.ecr..amazonaws.com aws ecr get-login-password --region "$AWS_REGION" | crane auth login "$ECR" -u AWS --password-stdin copied=0 for src in \ - ghcr.io/agentworkforce/relay-control@sha256:46e2cb514ba2ab3ec753fb3f3c0e17caff562350cbb671dbfc9f49b9463e0d49 \ - ghcr.io/agentworkforce/relay-webapp@sha256:9414d55446bbd4db9c82e344c109a4e829d76f536a49bd5917e7ebcc86ed3f23 \ - ghcr.io/agentworkforce/relaycast-self-host@sha256:cc2a79f02d39978fa04322b5a45497737ff137bc2a5db5615c7eee690030de83 \ - ghcr.io/agentworkforce/sessions-pipeline@sha256:ba02f1498d53a089da7ff8fdb7e47215f561c55d9f292e1995b7b5c97d9c37a1 \ + ghcr.io/agentworkforce/relay-control@sha256:377bc2b9477d0bbd966cccd61380dd9d7f6e022a76ff0f7ad80e391d56ec0a83 \ + ghcr.io/agentworkforce/relay-webapp@sha256:da0cc80476eac734299c0c6ceb94e2bca7dae7913cce56a8ca8592cf086dd02e \ + ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af15cf575b53a71d7eb09f2e6ab6e7c0d5be2da35339a275a5c6cc \ + ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9 \ ghcr.io/cloudnative-pg/postgresql@sha256:ed6923f9ba2399cf9070379a353c710c29ced8a294be73986a2c3dae7e599ce3 do repo="agent-relay/${src%@*}"; digest="${src#*@}" @@ -773,6 +774,6 @@ whole block again; images already copied are quick. Then, in `settings.sh` (step 6): - `IMAGE_REPO_PREFIX=$ECR/agent-relay/ghcr.io/agentworkforce`; -- `SERVICES_IMAGE=$ECR/agent-relay/ghcr.io/agentworkforce/sessions-pipeline@sha256:ba02f149…` +- `SERVICES_IMAGE=$ECR/agent-relay/ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61…` and `PSQL_IMAGE=$ECR/agent-relay/ghcr.io/cloudnative-pg/postgresql@sha256:ed6923f9…`, with the full digests from the loop. diff --git a/web/content/self-hosting/install-gke.md b/web/content/self-hosting/install-gke.md index 43f98e4a..ae6b7473 100644 --- a/web/content/self-hosting/install-gke.md +++ b/web/content/self-hosting/install-gke.md @@ -7,8 +7,9 @@ Run the steps in order. Copy each block, replace every `<...>`, and check the **Done when** line before you move on. Expect about an hour and a half, most of it waiting on Google Cloud: the HTTPS certificate alone can take up to an hour. -**Release:** `agent-relay-2026.11.9` (infra commit `5370050a`, chart 0.7.21). -Read [Known limits](#known-limits) before a production rollout. +**Release:** `agent-relay-2026.11.16` (infra commit `ece71b9d`, chart 0.7.54). +The downloadable `values.yaml` renders against this release, which was not +installed on GKE. Read [Known limits](#known-limits) before a production rollout. **You need:** @@ -55,14 +56,14 @@ curl -fsSLO "$base/SHA256SUMS" for f in $(awk '{print $2}' SHA256SUMS); do curl -fsSLO "$base/$f"; done shasum -a 256 -c SHA256SUMS git clone https://github.com/AgentWorkforce/infra.git -git -C infra checkout agent-relay-2026.11.9 -test "$(git -C infra rev-parse HEAD)" = 5370050a974f330b120831ef376903ff2f7447b7 && echo "release ok" -mkdir release && gh release download agent-relay-2026.11.9 -R AgentWorkforce/infra -D release -(cd release && shasum -a 256 -c SHA256SUMS && tar -xzf agent-relay-0.7.21.tgz) | tail -1 +git -C infra checkout agent-relay-2026.11.16 +test "$(git -C infra rev-parse HEAD)" = ece71b9df93df64cb63676d2a0ca2767eccc6599 && echo "release ok" +mkdir release && gh release download agent-relay-2026.11.16 -R AgentWorkforce/infra -D release +(cd release && shasum -a 256 -c SHA256SUMS && tar -xzf agent-relay-0.7.54.tgz) | tail -1 ``` No `gh`? Download the same assets from the -[release page](https://github.com/AgentWorkforce/infra/releases/tag/agent-relay-2026.11.9) +[release page](https://github.com/AgentWorkforce/infra/releases/tag/agent-relay-2026.11.16) into `release/`. Tools: `gcloud` (with `gke-gcloud-auth-plugin`), `terraform` 1.11 or later (or @@ -313,7 +314,7 @@ export MIRROR_ROOT=-docker.pkg.dev//agent-relay-mirror export NAMESPACE=agent-relay export HELM_RELEASE=agent-relay export STATIC_IP_NAME=agent-relay-ingress -export SERVICES_IMAGE=$MIRROR_ROOT/ghcr.io/agentworkforce/sessions-pipeline@sha256:3d9c0a4dff67c92da30964857713e625f3f967bc2ff98851614a70adbb4fe3fe +export SERVICES_IMAGE=$MIRROR_ROOT/ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9 export PSQL_IMAGE=$MIRROR_ROOT/ghcr.io/cloudnative-pg/postgresql@sha256:ed6923f9ba2399cf9070379a353c710c29ced8a294be73986a2c3dae7e599ce3 export INSTALL_DIR="$PWD" # run "source settings.sh" from the agent-relay-install folder export CHART="$INSTALL_DIR/release/agent-relay" @@ -449,7 +450,7 @@ instead of this block. vals works with Google Secret Manager. ## 11. Install with Helm ```sh -helm upgrade --install $HELM_RELEASE "$INSTALL_DIR/release/agent-relay-0.7.21.tgz" --namespace $NAMESPACE \ +helm upgrade --install $HELM_RELEASE "$INSTALL_DIR/release/agent-relay-0.7.54.tgz" --namespace $NAMESPACE \ -f "$CHART/values-gcp.yaml" -f "$CHART/values-gcp-native.yaml" \ -f "$INSTALL_DIR/managed-values.json" -f "$INSTALL_DIR/values.yaml" \ -f "$INSTALL_DIR/release-images.values.yaml" --timeout 25m @@ -485,7 +486,7 @@ done bash cloud-sql-setup.sh post kubectl -n $NAMESPACE rollout restart deploy/agent-relay-read-api deploy/agent-relay-ingest-edge deploy/agent-relay-search-indexer for j in $(kubectl -n $NAMESPACE get jobs -o name | grep search-indexer-bootstrap); do kubectl -n $NAMESPACE delete "$j"; done -helm upgrade --install $HELM_RELEASE "$INSTALL_DIR/release/agent-relay-0.7.21.tgz" --namespace $NAMESPACE \ +helm upgrade --install $HELM_RELEASE "$INSTALL_DIR/release/agent-relay-0.7.54.tgz" --namespace $NAMESPACE \ -f "$CHART/values-gcp.yaml" -f "$CHART/values-gcp-native.yaml" \ -f "$INSTALL_DIR/managed-values.json" -f "$INSTALL_DIR/values.yaml" \ -f "$INSTALL_DIR/release-images.values.yaml" --timeout 25m @@ -916,7 +917,7 @@ equal to the `proven` in the plan line you kept, and `exit 0`. ## Known limits -What release `agent-relay-2026.11.9` doesn't do on GKE yet: +What release `agent-relay-2026.11.16` doesn't do on GKE yet: 1. **Upgrading from 2026.11.5 or earlier: re-stamp once.** Those releases recorded sessions uploaded to Cloud Storage as if they were in S3, so their diff --git a/web/content/self-hosting/overview.md b/web/content/self-hosting/overview.md index 58449055..fbc8e30a 100644 --- a/web/content/self-hosting/overview.md +++ b/web/content/self-hosting/overview.md @@ -109,7 +109,8 @@ yourself. | `agent-relay-2026.11.6` (infra commit `6b98a4ab`) | 0.7.11 | GKE | | `agent-relay-2026.11.7` (infra commit `b63ec4a3`) | 0.7.14 | GKE | | `agent-relay-2026.11.8` (infra commit `e15513ba`) | 0.7.15 | GKE | -| `agent-relay-2026.11.9` (infra commit `5370050a`) | 0.7.21 | [GKE](/docs/self-hosting/install-gke) (current; see its [known limits](/docs/self-hosting/install-gke#known-limits)) | +| `agent-relay-2026.11.9` (infra commit `5370050a`) | 0.7.21 | GKE | +| `agent-relay-2026.11.16` (infra commit `ece71b9d`) | 0.7.54 | [EKS](/docs/self-hosting/install-eks), [GKE](/docs/self-hosting/install-gke) and [AKS](/docs/self-hosting/install-aks) (current; see the [GKE known limits](/docs/self-hosting/install-gke#known-limits) and [AKS known limits](/docs/self-hosting/install-aks#known-limits)) | Charts, Terraform and helper scripts come from the public [AgentWorkforce/infra](https://github.com/AgentWorkforce/infra) repository at a diff --git a/web/public/self-hosting/files/eks/SHA256SUMS b/web/public/self-hosting/files/eks/SHA256SUMS index e24a9812..1f0a49e8 100644 --- a/web/public/self-hosting/files/eks/SHA256SUMS +++ b/web/public/self-hosting/files/eks/SHA256SUMS @@ -5,4 +5,4 @@ d2208cdf9011cd06fb103250da1fc9129b69dc6f4119456da531593c2728f1d7 okta-setup.sh b43755a02f2972ad9f8b405b8f2c3acd20cf1f6d999009f1cbe644f3f4fa90b8 opensearch-roles-via-cluster.sh 148e8ca95cc74a398eb404b01d2e01c896252b516368f364d0886bccc1c19216 rds-session-erase-search.sql c29aea950c6112eb10d974cb28e79a3273ae2af7b2ba8484a07afed48a9e0a83 rds-setup.sh -0e4ab38da4b033e341123227473c950ce8e67dc323aa348a8ba1eb9229822662 values.yaml +dfd14e34f46285c6551114459b874d3e03a6a313e6a061106da203929ba8b3b5 values.yaml diff --git a/web/public/self-hosting/files/eks/values.yaml b/web/public/self-hosting/files/eks/values.yaml index c2f8fc59..9f872827 100644 --- a/web/public/self-hosting/files/eks/values.yaml +++ b/web/public/self-hosting/files/eks/values.yaml @@ -20,8 +20,8 @@ # workload using it takes both from here. To move to a newer build or a new image # name, change only that line. See the Images table at agentrelay.com/docs/self-hosting/install-eks. x-pins: - services-image: &services_image { repository: __IMAGE_REPO_PREFIX__/sessions-pipeline, digest: "sha256:ba02f1498d53a089da7ff8fdb7e47215f561c55d9f292e1995b7b5c97d9c37a1" } - webapp-image: &webapp_image { repository: __IMAGE_REPO_PREFIX__/relay-webapp, digest: "sha256:9414d55446bbd4db9c82e344c109a4e829d76f536a49bd5917e7ebcc86ed3f23" } + services-image: &services_image { repository: __IMAGE_REPO_PREFIX__/sessions-pipeline, digest: "sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9" } + webapp-image: &webapp_image { repository: __IMAGE_REPO_PREFIX__/relay-webapp, digest: "sha256:da0cc80476eac734299c0c6ceb94e2bca7dae7913cce56a8ca8592cf086dd02e" } components: relaycast: true @@ -55,7 +55,7 @@ relaycast: postgres: image: repository: __IMAGE_REPO_PREFIX__/relaycast-self-host - digest: sha256:cc2a79f02d39978fa04322b5a45497737ff137bc2a5db5615c7eee690030de83 + digest: sha256:ec062ef901af15cf575b53a71d7eb09f2e6ab6e7c0d5be2da35339a275a5c6cc postgresCa: enabled: true configMap: rds-ca @@ -279,7 +279,7 @@ sessions-pipeline: relay-control: image: repository: __IMAGE_REPO_PREFIX__/relay-control - digest: sha256:46e2cb514ba2ab3ec753fb3f3c0e17caff562350cbb671dbfc9f49b9463e0d49 + digest: sha256:377bc2b9477d0bbd966cccd61380dd9d7f6e022a76ff0f7ad80e391d56ec0a83 # The chart allows one replica: login and device rate limits are per process. replicaCount: 1 existingSecret: agent-relay-secrets