automq README

The project's README from github.com/AutoMQ/automq. As one markdown file: README.md.

Diskless Kafka® on S3, Offering 10x Cost Savings and Scaling in Seconds.

📑  Documentation    🔥  Explore AutoMQ Playground Now   

Linkedin Badge Gurubase DeepWiki

AutoMQ%2Fautomq | Trendshift

automq-solgan
Grab LG U+ Tencent Honda JD
Bambu Lab miHoYo Hungry Studio FunPlus Avia Games

Prerequisites

Before running AutoMQ locally, please ensure:

[!Tip] Deploying a production-ready AutoMQ cluster is challenging. This Quick Start is only for evaluating AutoMQ features and is not suitable for production use. For production deployment best practices, please contact our community for support.

The docker/docker-compose.yaml file provides a simple single-node setup for quick evaluation and development:

curl -O https://raw.githubusercontent.com/AutoMQ/automq/refs/tags/1.5.5/docker/docker-compose.yaml && docker compose -f docker-compose.yaml up -d

This setup features a single AutoMQ node serving as both controller and broker, alongside MinIO for S3 storage. All services operate within a Docker bridge network called automq_net, allowing you to start a Kafka producer in this network to test AutoMQ:

docker run --network automq_net automqinc/automq:latest /bin/bash -c \
"/opt/automq/kafka/bin/kafka-producer-perf-test.sh --topic test-topic --num-records=1024000 --throughput 5120 --record-size 1024 \
--producer-props bootstrap.servers=server1:9092 linger.ms=100 batch.size=524288 buffer.memory=134217728 max.request.size=67108864"

After testing, you can destroy the setup with:

docker compose -f docker-compose.yaml down

The docker/docker-compose-cluster.yaml file offers a more complex setup with three AutoMQ nodes, ideal for testing AutoMQ's cluster features, and can be run in the same way.

There are more deployment options available:

🗞️ Newest Feature - Table Topic

Table Topic is a new feature in AutoMQ that combines stream and table functionalities to unify streaming and data analysis. Currently, it supports Apache Iceberg and integrates with catalog services such as AWS Glue, HMS, and the Rest catalog. Additionally, it natively supports S3 tables, a new AWS product announced at the 2024 re:Invent. Learn more.

image

🔶 Why AutoMQ

AutoMQ is a stateless Kafka alternative that runs on S3 or any S3-compatible storage, such as MinIO. It is designed to address two major issues of Apache Kafka. First, Kafka clusters are difficult to scale out or in due to the stateful nature of its brokers. Data movement is required, and even reassigning partitions between brokers is a complex process. Second, hosting Kafka in the cloud can be prohibitively expensive. You face high costs for EBS storage, cross-AZ traffic, and significant over-provisioning due to Kafka's limited scalability.

Here are some key highlights of AutoMQ that make it an ideal choice to replace your Apache Kafka cluster, whether in the cloud or on-premise, as long as you have S3-compatible storage:

✨Architecture

AutoMQ is a fork of the open-source Apache Kafka. We've introduced a new storage engine based on object storage, transforming the classic shared-nothing architecture into a shared storage architecture.

image

Regarding the architecture of AutoMQ, it is fundamentally different from Kafka. The core difference lies in the storage layer of Apache Kafka and how we leverage object storage to achieve a stateless broker architecture. AutoMQ consists of below key components:

For more on AutoMQ's architecture, visit AutoMQ Architecture or explore the source code directly.

🌟 Stay Ahead

Star AutoMQ on GitHub for instant updates on new releases. star-automq

💬 Community

You can join the following groups or channels to discuss or ask questions about AutoMQ:

👥 How to contribute

If you've found a problem with AutoMQ, please open a GitHub Issues. To contribute to AutoMQ please see Code of Conduct and Contributing Guide. We have a list of good first issues that help you to get started, gain experience, and get familiar with our contribution process.

👍 AutoMQ Enterprise Edition

The enterprise edition of AutoMQ offers a robust, user-friendly control plane for seamless cluster management, with enhanced availability and observability over the open-source version. Additionally, we offer Kafka Linking for zero-downtime migration from any Kafka-compatible cluster to AutoMQ.

Contact us for more information about the AutoMQ enterprise edition, and we'll gladly assist with your free trial.

📜 License

AutoMQ is under the Apache 2.0 license. See the LICENSE file for details.

📝 Trademarks

Apache®, Apache Kafka®, Kafka®, Apache Iceberg®, Iceberg® and associated open source project names are trademarks of the Apache Software Foundation

automq (AutoMQ/automq)

Searching Database…

10.9K ·GitHub
Что это такое?AutoMQ — это форк Apache Kafka без локальных дисков и без состояния, который хранит все данные журналов в S3 или в совместимом с S3 объектном хранилище вместо локальных дисков. Это снижает расходы на облако до 10 раз и убирает плату за трафик между зонами доступности.
Это совершенно новая система очередей сообщений или просто изменённый Kafka?Это форк открытого Apache Kafka, в котором уровень хранения заменён движком на основе S3. Поэтому он на 100% совместим по протоколу с существующими клиентами и инструментами Kafka.
Как попробовать AutoMQ локально?Запустите входящий в состав docker/docker-compose.yaml для одноузлового кластера с MinIO в качестве S3-хранилища или docker-compose-cluster.yaml для настройки из 3 узлов. Оба варианта запускаются обычными командами docker compose up и docker compose down.
Что нужно установить перед запуском?Docker 20.x или новее, Docker Compose v2, не менее 4 ГБ оперативной памяти, выделенной для Docker, и свободные порты 9092 и 9000.
Готов ли быстрый старт через Docker Compose к продакшену?Нет. Разработчики прямо заявляют, что этот быстрый старт предназначен только для оценки возможностей, а не для продакшена. Для реального развёртывания нужны их руководства по лучшим практикам для продакшена или поддержка сообщества либо корпоративная поддержка.
Что такое Table Topic?Table Topic позволяет темам AutoMQ работать также как таблицы Apache Iceberg, объединяя потоковую обработку и аналитику. Поддерживаются каталоги AWS Glue, HMS и REST, а также нативные таблицы S3.
Как он обходит плату за трафик между зонами доступности AWS?Маршрутизатор с учётом стоек (rack-aware) передаёт клиентам в каждой зоне доступности метаданные конкретных партиций. Благодаря этому они обмениваются данными через объектное хранилище, а не реплицируют их между зонами, а именно на такой трафик обычно приходится большая часть облачных расходов на Kafka.
Что именно изменено по сравнению с обычным Apache Kafka?AutoMQ заменяет хранение журналов на локальных дисках движком на основе S3 (S3Stream, WAL, LogCache/BlockCache) и добавляет встроенный Auto Balancer. Благодаря этому брокеры Kafka с состоянием и архитектурой shared-nothing превращаются в брокеры без состояния с общим хранилищем на S3.
Можно ли развернуть его в Kubernetes, а не только в Docker?Помимо быстрого старта через Docker Compose, в README есть ссылки на руководства по развёртыванию многоузлового кластера на обычном Linux, в Kubernetes или через пробные версии из AWS и Alibaba Cloud Marketplace.
Creator
AutoMQ
Size
170.6 MB
Stars
10.9K
Age
3y
Commits · 90 Days