kapdap/taiga

Taiga 镜像文档

镜像概述和主要用途

Taiga是一个面向初创公司和敏捷开发者、设计师的项目管理平台，旨在提供简单、美观的工具，让工作变得真正愉悦。taiga.io

核心功能和特性

• 专为初创公司和敏捷团队设计的项目管理工具
• 简洁美观的用户界面，提升工作体验
• 支持项目协作、任务管理和敏捷开发流程
• 可通过环境变量灵活配置，支持自定义设置
• 兼容外部数据库、Redis、RabbitMQ等服务集成
• 可选启用HTTPS安全访问和SMTP邮件服务
• 支持数据持久化卷挂载，确保上传文件不丢失
• 集成LDAP和Slack功能

使用场景和适用范围

• 初创公司的项目管理与团队协作
• 敏捷开发团队的任务跟踪和进度管理
• 需要简单易用且美观界面的项目管理场景
• 希望通过Docker快速部署项目管理平台的用户

使用方法和配置说明

快速开始

推荐使用示例项目进行快速部署，提供基础配置文件便于修改和插件安装：

bash
git clone https://github.com/benhutchins/docker-taiga-example.git mytaiga && cd mytaiga
vi taiga-conf/local.py  # 配置taiga-back后端
vi taiga-conf/conf.json  # 配置taiga-front前端
vi docker-compose.yml  # 更新环境变量
docker-compose up

或直接运行容器：

bash
docker run -itd \
  --link taiga-postgres:postgres \
  -p 80:80 \
  -e TAIGA_HOSTNAME=taiga.mycompany.net \
  -v ./media:/usr/src/taiga-back/media \
  benhutchins/taiga

容器运行后，使用默认管理员账户登录：用户名 admin，密码 123123。

注意：若连接异常，请确保已正确配置 TAIGA_HOSTNAME，默认值 localhost 通常不满足实际使用需求。

额外配置选项

通过以下环境变量配置taiga-back的local.py文件：

• -e TAIGA_HOSTNAME=（必填，设置服务器主机名，如taiga.mycompany.com）
• -e TAIGA_SSL=True（启用HTTPS，详见"启用HTTPS"）
• -e TAIGA_SECRET_KEY（设置随机字符串作为安全密钥，默认使用不安全随机值）
• -e TAIGA_SKIP_DB_CHECK（跳过数据库自动初始化检查）
• -e TAIGA_ENABLE_EMAIL=True（启用邮件服务，详见"配置SMTP"）

注意：数据库相关变量为必需项，即使使用数据库容器也需配置，详见"配置数据库"。

配置数据库

使用Docker容器

先启动PostgreSQL容器：

bash
docker run --name taiga-postgres -e POSTGRES_PASSWORD=mypassword -d postgres

使用外部数据库服务器

需提供以下必填环境变量：

• -e TAIGA_DB_NAME=...（数据库名，默认postgres）
• -e TAIGA_DB_HOST=...（数据库主机，默认链接的postgres容器地址）
• -e TAIGA_DB_USER=...（数据库用户，默认postgres）
• -e TAIGA_DB_PASSWORD=...（数据库密码，默认链接容器的密码）

若指定数据库不存在，将自动创建并执行初始化脚本生成表结构和演示数据。

外部数据库示例：

bash
docker run \
  --name mytaiga \
  -e TAIGA_DB_HOST=10.0.0.1 \
  -e TAIGA_DB_USER=taiga \
  -e TAIGA_DB_PASSWORD=mypassword \
  -itd \
  benhutchins/taiga

Taiga Events配置

Taiga Events是可选组件，需依赖RabbitMQ和Redis，部署步骤：

bash
# 启动依赖服务
docker run --name taiga-redis -d redis:3
docker run --name taiga-rabbit -d --hostname taiga rabbitmq:3

# 启动celery worker
docker run --name taiga-celery -d --link taiga-rabbit:rabbit celery

# 启动taiga-events服务器
docker run --name taiga-events -d --link taiga-rabbit:rabbit benhutchins/taiga-events

运行Taiga容器时添加链接参数：

bash
--link taiga-rabbit:rabbit --link taiga-redis:redis --link taiga-events:events

启用HTTPS

添加以下参数启用HTTPS：

bash
-e TAIGA_SSL=True
-v $(pwd)/ssl.crt:/etc/nginx/ssl/ssl.crt:ro
-v $(pwd)/ssl.key:/etc/nginx/ssl/ssl.key:ro

或挂载证书目录：

bash
-e TAIGA_SSL=True
-v $(pwd)/ssl/:/etc/nginx/ssl/:ro

HTTPS反向代理

若通过反向代理处理HTTPS，设置：

bash
-e TAIGA_SSL_BY_REVERSE_PROXY=True

此时TAIGA_SSL被忽略，Taiga不处理HTTPS但所有链接使用HTTPS。

配置SMTP邮件服务

启用邮件服务需添加以下环境变量：

bash
-e TAIGA_ENABLE_EMAIL=True
-e TAIGA_EMAIL_FROM=no-reply@taiga.mycompany.net
-e TAIGA_EMAIL_USE_TLS=True  # 仅TLS连接时设置
-e TAIGA_EMAIL_HOST=smtp.google.com
-e TAIGA_EMAIL_PORT=587
-e TAIGA_EMAIL_USER=me@gmail.com
-e TAIGA_EMAIL_PASS=your-email-password

也可通过自定义local.py配置更多邮件参数，参考https://github.com/taigaio/taiga-back/blob/master/settings/local.py.example%E3%80%82

卷挂载

媒体文件存储路径：/usr/src/taiga-back/media，挂载本地目录确保数据持久化：

bash
-v /my/own/media:/usr/src/taiga-back/media

完整部署示例

不使用docker-compose的完整部署流程：

bash
# 启动依赖服务
docker run --name taiga-postgres -d -e POSTGRES_PASSWORD=password postgres
docker run --name taiga-redis -d redis:3
docker run --name taiga-rabbit -d --hostname taiga rabbitmq:3
docker run --name taiga-celery -d --link taiga-rabbit:rabbit celery
docker run --name taiga-events -d --link taiga-rabbit:rabbit benhutchins/taiga-events

# 启动Taiga
docker run -itd \
  --name taiga \
  --link taiga-postgres:postgres \
  --link taiga-redis:redis \
  --link taiga-rabbit:rabbit \
  --link taiga-events:events \
  -p 80:80 \
  -e TAIGA_HOSTNAME=$(docker-machine ip default) \
  -v ./media:/usr/src/taiga-back/media \
  benhutchins/taiga

更简便的方式是使用https://github.com/benhutchins/docker-taiga-example%EF%BC%8C%E7%9B%B4%E6%8E%A5%E6%89%A7%E8%A1%8C%60docker-compose up`。

使用Git仓库获取最新版本

bash
git clone https://github.com/benhutchins/docker-taiga.git && cd docker-taiga/
git submodule update --init --remote
docker-compose up -d  # 构建并启动本地Taiga服务