commit | 91f31399042a444c2ccfc55d28d64bfe36a72a74 | [log] [tgz] |
---|---|---|
author | Doug Rohrer <doug@therohrers.org> | Thu Oct 19 21:10:18 2023 -0400 |
committer | Francisco Guerrero <frankgh@apache.org> | Tue Dec 05 09:13:28 2023 -0800 |
tree | 04118adee918a0580ded716df1762084312eb394 | |
parent | ad936f6482aee2a05fa45ba4fdd06267958298f6 [diff] |
CASSANDRASC-79: Sidecar should be able to load metadata even if the local instance is unavailable - Add SidecarLoadBalancingPolicy to connect to additional nodes beyond local - Enable Gossip by default (the client really needs it on) - Retry keyspace creation if it fails - Use shared executor/hashedwheeltimer netty options for all tests. This restores the previous behavior from when the NettyOptions parameter was first added, although we're not sure exactly why it's helpful, or if it is at all. - Also store test results as artifacts - Fix multi-threaded access issues with synchronized for now. Also fix an issue where the host couldn't be found if it wasn't using 9042 for the port. - Prevent spurious reconnects of ignored nodes on onUp events - Use `QueryOptions#setReprepareOnUp(false)` to prevent an onUp event from reconnecting to a node we don't want a connection with. - Integration test for the load balancing polilcy + Adds fixes for issues found while testing. - Use `ClusterUtils.awaitRingStatus` for retries when waiting for a node to shut down Patch by Doug Rohrer; Reviewed by Francisco Guerrero, Yifan Cai for CASSANDRASC-79
This is a Sidecar for the highly scalable Apache Cassandra database. For more information, see the Apache Cassandra web site and CIP-1.
This is project is still WIP.
We depend on the Cassandra in-jvm dtest framework for testing. Because these jars are not published, you must manually build the dtest jars before you can build the project.
./scripts/build-dtest-jars.sh
The build script supports two parameters:
REPO
- the Cassandra git repository to use for the source files. This is helpful if you need to test with a fork of the Cassandra codebase.git@github.com:apache/cassandra.git
BRANCHES
- a space-delimited list of branches to build. -default: "cassandra-4.1 trunk"
Remove any versions you may not want to test with. We recommend at least the latest (released) 4.X series and trunk
. See Testing for more details on how to choose which Cassandra versions to use while testing.
For multi-node in-jvm dtests, network aliases will need to be setup for each Cassandra node. The tests assume each node's ip address is 127.0.0.x, where x is the node id.
For example if you populated your cluster with 3 nodes, create interfaces for 127.0.0.2 and 127.0.0.3 (the first node of course uses 127.0.0.1).
To get up and running, create a temporary alias for every node except the first:
for i in {2..20}; do sudo ifconfig lo0 alias "127.0.0.${i}"; done
After you clone the git repo, you can use the gradle wrapper to build and run the project. Make sure you have Apache Cassandra running on the host & port specified in conf/sidecar.yaml
.
$ ./gradlew run
While setting up cassandra instance, make sure the data directories of cassandra are in the path stored in sidecar.yaml file, else modify data directories path to point to the correct directories for stream APIs to work.
The test framework is set up to run 4.1 and 5.1 (Trunk) tests (see TestVersionSupplier.java
) by default. You can change this via the Java property cassandra.sidecar.versions_to_test
by supplying a comma-delimited string. For example, -Dcassandra.sidecar.versions_to_test=4.0,4.1,5.1
.
You will need to use the “Add Projects” function of CircleCI to set up CircleCI on your fork. When promoted to create a branch, do not replace the CircleCI config, choose the option to do it manually. CircleCI will pick up the in project configuration.
We warmly welcome and appreciate contributions from the community. Please see CONTRIBUTING.md if you wish to submit pull requests.