Skip to content

docs: add Materialize Cloud cluster sizes reference - #38792

Open
maheshwarip wants to merge 1 commit into
mainfrom
claude/admiring-bell-irtbke
Open

docs: add Materialize Cloud cluster sizes reference#38792
maheshwarip wants to merge 1 commit into
mainfrom
claude/admiring-bell-irtbke

Conversation

@maheshwarip

@maheshwarip maheshwarip commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

Motivation

Closes EDU-73. A customer asked where to find memory/disk limits for Cloud clusters (internal Slack thread); the old cc to M.1 size mapping page only mapped sizes to each other, not to actual resource numbers.

Description

  • Adds /materialize-cloud/cluster-sizes/, with two sections:
    • cc sizes: exact CPU/memory/disk/credits-per-hour table, via a new materialize-cloud/cluster-sizes-cc shortcode (HTML + skill.md variants) that reads the existing self_managed_cluster_sizes.yml data (same underlying allocations, already used for the self-managed appendix page — single-sourced, no new numbers introduced).
    • M.1 sizes: reuses the existing m1_cluster_sizing.yml table (already shipped on sql/create-cluster), with added prose clarifying that "Total Capacity" is a combined memory+disk pool, not two separate limits.
  • Removes clusters/m1-cc-mapping.md and its two now-unused mapping data files, and repoints the three "See also" links from the SQL reference pages to the new page. Old URLs 301 via aliases.
  • Reviewer note: I couldn't reach an authoritative Cloud-specific source for the cc size resource numbers (the source-of-truth lives in the cloud repo, out of scope here); I'm reusing the self-managed default allocations, which line up with Cloud's published credits/hour progression. Worth a sanity check from someone with Cloud pricing/infra context before merge.

Verification

Built both output targets locally (hugo HTML + hugo --config config.toml,config.skill.toml markdown) and ran htmltest: no new broken links or render issues from this change (pre-existing failure on an unrelated create-sink/kafka anchor).

🤖 Generated with Claude Code

https://claude.ai/code/session_014CeaDCfsZEupnH8Hs34ems

Replaces the cc-to-M.1 size mapping guide with a "Cluster sizes" page
under Materialize Cloud docs that lists exact resource allocations
(CPU, memory, disk, credits/hour) for cc sizes, and clarifies that the
M.1 "Total Capacity" figure is a combined memory-and-disk pool rather
than two separate limits.

Closes: EDU-73

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014CeaDCfsZEupnH8Hs34ems
@maheshwarip
maheshwarip requested a review from a team as a code owner September 11, 2026 18:28
@linear-code

linear-code Bot commented Sep 11, 2026

Copy link
Copy Markdown

EDU-73

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