Taiga Docker镜像文档 (由Elestio验证和打包)

Taiga 是一款免费开源的项目管理工具，专为跨职能敏捷团队设计，旨在提升团队协作效率。

!Taiga界面

如果需要自动化备份、带SSL终止的反向代理、防火墙、操作系统与软件自动更新，以及由Linux专家和开源爱好者组成的团队确保服务安全稳定运行，可在elest.io上部署完全托管的Taiga服务。

镜像概述与主要用途

Elestio提供的Taiga镜像是基于官方源码验证和打包的Docker镜像，旨在简化Taiga项目管理工具的部署与维护。该镜像适用于需要快速搭建项目管理平台的敏捷团队，支持任务跟踪、敏捷看板、团队协作等核心功能，帮助团队高效管理项目进度与资源。

核心功能与特性

Elestio镜像优势

• 与官方同步更新：Elestio通过自动化流程与官方源码保持同步，及时发布新版本镜像。
• 及时获取修复与功能：提供对最新错误修复和功能的快速访问。
• 质量控制保障：团队执行质量控制检查，确保发布的产品符合高标准。

使用场景与适用范围

适用于需要协作管理项目的跨职能敏捷团队，包括但不限于：

• 软件开发团队的迭代任务管理
• 产品团队的需求跟踪与优先级排序
• 小型至中型团队的项目进度可视化与协作

使用方法与配置说明

环境准备

1. 克隆代码仓库

通过以下命令克隆部署配置文件：

git clone [***]
cd taiga

2. 配置环境变量

复制测试环境的示例配置文件并修改为自定义值：

cp ./tests/.env ./.env

编辑.env文件，设置关键参数（如数据库密码、域名、SMTP信息等）。

3. 创建数据目录并设置权限

mkdir -p ./data 
chown -R 1001:1001 ./data

4. 启动服务

使用Docker Compose启动整个服务栈：

docker-compose up -d

服务启动后，可通过 [***] 访问Web界面。

Docker Compose配置示例

以下是完整的docker-compose.yml配置文件，包含所有必要服务组件：

version: "3.5"

x-environment:
    &default-back-environment
        # 数据库设置
        POSTGRES_DB: taiga
        POSTGRES_USER: taiga
        POSTGRES_PASSWORD: ${APP_PASSWORD}
        POSTGRES_HOST: taiga-db
        # Taiga核心设置
        TAIGA_SECRET_KEY: ${APP_PASSWORD}
        TAIGA_SITES_SCHEME: "https"
        TAIGA_SITES_DOMAIN: ${DOMAIN}
        TAIGA_SUBPATH: "" # 为空或填写"/子路径"
        # 邮件设置（取消注释并配置SMTP服务器）
        EMAIL_BACKEND: "django.core.mail.backends.smtp.EmailBackend"
        DEFAULT_FROM_EMAIL: ${SMTP_FROM_EMAIL}
        EMAIL_USE_TLS: "False"
        EMAIL_USE_SSL: "False"
        EMAIL_HOST: ${SMTP_HOST}
        EMAIL_PORT: ${SMTP_PORT}
        EMAIL_HOST_USER: ""
        EMAIL_HOST_PASSWORD: ""
        # RabbitMQ设置（需与taiga-events-rabbitmq和taiga-async-rabbitmq保持一致）
        RABBITMQ_USER: taiga
        RABBITMQ_PASS: ${APP_PASSWORD}
        # 遥测与注册设置
        PUBLIC_REGISTER_ENABLED: "True"
        ENABLE_TELEMETRY: "True"
        TAIGA_TELEMETRY_REFERER: "elest.io"

x-volumes:
    &default-back-volumes
        - ./taiga-static-data:/taiga-back/static
        - ./taiga-media-data:/taiga-back/media
        # - ./config.py:/taiga-back/settings/config.py # 自定义配置文件（可选）

