Skip to content

Document Tribes membership services - #1153

Merged
markt-asf merged 2 commits into
apache:mainfrom
sainadh777:docs/tribes-membership-guide
Nov 18, 2026
Merged

markt-asf merged 2 commits into
apache:mainfrom
sainadh777:docs/tribes-membership-guide

Conversation

@sainadh777

Copy link
Copy Markdown
Contributor

Rationale

webapps/docs/tribes/membership.xml was an empty placeholder tracked as TODO 75.4. Membership selection and operation currently require readers to piece together the configuration reference, implementation classes, and deployment-specific behavior.

Changes

  • document the roles and trade-offs of multicast, static, and cloud membership
  • add representative configuration examples and failure-detection guidance
  • describe membership events, network security expectations, and troubleshooting steps
  • remove the completed TODO and update the documentation totals

This is a documentation-only change; it does not alter runtime behavior.

Validation

Run in an isolated Linux container using Eclipse Temurin JDK 21.0.12, Apache Ant 1.10.12, and OpenSSL 3.0.2:

  • ant -Dexecute.validate=true validate — passed; Checkstyle 14.4.0 checked 8,251 files
  • ant clean build-docs — passed; XML validation and documentation rendering completed
  • ant clean deploy — passed; clean source build completed
  • ant -Dtest.openssl.path=/usr/bin/openssl clean test — passed in 124 minutes 32 seconds; 42,972 tests in 797 suites, 0 failures, 0 errors, 496 skipped
  • generated-distribution smoke test — bin/catalina.sh run, HTTP 200 from /docs/tribes/membership.html, bin/catalina.sh stop 20, server exit 0, and the endpoint was unavailable after shutdown

@sainadh777

Copy link
Copy Markdown
Contributor Author

@markt-asf and @rmaucher, could you review this membership guide when convenient? Mark’s recent Tribes documentation and review work and Rémy’s recent multicast, static, and cloud membership changes are directly relevant. Thanks.

@markt-asf markt-asf left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Need to discuss the static membership interceptor which can be used to add static members on top of whatever the membership service provides.

@sainadh777

sainadh777 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor Author

Addressed in 0f919f1. The guide now distinguishes StaticMembershipService from StaticMembershipInterceptor, explains that the interceptor adds configured members on top of any membership service, and includes a combined multicast/static example. It also documents TcpFailureDetector ordering, current dynamic-member de-duplication behavior, and TLS/trusted-network guidance consistent with the current cluster configuration and Tomcat security model. The branch is rebased onto current main; ant -Dexecute.validate=true validate and ant clean build-docs pass.

@sainadh777
sainadh777 force-pushed the docs/tribes-membership-guide branch from 56ce693 to 01b2735 Compare November 18, 2026 00:59
@sainadh777
sainadh777 force-pushed the docs/tribes-membership-guide branch from 01b2735 to 0f919f1 Compare November 18, 2026 01:01
@sainadh777

Copy link
Copy Markdown
Contributor Author

@markt-asf Thanks for the review. The requested StaticMembershipInterceptor discussion is now addressed in 0f919f1: the guide explains how it augments any configured membership service, includes a combined multicast/static example, documents TcpFailureDetector ordering and dynamic-member de-duplication, and aligns the security guidance with the current TLS configuration and Tomcat security model. The branch is rebased onto current main, is mergeable, and both validation and build-docs pass. Please take another look when convenient.

@markt-asf
markt-asf merged commit ed2a0fa into apache:main Nov 18, 2026
markt-asf pushed a commit that referenced this pull request Nov 18, 2026
* Document Tribes membership services

* Document combined static and dynamic membership
markt-asf pushed a commit that referenced this pull request Nov 18, 2026
* Document Tribes membership services

* Document combined static and dynamic membership
markt-asf pushed a commit that referenced this pull request Nov 18, 2026
* Document Tribes membership services

* Document combined static and dynamic membership
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