Skip to content

ROB-3611: updated docs to match new cluster-sizes approach#2066

Open
nimrik wants to merge 3 commits intomasterfrom
ROB-3611-cluster-sizes-doc-update
Open

ROB-3611: updated docs to match new cluster-sizes approach#2066
nimrik wants to merge 3 commits intomasterfrom
ROB-3611-cluster-sizes-doc-update

Conversation

@nimrik
Copy link
Copy Markdown

@nimrik nimrik commented May 4, 2026

No description provided.

@nimrik nimrik requested review from arikalon1 and moshemorad May 4, 2026 09:03
@nimrik nimrik self-assigned this May 4, 2026
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented May 4, 2026

CLA assistant check
All committers have signed the CLA.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 4, 2026

Review Change Stack
No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7afd187-6d4a-49f6-af35-1e3b096e7df5

📥 Commits

Reviewing files that changed from the base of the PR and between e3ba6cf and 42cca4e.

📒 Files selected for processing (4)
  • docs/help.rst
  • docs/setup-robusta/gitops/argocd.rst
  • docs/setup-robusta/gitops/flux.rst
  • docs/setup-robusta/multi-cluster.rst
✅ Files skipped from review due to trivial changes (3)
  • docs/setup-robusta/multi-cluster.rst
  • docs/setup-robusta/gitops/flux.rst
  • docs/help.rst
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/setup-robusta/gitops/argocd.rst

Walkthrough

Documentation across multiple installation and GitOps setup guides is updated to reflect a Helm configuration parameter change from isSmallCluster=true to clusterSize=small for small/test clusters. Example commands and value configurations are adjusted accordingly.

Changes

Parameter Migration Documentation

Layer / File(s) Summary
Config / generated_values.yaml
docs/setup-robusta/gitops/argocd.rst, docs/setup-robusta/gitops/flux.rst, docs/setup-robusta/multi-cluster.rst
Adds clusterSize: small examples and updates guidance; removes prior isSmallCluster: true usage and updates the helm get values extraction to strip clusterSize.
Helm Install Examples
docs/setup-robusta/installation/_helm_install_no_prometheus.inc.rst, docs/setup-robusta/installation/_helm_install_with_prometheus.inc.rst
Local/Test Cluster Helm commands updated to use --set clusterSize=small; removed isSmallCluster=true and an extra holmes.resources.requests.memory=512Mi override; Prometheus overrides retained where present.
Troubleshooting Guidance
docs/help.rst
Prometheus pending-pod troubleshooting section updated to instruct re-installation with --set clusterSize=small and retain follow-up kube-prometheus-stack.prometheus.prometheusSpec arguments.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

  • robusta-dev/robusta#2059: Touches the same installation/docs area and cluster-size/generation values; likely related documentation edits.

Suggested reviewers

  • arikalon1
  • moshemorad
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning No pull request description was provided by the author, making it impossible to assess whether the description relates to the changeset. Add a description explaining the cluster-sizes approach change and why the documentation updates were necessary.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately describes the main change: updating documentation to reflect a new cluster-sizes configuration approach (replacing isSmallCluster with clusterSize).
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch ROB-3611-cluster-sizes-doc-update

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

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 4, 2026

Docker image ready for c3f8f37 (built in 1m 33s)

⚠️ Warning: does not support ARM (ARM images are built on release only - not on every PR)

Use this tag to pull the image for testing.

📋 Copy commands

⚠️ Temporary images are deleted after 30 days. Copy to a permanent registry before using them:

gcloud auth configure-docker us-central1-docker.pkg.dev
docker pull us-central1-docker.pkg.dev/robusta-development/temporary-builds/robusta-runner:c3f8f37
docker tag us-central1-docker.pkg.dev/robusta-development/temporary-builds/robusta-runner:c3f8f37 me-west1-docker.pkg.dev/robusta-development/development/robusta-runner-dev:c3f8f37
docker push me-west1-docker.pkg.dev/robusta-development/development/robusta-runner-dev:c3f8f37

Patch Helm values in one line:

