Skip to content

Distributed Rate Limiter v1.0.0

Choose a tag to compare

View all tags
@uppnrise uppnrise released this 18 Sep 20:05
· 168 commits to main since this release
v1.0.0
92c816f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Distributed Rate Limiter v1.0.0 - Release Notes

🎉 First Production Release - September 18, 2025

What's New

Core Features

  • ✅ Distributed Token Bucket Algorithm - Fair rate limiting with burst support
  • ✅ Redis Backend - Centralized state for multi-instance deployments
  • ✅ RESTful API - 18 endpoints for rate limiting, configuration, and monitoring
  • ✅ Flexible Configuration - Per-key, pattern-based, and default rate limits
  • ✅ Security Features - API key authentication and IP filtering
  • ✅ Comprehensive Monitoring - Built-in metrics and health checks

Performance Characteristics

  • High Throughput: 50,000+ requests/second
  • Low Latency: P95 < 2ms, P99 < 5ms
  • Memory Efficient: ~100MB for 1M active rate limit buckets
  • CPU Optimized: <5% overhead under normal load

Deployment Options

  • JAR File: Self-contained Spring Boot application (42MB)
  • Docker Image: Container-ready with optimized layers
  • Docker Compose: Complete stack with Redis
  • Kubernetes: Production-ready manifests

Documentation & Examples

  • Complete API Reference - OpenAPI/Swagger documentation
  • Integration Examples - Java, Python, Node.js, Go clients
  • Deployment Guides - Docker, Kubernetes, traditional deployment
  • Configuration Guide - Detailed configuration options

Download & Installation

JAR File (Recommended)

# Download and run
wget https://github.com/uppnrise/distributed-rate-limiter/releases/download/v1.0.0/distributed-rate-limiter-1.0.0.jar
java -jar distributed-rate-limiter-1.0.0.jar

Docker

docker run -p 8080:8080 ghcr.io/uppnrise/distributed-rate-limiter:1.0.0

Quick Start Scripts

  • quick-start.sh - JAR quick start with dependency checks
  • docker-quick-start.sh - Docker Compose setup
  • INSTALLATION.md - Complete installation guide

Requirements

  • Java 21+ (OpenJDK or Oracle JDK)
  • Redis server (local or remote)
  • 2GB RAM minimum for production usage

File Checksums

  • SHA256: See distributed-rate-limiter-1.0.0.jar.sha256
  • MD5: See distributed-rate-limiter-1.0.0.jar.md5

Breaking Changes

None - this is the first release.

Upgrade Notes

None - this is the first release.

Known Issues

None at release time.

What's Next (v1.1.0)

  • Enhanced monitoring dashboard
  • Advanced rate limiting algorithms
  • Improved performance metrics
  • Additional client libraries

Support

  • 📖 Documentation: Complete guides included
  • 🐛 Issues: GitHub Issues for bug reports
  • 💡 Feature Requests: GitHub Discussions
  • 🤝 Contributing: See CONTRIBUTING.md in repository
Assets 9
Loading