Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stargate/docker-images
https://github.com/stargate/docker-images
cassandra docker graphql rest
Last synced: 5 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/stargate/docker-images
- Owner: stargate
- License: apache-2.0
- Created: 2020-09-08T17:07:28.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-07-10T19:43:40.000Z (4 months ago)
- Last Synced: 2024-07-11T22:23:24.417Z (4 months ago)
- Topics: cassandra, docker, graphql, rest
- Language: Dockerfile
- Homepage: https://stargate.io
- Size: 207 KB
- Stars: 16
- Watchers: 8
- Forks: 14
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# docker-images
Docker images for Stargate v1.
Note:
For Stargate v2, Docker images are built in the [main repository](https://github.com/stargate/stargate), with examples under the [docker-compose directory](https://github.com/stargate/stargate/tree/main/docker-compose).
Warning: Both the Stargate v1 release series and support for Cassandra 3.11 are considered deprecated. Stargate v1 will be unsupported as of the v3 release, which will not include support for Cassandra 3.11: [details](https://github.com/stargate/stargate/discussions/2242).
## docker compose
[Examples directory](./examples) contains some [docker compose](https://docs.docker.com/compose/) files for stargate with different backends (3 nodes):
- [with Apache Cassandra 3.11](./examples/cassandra-3.11/docker-compose.yml)
- [with Apache Cassandra 4.0](./examples/cassandra-4.0/docker-compose.yml)
- [with DSE 6.8](./examples/dse-6.8/docker-compose.yml)
- [add Apache Zeppelin to any environment](./examples/add_zeppelin)
- [with Apache Cassanda 3.11, Prometheus, and Grafana](./examples/stargate-prometheus-grafana/docker-compose.yml)
- [with Apache Cassanda 3.11 and Keycloak, for JWT-based authentication ](./examples/stargate-jwt-auth)
Each example also has a `start_***.sh` to aid starting the docker-compose environment.
### Configuration
Correct settings in the `environment` section are essential for successful Stargate confirguration.
```
environment:
# cluster name must match backend cluster name
# version must match backend version, e.g. 3.11 / 4.0
- CLUSTER_NAME=backend
- CLUSTER_VERSION=3.11
# at least one seed node
- SEED=backend-1
# rack and datacenter names must match backend rack name,
# please notice that Apache Cassandra defaults differs from DSE defaults
- RACK_NAME=rack1
- DATACENTER_NAME=dc1
```
### Starting
Backend (C* or DSE) will not start immediately after container is up.
This can lead to some potential issue with backend not being ready during stargate start.
```
docker-compose --file up
```
Safe order of running is to run backend seed nodes first and then continue with stargate / rest of backend nodes
```
docker-compose --file --detach up backend-1 -d
sleep 60
docker-compose --file --detach up stargate backend-2 -d
sleep 60
docker-compose --file --detach up backend-3 -d
```
Same approach should be used when starting multiple Stargate nodes.
For more precise checks `sleep` can be replaced by checking if native protocol clients port (default 9042) is open e.g. using approach proposed in [this guide](https://docs.docker.com/compose/startup-order/).