tealtools / puls

The simplest way to run a local multi-cluster multi-broker Apache Pulsar instance πŸš€

Home Page:https://pulsar.apache.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

puls

puls is a CLI tool that allows you to run a local Pulsar instance with different configurations.

The motivation is to minimize the entry threshold for Pulsar novices and quickly try different Puslar features without spending much time.

▢️ Watch the video

Install

MacOS using Homebrew

brew tap tealtools/tap
brew install tealtools/tap/puls

Linux

TODO

Build from source

  • Clone the repository git clone git@github.com:tealtools/puls.git && cd ./puls
  • Install Rust or alternatively install Nix and run make dev at the repository root to enter dev shell with all pre-installed tools.
  • Rust cargo install --path .
  • Check the installation puls --version

Usage

puls start

Requirements

  • Installed Docker >= 2.24.0
  • Enough computing resources. For Docker Desktop, you can adjust available resources by following these instructions.

You can take the following numbers as a basis:

  • A cluster with 1 broker and 1 bookie needs 1 CPU core and 1GB RAM.
  • A cluster with 3 brokers and 3 bookies needs 1.5-2 CPU cores and 3GB RAM.

For example, you'll need about 3-4CPU cores and 6GB RAM for the following Pulsar instance with two clusters:

puls create --num-clusters 2 --num-bookies 3 --num-brokers 3 multi-cluster

Planned features

About

The simplest way to run a local multi-cluster multi-broker Apache Pulsar instance πŸš€

https://pulsar.apache.org

License:Apache License 2.0


Languages

Language:Rust 95.8%Language:Nix 3.8%Language:Makefile 0.4%