Skip to content

Improve swarm documentation - #2346

Open
ianton-ru wants to merge 3 commits into
antalya-26.6from
docs/antalya-26.6/swarm-usage
Open

ianton-ru wants to merge 3 commits into
antalya-26.6from
docs/antalya-26.6/swarm-usage

Conversation

@ianton-ru

@ianton-ru ianton-ru commented Sep 10, 2026 •

Copy link
Copy Markdown

Changelog category (leave one):

  • Documentation (changelog entry is not required)

Changelog entry (a user-readable short description of the changes that goes to CHANGELOG.md):

Improve swarm documentation

More comfortable link for reading doc

https://github.com/Altinity/ClickHouse/blob/docs/antalya-26.6/swarm-usage/docs/en/antalya/swarm.md

CI/CD Options

Exclude tests:

  • Fast test
  • Integration Tests
  • Stateless tests
  • Stateful tests
  • Unit tests
  • Performance tests
  • Aarch64 tests
  • All with ASAN
  • All with TSAN
  • All with MSAN
  • All with UBSAN
  • All with Coverage
  • All Regression
  • Disable CI Cache

Regression jobs to run:

  • Fast suites (mostly <1h)
  • Aggregate Functions (2h)
  • Alter (1.5h)
  • Benchmark (30m)
  • CAS (content-addressed storage; Antalya only)
  • ClickHouse Keeper (1h)
  • Iceberg (2h)
  • LDAP (1h)
  • OAuth (5m)
  • Parquet (1.5h)
  • RBAC (1.5h)
  • SSL Server (1h)
  • S3 (2h)
  • S3 Export (2h)
  • Swarms (30m)
  • Tiered Storage (2h)

ianton-ru and others added 3 commits September 10, 2026 13:51
Cover object_storage_cluster, optional remote initiator as a single entry point, and graceful drain with SYSTEM STOP SWARM MODE.

Co-authored-by: Cursor <cursoragent@cursor.com>
Drop the trailing "Antalya differences" heading so it is not read as the only Antalya change.

Co-authored-by: Cursor <cursoragent@cursor.com>
…y swarms.

Related: #2221
Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions

Copy link
Copy Markdown

Workflow [PR], commit [067bbbd]

@ianton-ru ianton-ru added antalya port-antalya PRs to be ported to all new Antalya releases antalya-26.6 labels Sep 10, 2026
@ianton-ru
ianton-ru marked this pull request as ready for review September 10, 2026 12:32
Comment thread docs/en/antalya/swarm.md
The initiator then sends a non-cluster function (`iceberg(...)` / `s3(...)`) to the remote
initiator. That node applies its own `object_storage_cluster` and fans the scan out internally.

If `object_storage_cluster` is also set on the initiator query, the rewritten query is a cluster

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

If object_storage_cluster is also set, this says the query is rewritten to icebergCluster(...).

#2221 sends plain iceberg(...) / s3(...) in that case and forwards object_storage_cluster as a setting, so the name is not fixed in a *Cluster call. Worth checking that this paragraph still matches once that change is in.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Yes, it will change when #2221 is merged. But it is not merged yet.

This branch has not been deployed

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

Labels

antalya antalya-26.6 port-antalya PRs to be ported to all new Antalya releases

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants