iggyrs/iggy

Iggy.rs消息流平台官方Docker镜像

镜像概述

本镜像为Iggy.rs消息流平台的官方Docker镜像，基于GitHub仓库https://github.com/iggy-rs/iggy%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%BE%BF%E6%8D%B7%E9%83%A8%E7%BD%B2%E5%92%8C%E8%BF%90%E8%A1%8CIggy.rs%E6%B6%88%E6%81%AF%E6%B5%81%E6%9C%8D%E5%8A%A1%E3%80%82Iggy.rs%E6%98%AF%E4%B8%80%E4%B8%AA%E9%AB%98%E6%80%A7%E8%83%BD%E6%B6%88%E6%81%AF%E6%B5%81%E5%B9%B3%E5%8F%B0%EF%BC%8C%E4%B8%93%E6%B3%A8%E4%BA%8E%E6%8F%90%E4%BE%9B%E5%8F%AF%E9%9D%A0%E3%80%81%E9%AB%98%E6%95%88%E7%9A%84%E5%AE%9E%E6%97%B6%E6%B6%88%E6%81%AF%E4%BC%A0%E9%80%92%E8%83%BD%E5%8A%9B%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%88%86%E5%B8%83%E5%BC%8F%E7%B3%BB%E7%BB%9F%E9%80%9A%E4%BF%A1%E5%92%8C%E5%AE%9E%E6%97%B6%E6%95%B0%E6%8D%AE%E5%A4%84%E7%90%86%E5%9C%BA%E6%99%AF%E3%80%82

核心功能与特性

• 官方维护：由Iggy.rs项目团队官方维护，确保与上游代码同步更新，提供稳定可靠的运行环境。
• 容器化部署：通过Docker容器化封装，简化安装配置流程，支持跨环境一致部署。
• 消息流核心能力：提供消息发布/订阅、队列等基础消息模式，支持消息持久化与高吞吐量传输（基于Iggy.rs平台核心功能）。

使用场景

• 分布式微服务架构中的跨服务异步通信。
• 实时数据流处理与分析系统（如日志收集、监控指标传输）。
• 事件驱动架构中的事件传递与处理。
• 需要可靠消息存储与转发的业务系统。

使用方法与配置说明

基本运行

通过以下命令启动Iggy.rs服务容器（默认端口需参考官方文档，此处以8080为例）：

bash
docker run -d --name iggy -p 8080:8080 iggyrs/iggy

数据持久化

为避免容器重启导致消息数据丢失，可挂载宿主机目录至容器数据存储路径（假设默认数据目录为/data）：

bash
docker run -d --name iggy -p 8080:8080 -v ./iggy-data:/data iggyrs/iggy

环境变量配置

通过环境变量调整服务参数（具体支持的变量请参考Iggy.rs官方文档），例如设置日志级别：

bash
docker run -d --name iggy -p 8080:8080 -e LOG_LEVEL=info iggyrs/iggy

Docker Compose部署

创建docker-compose.yml文件实现多容器协同或持久化配置：

yaml
version: '3.8'
services:
  iggy:
    image: iggyrs/iggy
    container_name: iggy
    ports:
      - "8080:8080"  # 根据实际服务端口调整
    volumes:
      - iggy-data:/data  # 持久化数据卷
    environment:
      - LOG_LEVEL=info  # 日志级别（如debug/info/warn/error）
    restart: unless-stopped

volumes:
  iggy-data:  # 命名卷用于持久化数据

启动服务：

bash
docker-compose up -d

注意事项

• 端口映射：需根据Iggy.rs服务实际监听端口调整-p参数（具体端口请参考Iggy.rs官方文档）。
• 高级配置：如需自定义配置文件，可通过-v挂载配置文件至容器内对应路径（如-v ./config.toml:/etc/iggy/config.toml）。
• 版本控制：建议通过镜像标签指定具体版本（如iggyrs/iggy:v0.1.0）以确保部署一致性。