v1.16.1

KubeBolt 1.16.1 — AgentChannel large-message fix

A patch over 1.16.0 with a single change: the AgentChannel
gRPC max message size is raised from gRPC's 4 MiB default to 64 MiB
(configurable). No other application code, API, or chart-template changes — a
clean helm upgrade from 1.16.0.

This is the backend half of a coordinated fix; the agent half ships as
kubebolt-agent 1.1.4. Both sides must be on the new versions for large
clusters — the message travels agent → backend, so the agent must be allowed to
send it and the backend to receive it.

Fixes

• AgentChannel gRPC max message size → 64 MiB (override with
  KUBEBOLT_AGENT_MAX_MSG_BYTES). On large production clusters the apiserver
  responses proxied over the channel (agent-proxy) exceed gRPC's 4 MiB default,
  failing the recv with ResourceExhausted: received message larger than max
  and tearing down the whole session — metrics included — in a reconnect
  loop. Surfaced on a multi-node prod EKS during pre-E1 benchmarking. Raised on
  both the backend server (MaxRecvMsgSize / MaxSendMsgSize) and the agent
  client (MaxCallRecvMsgSize / MaxCallSendMsgSize); the two limits are kept
  in sync and default to the same 64 MiB.

Upgrade

helm upgrade kubebolt oci://ghcr.io/clm-cloud-solutions/kubebolt/helm/kubebolt --version 1.16.1

Pair it with kubebolt-agent 1.1.4 in every cluster connected over
agent-proxy:

helm upgrade kubebolt-agent oci://ghcr.io/clm-cloud-solutions/kubebolt/helm/kubebolt-agent --version 1.1.4

No configuration changes required — the 64 MiB default applies out of the box.
To raise or lower it, set KUBEBOLT_AGENT_MAX_MSG_BYTES (bytes) to the same
value on both the backend and the agent.

---

Install

Helm (recommended for Kubernetes)

helm install kubebolt oci://ghcr.io/clm-cloud-solutions/kubebolt/helm/kubebolt
kubectl port-forward svc/kubebolt 3000:80

Single Binary (download below)

# macOS Apple Silicon
curl -LO https://github.com/clm-cloud-solutions/kubebolt/releases/download/v1.16.1/kubebolt-darwin-arm64
chmod +x kubebolt-darwin-arm64 && mv kubebolt-darwin-arm64 /usr/local/bin/kubebolt

# Linux amd64
curl -LO https://github.com/clm-cloud-solutions/kubebolt/releases/download/v1.16.1/kubebolt-linux-amd64
chmod +x kubebolt-linux-amd64 && sudo mv kubebolt-linux-amd64 /usr/local/bin/kubebolt

kubebolt --kubeconfig ~/.kube/config

All platform binaries are attached below. Verify with sha256sum -c CHECKSUMS.txt.

Docker (single container)

docker run -p 3000:3000 -v ~/.kube:/root/.kube:ro \
  ghcr.io/clm-cloud-solutions/kubebolt:1.16.1

Homebrew (macOS, Linux)

brew install clm-cloud-solutions/tap/kubebolt

kubectl krew plugin

kubectl krew index add clm https://github.com/clm-cloud-solutions/krew-index.git
kubectl krew install clm/kubebolt
kubectl kubebolt

Docker Compose

git clone https://github.com/clm-cloud-solutions/kubebolt.git
cd kubebolt/deploy && docker compose up -d

Container Images

• Single container (binary + frontend): ghcr.io/clm-cloud-solutions/kubebolt:1.16.1
• API only: ghcr.io/clm-cloud-solutions/kubebolt/api:1.16.1
• Web only: ghcr.io/clm-cloud-solutions/kubebolt/web:1.16.1

Changelog

Fixes

• fix(agent): raise AgentChannel gRPC max message size to 64 MiB (configurable) ()

Other

• Merge pull request #122 from clm-cloud-solutions/develop ()
• Merge pull request #121 from clm-cloud-solutions/fix/agent-grpc-msg-size ()
• chore(release): cut kubebolt 1.16.1 for the AgentChannel msg-size fix ()