services:
    taiga-db:
        image: postgres:12.3
        environment:
            POSTGRES_DB: taiga
            POSTGRES_USER: taiga
            POSTGRES_PASSWORD: ${APP_PASSWORD}
        volumes:
            - ./taiga-db-data:/var/lib/postgresql/data
        networks:
            - taiga

    taiga-back:
        image: taigaio/taiga-back:${SOFTWARE_VERSION_TAG}
        environment: *default-back-environment
        volumes: *default-back-volumes
        networks:
            - taiga
        depends_on:
            - taiga-db
            - taiga-events-rabbitmq
            - taiga-async-rabbitmq

    taiga-async:
        image: taigaio/taiga-back:${SOFTWARE_VERSION_TAG}
        entrypoint: ["/taiga-back/docker/async_entrypoint.sh"]
        environment: *default-back-environment
        volumes: *default-back-volumes
        networks:
            - taiga
        depends_on:
            - taiga-db
            - taiga-back
            - taiga-async-rabbitmq

    taiga-async-rabbitmq:
        image: rabbitmq:3.8-management-alpine
        environment:
            RABBITMQ_ERLANG_COOKIE: secret-erlang-cookie
            RABBITMQ_DEFAULT_USER: taiga
            RABBITMQ_DEFAULT_PASS: ${APP_PASSWORD}
            RABBITMQ_DEFAULT_VHOST: taiga
        volumes:
            - ./taiga-async-rabbitmq-data:/var/lib/rabbitmq
        networks:
            - taiga

    taiga-front:
        image: taigaio/taiga-front:${SOFTWARE_VERSION_TAG}
        environment:
            TAIGA_URL: ${BASE_URL}
            TAIGA_WEBSOCKETS_URL: "wss://${DOMAIN}"
            TAIGA_SUBPATH: "" # 为空或填写"/子路径"
            PUBLIC_REGISTER_ENABLED: "true"
        networks:
            - taiga
        # volumes:
        #   - ./conf.json:/usr/share/nginx/html/conf.json # 自定义前端配置（可选）

    taiga-events:
        image: taigaio/taiga-events:${SOFTWARE_VERSION_TAG}
        environment:
            RABBITMQ_USER: taiga
            RABBITMQ_PASS: ${APP_PASSWORD}
            TAIGA_SECRET_KEY: ${APP_PASSWORD}
        networks:
            - taiga
        depends_on:
            - taiga-events-rabbitmq

    taiga-events-rabbitmq:
        image: rabbitmq:3.8-management-alpine
        environment:
            RABBITMQ_ERLANG_COOKIE: secret-erlang-cookie
            RABBITMQ_DEFAULT_USER: taiga
            RABBITMQ_DEFAULT_PASS: ${APP_PASSWORD}
            RABBITMQ_DEFAULT_VHOST: taiga
        volumes:
            - ./taiga-events-rabbitmq-data:/var/lib/rabbitmq
        networks:
            - taiga

    taiga-protected:
        image: taigaio/taiga-protected:${SOFTWARE_VERSION_TAG}
        environment:
            MAX_AGE: 360
            SECRET_KEY: ${APP_PASSWORD}
        networks:
            - taiga

    taiga-gateway:
        image: nginx:1.19-alpine
        ports:
            - "172.17.0.1:9000:80"
        volumes:
            - ./taiga-gateway/taiga.conf:/etc/nginx/conf.d/default.conf
            - ./taiga-static-data:/taiga/static
            - ./taiga-media-data:/taiga/media
        networks:
            - taiga
        depends_on:
            - taiga-front
            - taiga-back
            - taiga-events

networks:
    taiga:

关键配置参数说明

维护

日志查看

Taiga容器日志输出到stdout，可通过以下命令查看：

docker-compose logs -f

停止服务栈：

docker-compose down

备份与恢复

通过文件夹卷挂载简化备份与恢复操作：

创建备份（ZIP归档）

在docker-compose.yml所在目录执行：

zip -r myarchive.zip .

从备份恢复

将归档文件解压到原始目录：

unzip myarchive.zip -d /path/to/original/folder

启动服务

恢复完成后启动服务栈：

docker-compose up -d

相关链接

• Taiga官方GitHub仓库
• Taiga官方文档
• Elestio Taiga部署配置GitHub仓库