rcronald/dynomite-manager

A sidecar to manage Dynomite clusters

Dynomite Manager

Dynomite-manager is a Java process/tool that can be used alongside Dynomite to manage a Dynomite cluster. Some of the features include:

• Discovery and Healthcheck
• Node Configuration and Token Management for multi-region deployments
• Dynomite/Redis cold bootstrap (warm up)
• Monitoring and Insights Integration
• Support multi-region Dynomite deployment via public IP.
• Automated security group update in multi-region environment.
• Object storage backups (AWS S3 implementation provided)
• REST API

Details about the features can be found in the Wiki

Workflow

The stable version of Dynomite Manager is the master branch.

For questions or contributions, please consider reading CONTRIBUTING.md.

Build

Dynomite Manager comes with a Gradle wrapper

./gradlew build

The gradlew script will pull down all necessary gradle components/infrastructure automatically, then run the build.

Dynomite Manager provides several default implementations (AWS, Configuration, credentials etc). You can use these or choose to create your own. Dynomite Manager is currently working on AWS and your local environment. We are open to contributions to support other platforms as well.

Howto

The first step before building Dynomite Manager is to configure the interfaces related to your environment in the InjectedWebListener. Checkout the Wiki for further explanation on what interfaces to bind based on your environment.

1. Build the dynomite-manager
2. Set up Auto-Scale Group (ASG) and spin up instances
3. Install Dynomite and web container (such as tomcat) on the instances.
4. Setup AWS credentials
5. Deploy dynomite-manager.war in your container

Run

Dynomite-manager changes the configuration files for Dynomite and data store (Redis) and starts/stops the services. Hence the web container must have execute rights on the script to modify the dynomite.yml and data store conf file (redis.conf).

Configuration

You can provide properties by using dynomite-manager{version}.jar in your web container and then implementing IConfiguration Interface. More details on the how the configuration can be found in the Wiki.

Help

Need some help with either getting up and going or some problems with the code?

• Submit an issue to repo
• Chat with us on

License

Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0