The SCIMMA Server Container provides a development version of the SCIMMA server infrastructure which includes:
1. A Kafka server.
2. A Zookeeper installation used by the Kafka server
3. SCIMMA server processes that consume and produce Kafka messages.
Spin up a Kafka server listening on localhost:9092, with auth and config files accessible in /tmp/shared:
docker pull scimma/server:latest
docker run -p 9092:9092 -it --rm -v /tmp/shared:/root/shared --hostname localhost scimma/server
- VirtualBox (Mac Only)
- Build tools: GNU Make, curl, git (only if building the containers)
- Working docker installation
Documentation for basic use cases:
The SCIMMA Server Container is most definitely NOT an example of best practice kafka infrastructure implementation. These containers are not intended for production use.
The containers are published on https://dockerhub.com:
* https://hub.docker.com/r/scimma/server
* https://hub.docker.com/r/scimma/client
and can be pulled with the commands:
docker pull scimma/server
docker pull scimma/client
Without building, you can use the containers on dockerhub.com using the docker-compose.yml file in this repository or direct docker commands.
make
Pushing to hub.docker.com is handled via a github workflow. To push a container based on the current master branch to AWS ECR with version MAJOR.MINOR.RELEASE (e.g., "0.0.7") do:
git tag version-MAJOR.MINOR.RELEASE
git push origin version-MAJOR.MINOR.RELEASE
We have tested the containers using several combinations of operating systems and docker installations here are some notes about running the demo in various environments:
The plan is, as server and client code is written, to add the client code to the scimma client container and the server code to the scimma server container.