Skip to content

Review fixes for the memory-mappings page, and a security pillar - #541

Merged
g-despot merged 1 commit into
mainfrom
docs/mmap-error-page-round2
Sep 16, 2026
Merged

g-despot merged 1 commit into
mainfrom
docs/mmap-error-page-round2

Conversation

@g-despot

Copy link
Copy Markdown
Contributor

Review follow-up to #536, plus one addition.

  • The Helm values key was wrong: initContainers.sysctlVmMaxMapCountinitContainers.sysctlInitContainer.sysctlVmMaxMapCount. Helm swallows unknown keys, so the wrong key silently left the limit at the chart's 524288 — the worst place for that is the fix path of an error page. Verified against the chart template, which also sets vm.overcommit_memory=1 (now noted, so nobody disables the init container to replace it).
  • The log-line table is now two sentences of "search for the phrase" prose plus a <details> block pinned to v1.39.5/v1.40.0, and the docs_url field is dated Since v1.39.5 (EntryFacts gained a since prop).
  • The sizing numbers get one sentence of arithmetic (70% budget → ~2.9M mappings at 4194304; 3 reserved per shard open), and 262144 is credited to Elasticsearch by name. sysctl persistence moved to an idempotent /etc/sysctl.d drop-in on both pages. The errors index card is narrowed to the one entry that exists.
  • New Lock the door pillar on /improve-your-cluster (authentication on, anonymous access off, RBAC, network exposure): the banner puts this page in front of fresh OSS clusters, exactly the population most likely to be running open.

Merging note: docs/improve-your-cluster-structure rewrites the same page; whichever lands second ports the pillar onto its restructured checklists.

- Correct the Helm values key to
  initContainers.sysctlInitContainer.sysctlVmMaxMapCount and note the
  init container also sets vm.overcommit_memory=1.
- Collapse the log-line table into search-the-phrase prose plus a
  version-pinned details block; date the docs_url field to v1.39.5
  (new EntryFacts since prop).
- Derive the sizing numbers (70% budget, 3 mappings reserved per shard
  open) and name Elasticsearch for 262144.
- Move sysctl persistence to a /etc/sysctl.d drop-in; add sudo; fix
  the kernel-default wording.
- Narrow the errors index card to what the page covers.
- Add a Lock-the-door pillar to /improve-your-cluster: authentication
  on, anonymous access off, RBAC, network exposure.

@orca-security-eu orca-security-eu Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Orca Security Scan Summary

Status Check Issues by priority
Passed Passed Infrastructure as Code high 0   medium 0   low 0   info 0 View in Orca
Passed Passed SAST high 0   medium 0   low 0   info 0 View in Orca
Passed Passed Secrets high 0   medium 0   low 0   info 0 View in Orca
Passed Passed Vulnerabilities high 0   medium 0   low 0   info 0 View in Orca

@g-despot
g-despot merged commit 75f443b into main Sep 16, 2026
13 checks passed
@g-despot
g-despot deleted the docs/mmap-error-page-round2 branch September 16, 2026 08:24
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.

1 participant