hazelcast/simulator repository overview

Hazelcast Simulator is a distributed testing framework designed to validate and benchmark Hazelcast deployments at scale. It enables engineers to simulate realistic production workloads, execute performance tests across cloud environments.

Key Capabilities:

• Distributed Test Execution: Orchestrate load generation across multiple client and member workers
• Cloud Infrastructure Automation: Provision and manage test environments on AWS using Terraform
• Comprehensive Benchmarking: Measure throughput, latency, scalability, and resource utilization
• Enterprise Testing Scenarios: Pre-built tests for Maps, Caches, SQL, CP Subsystem, and custom workloads

Docker Image Features:

• Pre-configured with Java 17, Python 3.11, Terraform, and AWS CLI
• Built-in CLI tools: perftest, inventory, iperf3test, perfregtest
• Mount local workspace for persistent test configurations and results

Quick Start:

# Create a new benchmark project
docker run --rm -it -v "$(pwd):/workspace" hazelcast/simulator:latest perftest create myproject --template hazelcast5-ec2

# Provision infrastructure (requires AWS credentials)
docker run --rm -it -v "$(pwd)/myproject:/workspace" -v ~/.aws:/root/.aws:ro hazelcast/simulator:latest inventory apply

# Run performance tests
docker run --rm -it -v "$(pwd)/myproject:/workspace" hazelcast/simulator:latest perftest run

This containerized solution eliminates local installation complexity while providing full access to Simulator's testing capabilities for Hazelcast clusters.