Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add zone config troubleshooting guide #19283

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

rmloveland
Copy link
Contributor

Fixes DOC-9210

Summary of changes:

  • XXX

@rmloveland rmloveland marked this pull request as draft January 6, 2025 22:39
Copy link

github-actions bot commented Jan 6, 2025

Files changed:

Copy link

netlify bot commented Jan 6, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 674915d
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-api-docs/deploys/6788121767fbc80008f0d4b7

Copy link

netlify bot commented Jan 6, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 674915d
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-interactivetutorials-docs/deploys/67881217aa54290008f7f6a0

Copy link

netlify bot commented Jan 6, 2025

Deploy Preview for cockroachdb-docs failed. Why did it fail? →

Name Link
🔨 Latest commit 674915d
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-docs/deploys/6788121746725800088b3999

@rmloveland rmloveland force-pushed the 20241209-DOC-9210-zone-config-troubleshooting-guide branch 6 times, most recently from 55f64b5 to 31bc927 Compare January 14, 2025 21:26
Fixes DOC-9210

Summary of changes:

- Add Zone Config troubleshooting guide

  - a.k.a. Chapter 3 of _The ZoneConfigonomicon (tm)_ (in this version
    of events, the existing 'Replication Controls' page is Chapter 1,
    and 'Zone Config Extensions' is Chapter 2)

- Update 'Replication controls' page with more detailed info re: zone
  config inheritance hierarchy and behavior

- Fix incorrect ALTER RANGE statements since they're needed to map range
  IDs from critical nodes endpoint (mentioned in troubleshooting guide)
  to actual schema objects

- Add links from various zone config-related pages to the new
  troubleshooting guide

- Add a note to various zone config-related pages saying "most users
  should not do manual zone config changes, see Multi-region SQL and
  Zone Config Extensions instead"
@rmloveland rmloveland force-pushed the 20241209-DOC-9210-zone-config-troubleshooting-guide branch from e8df32a to 674915d Compare January 15, 2025 19:52
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