benhutchins/taiga

Taiga Docker镜像

镜像概述和主要用途

Taiga是一个面向初创公司和敏捷开发者、设计师的项目管理平台，旨在提供简单、美观的工具，让工作变得真正愉悦。本Docker镜像提供了便捷的部署方式，无需复杂的环境配置，可快速搭建Taiga项目管理系统。

核心功能和特性

• 简洁直观的界面：专为敏捷开发流程设计，提供清晰的项目管理视图
• 灵活的配置选项：通过环境变量自定义系统设置，满足不同场景需求
• 数据库兼容性：支持连接Docker容器内或外部PostgreSQL数据库
• 扩展功能支持：可集成Taiga Events增强实时协作能力
• 安全保障：支持HTTPS加密和反向代理配置
• 邮件通知集成：可配置SMTP服务器发送系统通知
• 数据持久化：通过卷挂载确保上传文件和数据不丢失

使用场景和适用范围

• 初创公司需要轻量级项目管理工具
• 敏捷开发团队进行任务跟踪和项目管理
• 设计团队协作管理设计项目和任务分配
• 快速部署开发或测试环境中的Taiga实例
• 需要简化基础设施配置的小型团队

使用方法和配置说明

通过示例项目快速启动

推荐使用官方示例项目快速配置，包含预定义配置文件和启动脚本：

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（关键参数）：

• TAIGA_HOSTNAME（必填）：服务器主机名，如taiga.mycompany.com
• TAIGA_SSL：是否启用HTTPS，设为True启用
• TAIGA_SECRET_KEY：后端安全密钥，默认使用不安全随机字符串，建议自定义
• TAIGA_SKIP_DB_CHECK：跳过数据库自动初始化检查
• TAIGA_ENABLE_EMAIL：启用邮件功能，设为True

数据库配置

Taiga依赖PostgreSQL数据库，支持两种配置方式：

使用Docker数据库容器

先启动PostgreSQL容器：

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

使用外部数据库服务器

需配置以下必填环境变量：

• TAIGA_DB_NAME：数据库名称（默认postgres）
• TAIGA_DB_HOST：数据库主机地址
• TAIGA_DB_USER：数据库用户名（默认postgres）
• 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是可选增强组件，提供实时协作功能，需先启动相关服务：

bash
# 启动Redis和RabbitMQ
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将被忽略，但所有链接使用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-password

数据卷挂载

上传文件默认存储在/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

使用Git仓库获取最新版本

克隆仓库并更新子模块以获取最新版本：

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