taiga 安装配置

---

1. 简介

本文档介绍了如何部署完整的 Taiga 服务（每个模块都是 Taiga 平台的一部分）。
Taiga 平台由三个主要组件组成，每个组件在编译时和运行时都有自己的依赖关系：

• taiga-back（backend / api）
• taiga-front-dist（前端）
• taiga-events（websockets 网关）（可选）

每个组件都可以在一台独特的机器上运行，或者所有组件都可以安装到不同的机器上。在本教程中，我们将在一台机器上安装所有内容，安装所有三个 Taiga 组件。这种类型的设置应该足以满足中小型生产环境。

2. 概述

本教程假设您使用的是干净的，最近更新的 Ubuntu 16.04 映像。
由于前端的性质，Taiga 通过域 / public-ip 使用，因为前端应用程序在您的浏览器中运行。前端必须能够与后端 / API 通信，因此前端和后端都必须可以通过域 / public-ip 访问。
Taiga 的安装必须由“常规”用户完成，而不是 root 用户。
在本教程中，我们假设以下细节：

• IP：80.88.23.45主机名:(example.com 指向 80.88.23.45）
• 用户名：taiga
• 系统 ram >=1GB（编译 lxml 所需）
• 工作目录 /home/taiga/（用户默认 taiga）

2.1 系统架构描述

这是一个简短的系统架构描述，可帮助您了解 Taiga 的构建和工作方式。在进一步安装之前，请务必阅读此说明以获得高级概述。

Taiga 由 2 个核心（mandatory）模块组成：

• taiga-back
• taiga-front

taiga-back用 django，python3 编写，并为前端提供 API 端点。

taiga-front主要用 angularjs 和 coffeescript 编写，取决于后端。

python 后端由 gunicorn（端口 9001）公开，它是一个 Python WSGI HTTP 服务器。进程管理器是 systemd，它一起运行 gunicorn 和 taiga-back。从技术上讲，后端与数据库（postgresql）通信，通过前端，它允许用户使用 Taiga 的功能。前端和后端之间的通信使用 API 完成。

然后后端由 nginx 公开暴露，nginx 充当这种情况的反向代理。前端位于 dist 文件夹中，并由 nginx 公开公开，nginx 充当此案例的静态 Web 服务器。

3 先决条件

Taiga 由三个模块组成，每个模块都需要不同的包和第三方包。本节将收集成功的 Taiga 安装和配置所需的软件包。在本节中，我们将为所有模块安装所有依赖项，包括可选模块和服务。

基本套餐

---

该组件 taiga-back 使用 postgresql（> = 9.4）作为数据库：
必须与几个第三方库一起安装 Python（3）和 virtualenvwrapper pip 升级到最新版本

sudo apt-get update
sudo apt-get install -y build-essential binutils-doc autoconf flex bison libjpeg-dev libfreetype6-dev zlib1g-dev libzmq3-dev libgdbm-dev libncurses5-dev automake libtool curl git tmux gettext nginx rabbitmq-server redis-server postgresql-9.5 postgresql-contrib-9.5 postgresql-doc-9.5 postgresql-server-dev-9.5 python3 python3-pip python3-dev virtualenvwrapper libxml2-dev libxslt-dev libssl-dev libffi-dev

在继续安装之前，必须执行此步骤！

创建一个名为的用户 taiga，并为其授予 root 权限

---

不要不更改为 root 用户。必须与 taiga 用户一起完成安装。

sudo adduser taiga
sudo adduser taiga sudo
sudo su taiga
cd ~

3.1 配置依赖项

使用初始用户和数据库配置 postgresql：

sudo -u postgres createuser taiga
sudo -u postgres createdb taiga -O taiga --encoding='utf-8' --locale=en_US.utf8 --template=template0

创建一个名为的用户 taiga，以及 RabbitMQ 的虚拟主机（taiga-events）

sudo rabbitmqctl add_user taiga PASSWORD_FOR_EVENTS
sudo rabbitmqctl add_vhost taiga
sudo rabbitmqctl set_permissions -p taiga taiga ".*" ".*" ".*"

4. 后端配置

本节有助于配置后端（api）Taiga 服务及其依赖项。

下载代码

cd ~
git clone https://github.com/taigaio/taiga-back.git taiga-back
cd taiga-back
git checkout stable

创建名为 taiga 的新 virtualenv

mkvirtualenv -p /usr/bin/python3 taiga

安装依赖项

pip install -r requirements.txt

使用初始基本数据填充数据库

python manage.py migrate --noinput
python manage.py loaddata initial_user
python manage.py loaddata initial_project_templates
python manage.py compilemessages
python manage.py collectstatic --noinput

这将创建管理员帐户。登录凭据为 admin，密码为 123123。

可选：如果您希望将一些示例数据加载到 Taiga 中，请执行以下命令，该命令使用示例项目和随机数据填充数据库（对于演示非常有用）：

python manage.py sample_data

将以下配置复制粘贴~/taiga-back/settings/local.py 并使用您自己的详细信息进行更新：

from .common import *

MEDIA_URL = "http://example.com/media/"STATIC_URL = "http://example.com/static/"SITES["front"]["scheme"] = "http"SITES["front"]["domain"] = "example.com"

SECRET_KEY = "theveryultratopsecretkey"

DEBUG = FalsePUBLIC_REGISTER_ENABLED = True

DEFAULT_FROM_EMAIL = "no-reply@example.com"SERVER_EMAIL = DEFAULT_FROM_EMAIL

#CELERY_ENABLED = True

EVENTS_PUSH_BACKEND = "taiga.events.backends.rabbitmq.EventsPushBackend"EVENTS_PUSH_BACKEND_OPTIONS = {"url": "amqp://taiga:PASSWORD_FOR_EVENTS@localhost:5672/taiga"}

# Uncomment and populate with proper connection parameters# for enable email sending. EMAIL_HOST_USER should end by @domain.tld#EMAIL_BACKEND = "django.core.mail.backends.smtp.EmailBackend"#EMAIL_USE_TLS = False#EMAIL_HOST = "localhost"#EMAIL_HOST_USER = ""#EMAIL_HOST_PASSWORD =""#EMAIL_PORT = 25

# Uncomment and populate with proper connection parameters# for enable github login/singin.#GITHUB_API_CLIENT_ID = "yourgithubclientid"#GITHUB_API_CLIENT_SECRET = "yourgithubclientsecret"

验证

（可选）要确保一切正常，请发出以下命令以在开发模式下运行后端以进行测试：

workon taiga
python manage.py runserver

然后，您必须能够在 URL 上看到表示端点列表的 json：http：// localhost：8000 / api / v1 /。

在此阶段，后端已成功安装，但要在生产中运行 python 后端，必须首先配置应用程序服务器。有关详细信息，请参阅本文档后面的内容。

5. 前端安装

从 Github 下载代码：

cd ~
git clone https://github.com/taigaio/taiga-front-dist.git taiga-front-dist
cd taiga-front-dist
git checkout stable

复制示例配置文件：

cp ~/taiga-front-dist/dist/conf.example.json ~/taiga-front-dist/dist/conf.json

按照以下模式编辑示例配置（替换为您自己的详细信息）：

{
        "api": "http://example.com/api/v1/",
        "eventsUrl": "ws://example.com/events",
        "debug": "true",
        "publicRegisterEnabled": true,
        "feedbackEnabled": true,
        "privacyPolicyUrl": null,
        "termsOfServiceUrl": null,
        "GDPRUrl": null,
        "maxUploadFileSize": null,
        "contribPlugins": []}

小心使用浏览器中的复制粘贴以避免 http:// 重复。

有taiga-front-dist，前 -dist 的下载和配置是不够的。下一步是在静态文件 Web 服务器下公开代码（在 dist 目录中）。在本教程中，我们使用 nginx 作为静态文件 Web 服务器和反向代理。稍后将解释 nginx 的配置。