Apache ZooKeeper

Ansible role for installing and configuring Apache ZooKeeper on RHEL / CentOS 7.

This role can be used to install and cluster multiple ZooKeeper nodes, this uses all hosts defined for the "zookeeper-nodes" group in the inventory file by default. All servers are added to the zoo.cfg file along with the leader and election ports.

Requirements

Platform: RHEL / CentOS 7

Role Variables

zookeeper_mirror: "http://archive.apache.org/dist/zookeeper"
zookeeper_version: 3.4.14
zookeeper_group: zookeeper
zookeeper_user: zookeeper
zookeeper_root_dir: /usr/share
zookeeper_install_dir: '{{ zookeeper_root_dir }}/zookeeper-{{ zookeeper_version }}'
zookeeper_dir: '{{ zookeeper_root_dir }}/zookeeper'
zookeeper_log_dir: /var/log/zookeeper
zookeeper_data_dir: /var/lib/zookeeper/data
zookeeper_data_log_dir: /var/lib/zookeeper/log
zookeeper_client_port: 2181
zookeeper_id: 1
zookeeper_leader_port: 2888
zookeeper_election_port: 3888
zookeeper_servers: "{{groups['zookeeper-nodes']}}"
zookeeper_environment: {}

Default Ports

Port	Description
2181	Client connection port
2888	Quorum port for clustering
3888	Leader election port for clustering

Default Directories and Files

Description	Directory / File
Installation directory	`/usr/share/zookeeper-<version>`
Symlink to install directory	`/usr/share/zookeeper`
Symlink to configuration	`/etc/zookeeper/zoo.cfg`
Log files	`/var/log/zookeeper`
Data directory for snapshots and myid file	`/var/lib/zookeeper/data`
Data directory for transaction log files	`/var/lib/zookeeper/log`
Systemd service	`/usr/lib/systemd/system/zookeeper.service`
System Defaults	`/etc/default/zookeeper`

Starting and Stopping ZooKeeper services

The ZooKeeper service can be started via: systemctl start zookeeper
The ZooKeeper service can be stopped via: systemctl stop zookeeper

Dependencies

No dependencies

Example Playbook

---
- hosts: zookeeper-nodes
  roles:
  - role: clay_wangzhi.zookeeper
    zookeeper_version: 3.4.14
    zookeeper_mirror: "https://mirrors.tuna.tsinghua.edu.cn/apache/zookeeper"
    zookeeper_servers: "{{groups['zookeeper-nodes']}}"
    zookeeper_environment:
      "JAVA_HOME": "/opt/jdk1.8.0_144"

example for ansible host.yml

 zookeeper-nodes:
      hosts:
        192.168.167.57:
          zookeeper_id: 1
        192.168.167.238:
          zookeeper_id: 2
        192.168.167.67:
          zookeeper_id: 3

License

MIT

clay-wangzhi/ansible-role-zookeeper