This is project is still WIP.
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
$ ./gradlew run
We rely on Kubernetes for creating docker containers for integration tests.
The easiest way to get started locally is by installing Minikube.
Start minikube with a command similar to the following. Use a netmask appropriate for your local network, and allow minikube to use as much RAM as you can afford to:
minikube start --insecure-registry "192.168.0.0/16" --addons registry --memory 8G --cpus=4
This will create a MiniKub cluster using the default driver. On OSX, this is hyperkit.
Enabling the tunnel is required in certain environments for tests to connect to the instances.
In a separate tab (or background process) run the following:
Check the dashboard to ensure your installation is working as expected:
Set the environment property for the Minikube container (we recommend you do this as part of your system profile):
You can use an existing Kubernetes environment by setting the appropriate project properties either through environment variables
export SIDECAR_DOCKER_REGISTRY="http://$(minikube ip):5000"
Gradle will register the required test containers with the local docker registry. You can enable this after setting up Minikube by doing the following:
Note: If using MiniKube, the Docker daemon will need to be configured to push to your Minikube repo insecurely.
This should be added to the
daemon.json config, usually found in /etc/docker, or in the Docker Engine section of the docker preferences:
"insecure-registries": [ "192.168.64.14:5000" ]
You can use
test to build & test the project.
Please see the developer documentation in docs/src/development.adoc for more information.
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.