Docker 部署单节点测试集群

本文档介绍如何在本地开发环境中部署一个单节点的 AutoMQ 集群（通过部署 MinIO 提供对象存储服务），用户可在该开发环境中体验消息收发等基本功能。

tip

单节点的部署方案仅适用于测试和学习场景，不建议在生产环境中使用。

除了单节点部署方案，用户可参考以下文档体验其他部署方案，用于验证集群相关的功能特性：

• Docker 部署多节点测试集群▸

• Kubernetes 部署多节点集群▸

• Linux 主机部署多节点集群▸

面向生产环境负载的 AutoMQ 部署和参数调优相对复杂，您可以通过此处表单联系 AutoMQ 团队获取必要的协助和最佳实践。

此外，如果您期望完全避免安装部署的工作负担，可以通过以下链接体验 AutoMQ 团队提供的全托管云服务，当前各云市场均提供了免费 2 周的试用体验。

• 从 AWS Marketplace 免费体验 AutoMQ Cloud。

• 从阿里云云市场体验 AutoMQ Cloud。

前置条件

• Linux/Mac/Windows Subsystem for Linux

• Docker

• Docker Compose 版本 > 2.22.0

• 8GB 以上空闲内存

安装并启动单节点 AutoMQ 集群

输入下方命令即可下载单节点部署方案的 docker-compose 配置文件，并通过 Docker Compose 启动单节点的 AutoMQ 集群。

curl -O https://raw.githubusercontent.com/AutoMQ/automq/refs/heads/main/docker/docker-compose.yaml && docker-compose up -d

启动成功后，将在名为 automq_net 的 docker 网络下暴露集群地址，集群的 bootstrap 地址为“server1:9092 ”，后续可以通过该地址连接集群。

tip

注意：

上述测试环境中 AutoMQ 使用名为 automq_net 的 docker 网络，如需连接该集群，需要配置 *--network automq_net *选项，使用相同的 docker 网络连接集群。

测试消息收发

在安装启动 AutoMQ 集群后，可以通过运行以下命令，测试消息发送、消费等功能。

1. 运行以下命令，通过在 docker 环境运行 Kafka CLI 命令 kafka-topics.sh 创建 Topic。

docker run --network automq_net automqinc/automq:latest /bin/bash -c "/opt/kafka/kafka/bin/kafka-topics.sh --create --topic quickstart-events --bootstrap-server server1:9092"

2. 运行以下命令，通过在 docker 环境运行 Kafka CLI 命令 kafka-console-producer.sh 发送测试消息。

docker run -it --network automq_net automqinc/automq:latest /bin/bash -c "/opt/kafka/kafka/bin/kafka-console-producer.sh --topic quickstart-events --bootstrap-server server1:9092"

3. 运行以下命令，通过在 docker 环境运行 Kafka CLI 命令 kafka-console-consumer.sh 消费测试消息。

docker run --network automq_net automqinc/automq:latest /bin/bash -c "/opt/kafka/kafka/bin/kafka-console-consumer.sh --topic quickstart-events --from-beginning --bootstrap-server server1:9092"

停止并卸载单节点 AutoMQ 集群

完成功能测试后，请运行以下命令以停止和卸载当前 AutoMQ 集群。

curl -O https://raw.githubusercontent.com/AutoMQ/automq/refs/heads/main/docker/docker-compose.yaml && docker-compose down -v