taiga インストール構成

1. はじめに

このドキュメントでは、完全な Taiga サービスをデプロイする方法を紹介します。 (各モジュールは Taiga プラットフォームの一部です)。
Taiga プラットフォームは 3 つの主要コンポーネントで構成されており、それぞれコンパイル時および実行時に独自の依存関係があります:

taiga-back(backend/api )
taiga-front-dist(フロントエンド)
taiga-events(websocket ゲートウェイ)(オプション)

それぞれコンポーネントは固有のマシン上で実行することも、すべてのコンポーネントを別のマシンにインストールすることもできます。このチュートリアルでは、すべてを 1 台のマシンにインストールし、3 つの Taiga コンポーネントをすべてインストールします。このタイプのセットアップは、小規模から中規模の運用環境には十分です。

2. 概要

このチュートリアルでは、最近更新されたクリーンな Ubuntu 16.04 イメージを使用していることを前提としています。
フロントエンドの性質上、フロントエンドアプリケーションがブラウザーで実行されるとき、Taiga はドメイン/パブリック IP 経由で使用されます。フロントエンドはバックエンド/API と通信できる必要があるため、フロントエンドとバックエンドの両方にドメイン/パブリック 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 つのコア (必須) モジュールで構成されています:

taiga-back
taiga-front

taiga-backdjango、python3 で書かれており、フロントエンドに API エンドポイントを提供します。

taiga-front 主に angularjs と Coffeescript で書かれていますが、バックエンドに依存します。

Python バックエンドは、Python WSGI HTTP サーバーである gunicorn (ポート 9001) によって公開されます。プロセスマネージャーは systemd であり、gunicorn と taiga-back を一緒に実行します。技術的には、バックエンドはデータベース (postgresql) と通信し、フロントエンドを通じてユーザーが Taiga の機能を使用できるようにします。フロントエンドとバックエンド間の通信はAPIを使用して行われます。

バックエンドは nginx によって公開され、この場合はリバースプロキシとして機能します。フロントエンドは dist フォルダーにあり、この場合静的 Web サーバーとして機能する nginx によって公開されます。

3 前提条件

Taiga は 3 つのモジュールで構成されており、それぞれに異なるパッケージとサードパーティパッケージが必要です。このセクションでは、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という名前の新しい仮想環境を作成します

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 にロードする場合は、次のコマンドを実行します。これにより、データベースにサンプルプロジェクトとランダムデータが設定されます (デモンストレーションに非常に便利です)。次の設定を ~/taiga-back/settings/local.py に貼り付け、独自の詳細で更新します:

python manage.py sample_data

ログイン後にコピー

Verify

(オプション) すべてが適切に動作していることを確認するには、次の手順を実行してください。次のコマンドを発行して、テストのために開発モードでバックエンドを実行します:

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"

ログイン後にコピー

これにより、URL: http://localhost:8000/api/v1 でエンドポイントのリストを表す JSON を確認できるようになります。 / 。

在此阶段，后端已成功安装，但要在生产中运行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": []}

ログイン後にコピー