Skip to content

docs: document ClickHouse for Intake in Helm deployment - #1085

Open
BrianNewsom wants to merge 3 commits into
mainfrom
brnewsom/clickhouse-helm
Open

docs: document ClickHouse for Intake in Helm deployment#1085
BrianNewsom wants to merge 3 commits into
mainfrom
brnewsom/clickhouse-helm

Conversation

@BrianNewsom

@BrianNewsom BrianNewsom commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds ClickHouse coverage across Helm deployment docs (database-setup, install, persistent-volumes, backup-and-restore, security, requirements) following the existing PostgreSQL documentation pattern
  • Simplifies the Helm README/template ClickHouse section: removes verbose sizing guidance and migration-ownership prose in favor of a concise intro + external configuration steps
  • Fixes grammar error in backup-and-restore.mdx and a broken anchor in security.mdx

Test plan

  • Review rendered docs for each changed page
  • Confirm all cross-page links resolve correctly

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added Helm guidance for configuring ClickHouse storage for Intake.
    • Documented embedded persistence, storage requirements, default ports, and sizing.
    • Added instructions for connecting to external ClickHouse databases, including credentials and HTTPS settings.
    • Expanded ClickHouse backup and restore guidance.
    • Clarified that embedded ClickHouse is intended for development and testing; separately managed services are recommended for production.
    • Updated installation examples and links to ClickHouse deployment options.

Adds ClickHouse coverage across the Helm deployment docs to match the
existing PostgreSQL documentation pattern: database-setup, install,
persistent-volumes, backup-and-restore, security, and requirements.

Also simplifies the Helm README/template ClickHouse section, removing
the verbose sizing guidance and migration-ownership prose in favor of
a concise intro and external configuration steps.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Brian Newsom <brnewsom@nvidia.com>
@BrianNewsom
BrianNewsom requested review from a team as code owners August 4, 2026 21:28
@github-actions github-actions Bot added the docs label Aug 4, 2026
@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Adds back the sizing guidance table and recommendations without the SQL
query block that was previously removed.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Brian Newsom <brnewsom@nvidia.com>
@coderabbitai

coderabbitai Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

Changes

ClickHouse deployment documentation

Layer / File(s) Summary
Deployment model and external database setup
docs/requirements.mdx, docs/set-up/helm/database-setup.mdx, docs/set-up/helm/index.mdx, docs/set-up/helm/install.mdx, k8s/helm/README.md, k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl
The documentation distinguishes embedded development use from external production ClickHouse services. It describes external credentials and connection settings.
Storage, backup, and network guidance
docs/set-up/helm/backup-and-restore.mdx, docs/set-up/helm/install.mdx, docs/set-up/helm/persistent-volumes.mdx, docs/set-up/security.mdx
The documentation adds ClickHouse persistence, Azure and EKS storage settings, backup references, and default service ports.
Helm reference alignment
k8s/helm/README.md, k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl, k8s/helm/values.yaml
Helm documentation and comments describe the embedded default, production scope, and 20 GiB persistence size. Previous sizing and operational guidance is removed.

Possibly related PRs

Suggested labels: docs

Suggested reviewers: shanaiabuggy, svvarom

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the primary change: documenting ClickHouse for Intake in Helm deployments.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch brnewsom/clickhouse-helm

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/set-up/security.mdx`:
- Around line 56-57: Update the port 9000 table entry to use the exact
description “Embedded ClickHouse native TCP protocol,” replacing the current
“native administration interface” wording while leaving the port and protocol
unchanged.

In `@k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl`:
- Around line 47-49: Update the external ClickHouse Secret instructions in both
k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl (lines 47-49) and
k8s/helm/README.md (lines 47-49): define NMP_NAMESPACE before the command and
use the shell-safe --namespace "$NMP_NAMESPACE" argument instead of the
placeholder namespace.
- Around line 47-49: Replace any ClickHouse password command-line examples using
--from-literal with --from-file or a secret-manager workflow in
k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl:47-49 and
docs/set-up/helm/database-setup.mdx:97-103. Regenerate k8s/helm/README.md:47-49
from the corrected template so the generated documentation contains no password
literals.
🪄 Autofix

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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 14c3e0fa-6a16-462e-881d-56e7f5577022

📥 Commits

Reviewing files that changed from the base of the PR and between f45c965 and 1b80bea.

📒 Files selected for processing (10)
  • docs/requirements.mdx
  • docs/set-up/helm/backup-and-restore.mdx
  • docs/set-up/helm/database-setup.mdx
  • docs/set-up/helm/index.mdx
  • docs/set-up/helm/install.mdx
  • docs/set-up/helm/persistent-volumes.mdx
  • docs/set-up/security.mdx
  • k8s/helm/README.md
  • k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl
  • k8s/helm/values.yaml

Comment thread docs/set-up/security.mdx Outdated
Comment thread k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl
@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor
Suite Lines Covered Line Rate Branch Rate
Unit Tests 30409/38435 79.1% 63.8%
Integration Tests 18010/37104 48.5% 21.0%

Signed-off-by: Brian Newsom <brnewsom@nvidia.com>

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl (1)

75-76: 🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Remove the retained sizing block.

The heading is still followed by the verbose sizing table and operational recommendations in Lines 77-105. This conflicts with the PR objective to replace that guidance with concise external-configuration instructions. Remove or replace the block.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl` around lines 75 - 76,
Remove the verbose ClickHouse sizing content following the “ClickHouse sizing”
heading, including its sizing table and operational recommendations. Replace it
with the concise external-configuration instructions required by the PR
objective, or remove the heading if no replacement guidance remains.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Outside diff comments:
In `@k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl`:
- Around line 75-76: Remove the verbose ClickHouse sizing content following the
“ClickHouse sizing” heading, including its sizing table and operational
recommendations. Replace it with the concise external-configuration instructions
required by the PR objective, or remove the heading if no replacement guidance
remains.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 7169abbc-37f2-4201-9ec6-857054a5d838

📥 Commits

Reviewing files that changed from the base of the PR and between 7dfb649 and b54e957.

📒 Files selected for processing (4)
  • docs/set-up/helm/database-setup.mdx
  • docs/set-up/security.mdx
  • k8s/helm/README.md
  • k8s/helm/helm-docs-template/nemo-helm-readme.md.gotmpl
🚧 Files skipped from review as they are similar to previous changes (3)
  • docs/set-up/security.mdx
  • docs/set-up/helm/database-setup.mdx
  • k8s/helm/README.md

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant