Taiga Front Docker镜像文档

1. 镜像概述和主要用途

Taiga Front Docker镜像是Taiga项目管理平台的前端Web应用组件，基于现代Web技术构建，提供直观的用户界面，支持项目管理、任务跟踪、敏捷开发流程等核心功能。该镜像封装了Taiga前端应用的运行环境，简化部署流程，适用于快速搭建Taiga项目管理平台的前端服务。

2. 核心功能和特性

• 响应式用户界面：适配桌面和移动设备，支持多终端访问。
• 敏捷项目管理：提供看板视图、任务列表、用户故事地图等敏捷工具。
• 项目仪表盘：实时展示项目进度、任务完成情况、团队活动等数据。
• 任务与用户故事管理：支持任务创建、分配、状态跟踪，用户故事优先级排序。
• 多语言支持：内置多种语言包，可根据用户偏好切换界面语言。
• 可配置主题：支持自定义界面主题和品牌标识。
• 轻量级部署：基于Nginx或Node.js运行时，资源占用低，启动速度快。

3. 使用场景和适用范围

• 敏捷开发团队：用于跟踪迭代进度、管理用户故事和任务。
• 小型到中型项目：适合10-50人规模团队的协作管理。
• 跨部门协作：支持多角色权限控制，适配产品、开发、测试等不同团队角色。
• 快速原型部署：在演示或测试环境中快速搭建前端服务，配合Taiga Backend使用。

4. 使用方法和配置说明

4.1 前置条件

• 已安装Docker Engine（20.10+版本）或Docker Compose（2.0+版本）。
• 需配合Taiga Backend服务（提供API接口）和Taiga Events服务（可选，用于实时通知）使用。

4.2 基本部署（docker run）

docker run -d \
  --name taiga-front \
  -p 80:80 \
  -e TAIGA_URL=[***] \
  -e TAIGA_API_URL=[***] \
  -e TAIGA_EVENTS_URL=ws://taiga-events:8888/events \
  taigaio/taiga-front:latest

4.3 Docker Compose配置示例

创建docker-compose.yml文件，配合Taiga Backend服务：

version: '3.8'

services:
  taiga-front:
    image: taigaio/taiga-front:latest
    container_name: taiga-front
    restart: always
    ports:
      - "80:80"  # 前端HTTP端口
    environment:
      - TAIGA_URL=http://localhost  # 前端访问URL（用户浏览器访问地址）
      - TAIGA_API_URL=[***]  # 后端API服务地址
      - TAIGA_EVENTS_URL=ws://taiga-events:8888/events  # Events服务WebSocket地址
      - PORT=80  # 容器内服务端口（默认80）
    depends_on:
      - taiga-backend
    networks:
      - taiga-network

  taiga-backend:
    image: taigaio/taiga-backend:latest
    # 后端配置参考Taiga Backend文档
    environment:
      - DATABASE_URL=postgres://user:pass@db:5432/taiga
    networks:
      - taiga-network

networks:
  taiga-network:
    driver: bridge

4.4 环境变量配置

4.5 持久化配置（可选）

如需自定义配置文件（如conf.json），可通过挂载目录实现：

docker run -d \
  --name taiga-front \
  -p 80:80 \
  -v /path/to/custom/conf.json:/app/conf.json \
  taigaio/taiga-front:latest

自定义conf.json示例：

{
  "api": "[***]",
  "eventsUrl": "ws://taiga-events:8888/events",
  "publicRegisterEnabled": false,
  "defaultLanguage": "zh_CN"
}

5. 常见问题

5.1 前端无法连接后端API？

• 检查TAIGA_API_URL是否正确指向后端服务，确保后端服务已启动且网络可达。
• 确认后端CORS配置允许前端域名访问（参考Taiga Backend文档的CORS设置）。

5.2 界面语言不生效？

• 确保指定的LANG值对应语言包已包含在镜像中，或通过挂载自定义语言包到/app/locales目录。

5.3 端口冲突？

• 调整-p参数的主机端口映射，如-p 8080:80将主机8080端口映射到容器80端口。

6. 版本信息

• 镜像名称：taigaio/taiga-front
• 官方仓库：Docker Hub - taigaio/taiga-front
• 上游项目：Taiga Frontend GitHub