Skip to content

docs: fix ScyllaDB Cloud TLS and client routes details - #1151

Merged
nikagra merged 1 commit into
scylladb:scylla-4.xfrom
nikagra:connectivity-fixes
Sep 29, 2026
Merged

nikagra merged 1 commit into
scylladb:scylla-4.xfrom
nikagra:connectivity-fixes

Conversation

@nikagra

@nikagra nikagra commented Sep 25, 2026 •

Copy link
Copy Markdown

Depends on: nothing (independent of #1139; they merge in either order)
Blocks: nothing

#1130's connectivity pages have mistakes that block a ScyllaDB Cloud connection: the TLS sample uses the plaintext port and trusts a public CA, and the client routes pointers send single-hostname proxies to the wrong answer. #1143 and #1149 already carry these fixes (#1144 and #1145 some of them), so this puts them on scylla-4.x and every copy uses the same wording.

  • vpc_peering: the sample uses three contact points on 9142, with the cluster's own CA imported into a truststore; the local query reads rpc_address; the quick overview links to the page's own "not reachable" section
  • client routes pointers (connectivity, address_resolution) apply only to endpoints that publish a per-node mapping on Enterprise 2026.1 or later; a single hostname goes to FixedHostNameAddressTranslator, whose snippet now nests advertised-hostname where the translator reads it, with the caveat that it keeps each node's port, so without a port per node the proxy picks the node
  • client_routes: route DNS lookups block the admin threads, not Netty I/O; networkaddress.cache.ttl is read once
  • the client routes quick start and the upgrade guide use createUnresolved, and the upgrade guide's HOCON example sets contact points

Verified with cd docs && make test (exit 0, no warnings) and by grepping the built HTML for the new anchors. Not covered: the multiversion site build.

Refs #1119
Jira: DRIVER-1042

🤖 Generated with Claude Code

@coderabbitai

coderabbitai Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 33 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: QUIET

Plan: Advanced

Run ID: bafdfa7c-2b11-42e4-a1b2-e2444e8f48b4

📥 Commits

Reviewing files that changed from the base of the PR and between 9167ca1 and f8af702.

📒 Files selected for processing (5)
  • manual/core/address_resolution/README.md
  • manual/core/connectivity/README.md
  • manual/core/connectivity/client_routes/README.md
  • manual/core/connectivity/vpc_peering/README.md
  • upgrade_guide/README.md

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.

@nikagra
nikagra marked this pull request as ready for review September 25, 2026 13:10
@nikagra
nikagra requested a review from dkropachev September 25, 2026 13:10
scylladb#1130 shipped a TLS sample on Cloud's plaintext port with a CA that
does not apply, the internode column in the system.local query,
client routes pointers that ignore single-hostname proxies, and the
wrong thread for route DNS lookups. Fix them here so the per-version
backports copy one wording.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
@nikagra
nikagra merged commit eccb142 into scylladb:scylla-4.x Sep 29, 2026
49 of 52 checks passed
@nikagra
nikagra deleted the connectivity-fixes branch September 29, 2026 13:16
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