https://github.com/engapa/zookeeper-k8s-openshift
Zookeeper docker container, ready for deployments on kubernetes and openshift
https://github.com/engapa/zookeeper-k8s-openshift
apache-zookeeper docker docker-image k8s kubernetes openshift petsets statefulsets zookeeper
Last synced: 12 months ago
JSON representation
Zookeeper docker container, ready for deployments on kubernetes and openshift
- Host: GitHub
- URL: https://github.com/engapa/zookeeper-k8s-openshift
- Owner: engapa
- License: apache-2.0
- Created: 2017-02-03T10:06:11.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-04-21T09:11:03.000Z (about 5 years ago)
- Last Synced: 2024-04-14T19:21:21.210Z (about 2 years ago)
- Topics: apache-zookeeper, docker, docker-image, k8s, kubernetes, openshift, petsets, statefulsets, zookeeper
- Language: Shell
- Homepage: https://github.com/engapa/zookeeper-k8s-openshift
- Size: 169 KB
- Stars: 23
- Watchers: 3
- Forks: 28
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Zookeeper Docker Image
[](https://circleci.com/gh/engapa/zookeeper-k8s-openshift/tree/master)
[](https://hub.docker.com/r/engapa/zookeeper/)
[](https://microbadger.com/images/engapa/zookeeper)
This project aims to provide zookeeper docker images and prepare them to be deployed as 'statefulsets' on kubernetes (openshift).
These scripts are used to build/run the docker image/container:
* **zookeeper-env.sh**: Export needed env variable for other scripts.
* **zookeeper-download.sh**: is used to download the suitable release of zookeeper (version `ZOO_VERSION`).
* **zkBootstrap.sh**: Initializes zookeeper dynamically, based on [utils-docker project](https://github.com/engapa/utils-docker).
## Build and push the docker image
Set env variables DOCKER_ORG (defaults to `engapa`), DOCKER_IMAGE (defaults to `zookeeper`) and ZOO_VERSION (the real zookeeper version that will be downloaded into the docker image)
to tag docker image as you wish and then build, test and push:
```bash
$ make clean docker-build docker-test docker-push
```
## Run a container
Let's run a zookeeper container with default environment variables:
```bash
$ docker run -it --name zk engapa/zookeeper:${ZOO_VERSION}
```
## Setting up
Users may configure parameters in config files just adding environment variables with specific name patterns.
This table collects the patterns of variable names which will are written in the suitable file:
PREFIX | FILE (${ZOO_HOME}/config) | Example
-----------|-----------------------------|-----------------------------
ZK_ | zoo.cfg | ZK_maxClientCnxns=0 --> maxClientCnxns=0
LOG4J_ | log4j.properties | LOG4J_zookeeper_root_logger=INFO, CONSOLE--> zookeeper.root.logger=INFO, CONSOLE
JAVA_ZK_ | java.env | JAVA_ZK_JVMFLAG="-Xmx1G -Xms1G" --> JVMFLAG="-Xmx1G -Xms1G"
So we can configure our zookeeper server by adding environments variables:
```bash
$ docker run -it -d --name zk -e "SETUP_DEBUG=true" -e "LOG4J_zookeeper_root_logger=DEBUG, CONSOLE" engapa/zookeeper:${ZOO_VERSION}
```
> NOTE: We've passed a SETUP_DEBUG environment variable with value 'true' to view the setup process of config files.
> . Show logs by command `docker logs ZK`
Also you may use `--env-file` option to load these variables from a file.
And, of course, you could provide your own properties files directly through volumes by option `-v`, as you know.
## k8s
In [k8s directory](k8s) there are some resources for Kubernetes.
Thanks to kubernetes team for the [contrib](https://github.com/kubernetes/contrib/tree/master/statefulsets/zookeeper).
## Openshift
In [openshift directory](openshift) you can find some Openshift templates.
## Author
Enrique Garcia **engapa@gmail.com**