helm upgrade --install robusta robusta/robusta \
  --reuse-values \
  --set runner.image=me-west1-docker.pkg.dev/robusta-development/development/robusta-runner-dev:c3f8f37

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/setup-robusta/installation/_helm_install_with_prometheus.inc.rst`:
- Around line 80-86: The docs say to use --set clusterSize=small but the chart
templates check .Values.isSmallCluster (e.g., in runner.yaml and
forwarder.yaml), so add a mapping so clusterSize controls isSmallCluster: update
values.yaml to include clusterSize: "" (or "small") and set isSmallCluster
default false, then add logic in your helper templates (e.g., _helpers.tpl) to
set isSmallCluster = true when .Values.clusterSize == "small" (or accept boolean
|| string) so .Values.isSmallCluster is driven by .Values.clusterSize;
alternatively, if you prefer the docs change instead, update the docs snippet to
use --set isSmallCluster=true and remove the incorrect clusterSize example.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e152c07f-4b47-4ef0-a924-1cf5f45f1b24

📥 Commits

Reviewing files that changed from the base of the PR and between 447c385 and e3ba6cf.

📒 Files selected for processing (6)
  • docs/help.rst
  • docs/setup-robusta/gitops/argocd.rst
  • docs/setup-robusta/gitops/flux.rst
  • docs/setup-robusta/installation/_helm_install_no_prometheus.inc.rst
  • docs/setup-robusta/installation/_helm_install_with_prometheus.inc.rst
  • docs/setup-robusta/multi-cluster.rst

Comment on lines +80 to +86
Test clusters tend to have fewer resources. To lower Robusta's resource requests, set ``clusterSize=small``.

.. code-block:: bash
:name: cb-helm-install-test-clusters

helm repo add robusta https://robusta-charts.storage.googleapis.com && helm repo update
helm install robusta robusta/robusta -f ./generated_values.yaml --set clusterName=<YOUR_CLUSTER_NAME> --set isSmallCluster=true \
helm install robusta robusta/robusta -f ./generated_values.yaml --set clusterName=<YOUR_CLUSTER_NAME> --set clusterSize=small \
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== References in chart values/templates =="
rg -n -C2 'clusterSize|isSmallCluster|Values\.clusterSize|Values\.isSmallCluster' helm/robusta

echo
echo "== Check for mapping logic (helpers/templates) =="
rg -n -C2 'isSmallCluster.*clusterSize|clusterSize.*isSmallCluster|eq .*clusterSize.*small' helm/robusta

echo
echo "== Docs switched to clusterSize =="
rg -n -C1 'clusterSize:\s*small|--set clusterSize=small' docs/setup-robusta docs/help.rst

Repository: robusta-dev/robusta

Length of output: 3404


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Check values.yaml for clusterSize and isSmallCluster =="
rg -n 'clusterSize|isSmallCluster' helm/robusta/values.yaml

echo
echo "== Check _helpers.tpl for mapping logic =="
rg -n 'clusterSize|isSmallCluster' helm/robusta/templates/_helpers.tpl

echo
echo "== List all yaml files in helm/robusta =="
fd -e yaml -e yml helm/robusta

Repository: robusta-dev/robusta

Length of output: 122


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== List all files in helm/robusta =="
find helm/robusta -type f | head -30

echo
echo "== Check if values.yaml exists and read first 50 lines =="
if [ -f helm/robusta/values.yaml ]; then
  head -50 helm/robusta/values.yaml
else
  echo "values.yaml not found at helm/robusta/values.yaml"
fi

echo
echo "== Check Chart.yaml =="
if [ -f helm/robusta/Chart.yaml ]; then
  cat helm/robusta/Chart.yaml
fi

Repository: robusta-dev/robusta

Length of output: 3219


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Search entire values.yaml for clusterSize/isSmallCluster =="
grep -n 'clusterSize\|isSmallCluster' helm/robusta/values.yaml || echo "Not found in values.yaml"

echo
echo "== Read the actual .rst file (lines 75-95) =="
sed -n '75,95p' docs/setup-robusta/installation/_helm_install_with_prometheus.inc.rst

echo
echo "== Check _helpers.tpl =="
cat helm/robusta/templates/_helpers.tpl

Repository: robusta-dev/robusta

Length of output: 6246


Fix documentation or chart: --set clusterSize=small does not reduce resource requests.

The docs instruct --set clusterSize=small, but the Helm chart never reads clusterSize. Templates check .Values.isSmallCluster (in runner.yaml and forwarder.yaml) to reduce memory/storage requests for test clusters. No mapping exists between the two parameters, so following the docs produces no effect—test clusters will use full resource requests and may fail silently.

Either update docs to use --set isSmallCluster=true, or add mapping logic in the chart (e.g., in _helpers.tpl or values.yaml) to set isSmallCluster based on clusterSize.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/setup-robusta/installation/_helm_install_with_prometheus.inc.rst` around
lines 80 - 86, The docs say to use --set clusterSize=small but the chart
templates check .Values.isSmallCluster (e.g., in runner.yaml and
forwarder.yaml), so add a mapping so clusterSize controls isSmallCluster: update
values.yaml to include clusterSize: "" (or "small") and set isSmallCluster
default false, then add logic in your helper templates (e.g., _helpers.tpl) to
set isSmallCluster = true when .Values.clusterSize == "small" (or accept boolean
|| string) so .Values.isSmallCluster is driven by .Values.clusterSize;
alternatively, if you prefer the docs change instead, update the docs snippet to
use --set isSmallCluster=true and remove the incorrect clusterSize example.

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.

2 participants