taigaio/taiga-events

taiga-events Docker 镜像

镜像概述

taiga-events 是 Taiga 项目管理平台的实时事件处理服务，基于 Socket.IO 实现，负责在 Taiga 系统中推送实时通知和事件更新，如任务状态变更、评论添加等，提升用户协作体验。

核心功能与特性

• 实时事件推送：通过 WebSocket 协议实现客户端与服务器的双向通信
• 事件订阅机制：支持客户端订阅特定项目或资源的事件通知
• 与 Taiga 主系统无缝集成：接收来自 Taiga API 的事件并转发给客户端
• 轻量级架构：资源占用低，性能高效
• 可水平扩展：支持多实例部署以处理高并发连接

使用场景

• Taiga 项目管理平台的实时通知系统部署
• 需要为 Taiga 添加实时协作功能的场景
• 企业内部项目管理系统的实时事件处理组件

部署与使用方法

基本使用 (Docker Run)

bash
docker run -d \
  --name taiga-events \
  -p 8888:8888 \
  -e RABBITMQ_URL=amqp://user:password@rabbitmq:5672/taiga \
  -e REDIS_URL=redis://redis:6379/0 \
  -e PORT=8888 \
  -e HOST=0.0.0.0 \
  taigaio/taiga-events:latest

Docker Compose 配置

yaml
version: '3'

services:
  taiga-events:
    image: taigaio/taiga-events:latest
    container_name: taiga-events
    restart: always
    ports:
      - "8888:8888"
    environment:
      - RABBITMQ_URL=amqp://user:password@rabbitmq:5672/taiga
      - REDIS_URL=redis://redis:6379/0
      - PORT=8888
      - HOST=0.0.0.0
      - DEBUG=false
    depends_on:
      - rabbitmq
      - redis

  rabbitmq:
    image: rabbitmq:3-management
    environment:
      - RABBITMQ_DEFAULT_USER=user
      - RABBITMQ_DEFAULT_PASS=password
      - RABBITMQ_DEFAULT_VHOST=taiga

  redis:
    image: redis:alpine

与 Taiga 集成配置

在 Taiga 前端配置文件 (conf.json) 中添加：

json
{
  "eventsUrl": "http://your-taiga-events-server:8888/events"
}

环境变量配置

持久化与数据管理

taiga-events 本身不存储持久数据，所有状态信息通过 Redis 和 RabbitMQ 维护，建议对这两个依赖服务进行数据持久化配置。

扩展与高可用性

对于高流量场景，可部署多个 taiga-events 实例，并结合负载均衡器使用：

yaml
# docker-compose.scale.yml 示例
version: '3'
services:
  taiga-events:
    deploy:
      replicas: 3
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf

故障排除

常见问题

1. 连接 RabbitMQ 失败

   • 检查 RABBITMQ_URL 配置是否正确
   • 确认 RabbitMQ 服务是否正常运行且网络可达

2. 客户端无法连接

   • 检查 HOST 和 PORT 配置是否正确
   • 确认防火墙规则允许相关端口访问
   • 检查前端 eventsUrl 配置是否指向正确的服务地址

3. 实时通知不工作

   • 检查 Taiga 后端是否正确配置了事件发送
   • 查看 taiga-events 日志确认是否接收到事件

相关链接

• Taiga 官方文档
• https://github.com/taigaio
• Socket.IO 文档