前書き
MoinMoinは、Pythonで書かれた高性能のオープンソースWikiエンジンです。 それは、ユーザーの大規模なコミュニティを持ち、非常にカスタマイズ可能で使いやすい機能豊富なウィキを提供します。 MoinMoinは、Ubuntu、Apache、FreeBSDなど、いくつかの組織で公開ウィキに使用されています。
このチュートリアルでは、NginxをWebサーバーとして、uWSGIをアプリケーションエンジンとして使用して、新しいUbuntu 14.04サーバーで独自のMoinMoin wikiをセットアップする方法を示します。 この特定のセットアップは単一のWiki用であり、非常に高速でメモリ効率が高くなります。
前提条件
このガイドを開始する前に、サーバーに別の非ルートユーザーアカウントを設定する必要があります。 これを行う方法については、https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-14-04 [Ubuntu 14.04の初期サーバーセットアップ]の手順1〜4を完了することで学習できます。 。
このガイドでは、Ubuntu 14.04サーバーが最新であることを前提としています。
このチュートリアルでは、「+ vi 」を使用してファイルを開いて編集します。 別のエディターを使用する場合は、必要に応じて「 vi +」の代わりに使用してください。
始めましょう!
uWSGIをインストールする
はじめに、アプリケーションサーバーとして使用するuWSGIをインストールしましょう。
まず、次のコマンドでAptデータベースを更新します。
sudo apt-get update
uWSGIをインストールする簡単な方法は、Pythonパッケージマネージャー、 `+ pip +`を使用することです。 Python-pipとPythonライブラリを今すぐインストールします。
sudo apt-get install python-pip python-dev
pipをインストールしたら、それを使用して、次のコマンドでuWSGIの最新の安定したリリースをインストールできます。
sudo pip install http://projects.unbit.it/downloads/uwsgi-lts.tar.gz
uWSGIが正常にインストールされると、次のようなメッセージが表示されます。
############## end of uWSGI configuration #############
total build time: 36 seconds
*** uWSGI is ready, launch it with /usr/local/bin/uwsgi ***
Successfully installed uWSGI
Cleaning up...
uWSGIアプリケーションサーバーがインストールされたので、MoinMoinをダウンロードしてインストールする準備ができました。
Moinmoinをインストールする
MoinMoinをインストールする前に、インストールするバージョンをhttp://moinmo.in/MoinMoinDownload[MoinMoin Releases]で検索してください。 おそらく、最新の一般リリースを使用することになるでしょう。
MoinMoinの最新の一般リリースを見つけて、そのURLをクリップボードにコピーします。
画像:https://assets.digitalocean.com/articles/moin/download.png [MoinMoinダウンロード]
このチュートリアルを書いたときに利用可能な最新の一般リリースは1.9.8であったため、サンプルURLは1.9.8バージョンを参照しています。 この `+ wget +`コマンドを使用して、MoinMoinアーカイブをホームディレクトリにダウンロードします(コピーしたダウンロードURLを置き換えます)。
cd ~
wget
次に、tarを使用してアーカイブを抽出します。
tar zxvf moin-1.9.8.tar.gz
MoinMoinアーカイブを抽出して作成されたディレクトリに移動します。
cd moin-*
MoinMoin Pythonアプリケーションをビルドし、それを `+ / usr / local +`にコピーするには、次のコマンドを実行します:
sudo python setup.py install --prefix=/usr/local
Python 2.7を使用している場合、PythonスクリプトはMoinMoinコードパッケージを `+ / usr / local / lib // dist-packages / `にインストールし、残りのMoinMoinデータを ` / usr / local / share /にインストールしますmoin + `。
これで、MoinMoin Pythonアプリケーションがインストールされましたが、まだ構成されていません。 今すぐ設定しましょう。
MoinMoinアプリケーションを構成する
MoinMoinアプリケーションを実際に起動する前に、その構成ファイルを準備する必要があります。
インストールディレクトリに移動します。
cd /usr/local/share/moin
次に、サンプルサーバー設定ファイル `+ moin.wsgi +`を現在のディレクトリにコピーします。
sudo cp server/moin.wsgi .
サーバー構成ファイルを開いて編集します。
sudo vi moin.wsgi
`+ import sys、os +`行の下に、次の行を挿入します。
sys.path.insert(0, '/usr/local/lib/python2.7/dist-packages/')
sys.path.insert(0, '/usr/local/share/moin/')
保存して終了。 これにより、MoinMoinコードの場所とWiki構成ファイルが配置される場所を使用してアプリケーションが構成されます。
次に、 `+ uwsgi.ini +`を作成して開きます:
sudo vi uwsgi.ini
ファイルに次の行を挿入します。
[uwsgi]
uid = www-data
gid = www-data
socket = /usr/local/share/moin/moin.sock
chmod-socket = 660
logto = /var/log/uwsgi/uwsgi.log
chdir = /usr/local/share/moin/
wsgi-file = moin.wsgi
master
workers = 3
max-requests = 200
harakiri = 30
die-on-term
保存して終了。 `+ uwsgi.ini +`ファイルは、uWSGIアプリケーションサーバーでMoinMoinアプリケーションをロードするために使用されます。 ここでは、アプリケーションが使用するユーザー、ソケット、およびサーバーの構成とログファイルなどを指定しています。 ワーカーの数、最大リクエスト数、または許容セッション期間(harakiri)を自由に調整してください。
次に、 `+ / var / log / uwsgi +`ディレクトリを作成します。これは、ログを書き込むためにuWSGIアプリケーションを構成した場所です。
sudo mkdir -p /var/log/uwsgi
sudo chown www-data /var/log/uwsgi
次に、MoinMoinアプリケーションを起動するために使用されるinitctlスクリプトを作成しましょう。 このスクリプトは、サーバーの起動時にMoinMoinを有効にし、 `+ start moin `および ` stop moin +`でuWSGIアプリケーションを制御できるようにします。
次のコマンドで `+ moin.conf +`を作成して開きます:
sudo vi /etc/init/moin.conf
次の構成行を挿入します。
description "moin uwsgi service"
start on runlevel [2345]
stop on runlevel [!2345]
chdir /usr/local/share/moin
exec /usr/local/bin/uwsgi /usr/local/share/moin/uwsgi.ini
respawn
保存して終了。 `+ chdir `および ` exec `行のパスは、MoinMoinがインストールされた場所、および ` uwsgi `バイナリと ` uwsgi.ini +`ファイルが存在する場所を正確に反映することが重要です。
アプリケーションサーバーを今すぐ起動できます( + sudo start moin +
)が、最初にWikiの構成にいくつかの変更を加えます。
Wikiを構成する
uWSGIアプリケーションサーバーの準備ができたので、実際のWikiを構成します。
MoinMoinインストールディレクトリに移動し、サンプルの `+ wikiconfig.py +`ファイルをコピーします。
cd /usr/local/share/moin
sudo cp config/wikiconfig.py .
編集用にファイルを開きます。
sudo vi wikiconfig.py
ここでは、Wikiのさまざまな側面を構成できます。 少なくとも、次の項目を構成します。
-
+ sitename +
:ウィキのタイトル -
+ page_front_page +
:通常のフロントページを有効にするためにこの行のコメントを外します -
+ superuser +
:Wikiの管理者として使用するユーザーの名前。 このアイテムもコメント解除する必要があります
次の行を見つけ(必要に応じて、 `#`を削除してコメントを外します)、強調表示された値を好みに合わせて変更します。
sitename = u''
page_front_page = u"FrontPage"
superuser = [u"", ]
保存して終了。 これはPythonファイルであるため、既存のインデントは必ず保存してください。
アプリケーションを開始する前に、MoinMoinディレクトリの所有権と権限を変更しましょう。
sudo chown -R www-data: /usr/local/share/moin
sudo chmod -R o-rwx /usr/local/share/moin
次のコマンドでuWSGIアプリケーションサーバーを起動します。
sudo start moin
MoinMoinは現在実行中ですが、使用する前にWebサーバーであるconfigure Nginxをインストールする必要があります。
Nginxのインストールと構成
NginxをWebサーバーとして使用するので、今すぐインストールして構成しましょう。
aptでNginxをインストールします。
sudo apt-get install nginx
次に、 `+ sites-available `ディレクトリに移動し、Wiki用の新しいサーバーブロック構成ファイルを作成します。 私たちは ` moin +`を呼び出します:
cd /etc/nginx/sites-available
sudo vi moin
ファイルに次の行を挿入します(強調表示された部分を独自の情報に置き換えます)。
server {
server_name ;
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log;
location / {
include uwsgi_params;
uwsgi_pass unix:///usr/local/share/moin/moin.sock;
uwsgi_modifier1 30;
}
}
これは、最低限のNginx構成です。 サーバーに適していると思われる変更は自由に行ってください。
次に、 `+ sites-enabled +`ディレクトリに新しいサーバーブロック構成ファイルへのシンボリックリンクを作成します。
cd /etc/nginx/sites-enabled
sudo ln -s ../sites-available/moin .
そして、 `+ default +`サーバーブロックへのシンボリックリンクを削除します。
sudo rm default
これで、 `+ moin +`サーバーブロックがデフォルトになります。
Nginxを再起動して、新しい設定を読み込みます。
sudo service nginx restart
新しいWikiが稼働しています! サーバーのIPアドレスまたはホスト名で利用できます。
Wikiスーパーユーザーを作成する
Wikiを使用する前に最後に行うことは、スーパーユーザーアカウントの作成です。 このアカウントには、ブログに対する管理者権限があります。 このユーザーの名前は、このチュートリアルの* Wikiの設定*セクションの `+ wikiconfig.py `ファイルの ` superuser +`フィールドで設定したため、ここで同じ名前を使用していることを確認してください。
IPアドレスまたはホスト名を使用して、Webブラウザーでサーバーに接続します: + http:// +
次のフロントページが表示されます。
画像:https://assets.digitalocean.com/articles/moin/welcome.png [Frontpage]
ページの上部にある[ログイン]リンクをクリックします。
画像:https://assets.digitalocean.com/articles/moin/login.png [ログイン]
[ログイン]ページで、[今すぐ作成できます]リンクをクリックします。
image:https://assets.digitalocean.com/articles/moin/create.png [作成]
[アカウントの作成]ページで、スーパーユーザーの構成に一致する名前(例では「WikiAdmin」を使用)、パスワードおよびメールアドレスを入力し、[プロファイルの作成]ボタンをクリックします。
すべてうまくいった場合、次の成功メッセージが表示されます。
image:https://assets.digitalocean.com/articles/moin/created.png [ユーザー作成]
それでおしまい! これで、Wikiを使用する準備ができました。
結論
MoinMoin wikiを起動して実行したので、これを使用して共同作業を行う準備ができました。 コンテンツやユーザーを追加したり、構成やテーマを変更したりしてください。