Как установить MoinMoin с Nginx на Ubuntu 14.04

Вступление

MoinMoin - это высокопроизводительный вики-движок с открытым исходным кодом, написанный на Python. Он предоставляет многофункциональную вики, которая имеет большое сообщество пользователей, и очень настраиваема и проста в использовании. MoinMoin используется несколькими организациями для своих общедоступных вики, таких как Ubuntu, Apache, FreeBSD и другие.

В этом руководстве мы покажем вам, как настроить собственную вики MoinMoin на новом сервере Ubuntu 14.04, используя Nginx в качестве веб-сервера и uWSGI в качестве движка приложения. Эта конкретная настройка предназначена для одной вики, и она очень быстрая и эффективно использует память.

Предпосылки

Прежде чем вы начнете читать это руководство, у вас должна быть отдельная учетная запись без полномочий root, настроенная на вашем сервере. Вы можете узнать, как это сделать, выполнив шаги 1-4 в https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-14-04 настроить серверный сервер начальных ссылок для Ubuntu 14.04]. ,

В этом руководстве предполагается, что у вас есть свежий сервер 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 найдите версию, которую вы хотите установить, здесь: 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-*

Чтобы собрать приложение Python MoinMoin и скопировать его в + / usr / local +, выполните следующую команду:

sudo python setup.py install --prefix=/usr/local

Предполагая, что вы находитесь на Python 2.7, скрипт Python устанавливает пакет кода MoinMoin в + / usr / local / lib // dist-packages / +, а остальные данные MoinMoin в `+ / usr / local / share / МойнМойн + `.

Теперь приложение Python MoinMoin установлено, но еще не настроено. Давайте настроим это сейчас.

Настроить приложение 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 и местоположением, где будут находиться файлы конфигурации вики.

Затем создайте и откройте + 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 + будет использоваться для загрузки приложения MoinMoin с сервера приложений uWSGI. Здесь, среди прочего, мы указываем конфигурацию пользователя, сокета и сервера и файлы журналов, которые должно использовать приложение. Не стесняйтесь настраивать количество рабочих, максимальные запросы или приемлемую продолжительность сеанса (харакири).

Теперь создайте каталог + / var / log / uwsgi +, в котором мы настроили приложение uWSGI для записи его журналов в:

sudo mkdir -p /var/log/uwsgi
sudo chown www-data /var/log/uwsgi

Далее, давайте создадим скрипт initctl, который будет использоваться для запуска нашего приложения MoinMoin. Этот скрипт включит MoinMoin при загрузке сервера и позволит вам управлять приложением uWSGI с помощью + start moin + и + stop moin +.

Создайте и откройте + 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.

Настроить вики

Теперь, когда сервер приложений uWSGI готов, мы захотим настроить сам Wiki.

Перейдите в каталог установки MoinMoin и скопируйте пример файла + wikiconfig.py +:

cd /usr/local/share/moin
sudo cp config/wikiconfig.py .

Теперь откройте файл для редактирования:

sudo vi wikiconfig.py

Здесь мы можем настроить различные аспекты вики. Как минимум, мы хотим настроить следующие элементы:

+ sitename +: название вашей вики
+ page_front_page +: раскомментируйте эту строку, чтобы включить обычную первую страницу
+ superuser +: имя пользователя, которого вы хотите использовать в качестве администратора вики. Этот предмет также должен быть без комментариев

Найдите следующие строки (и, если необходимо, раскомментируйте их, удалив + # +) и измените выделенные значения по своему вкусу:

   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

МойнМойн сейчас запущен, но нам нужно установить веб-сервер Nginx, прежде чем вы сможете его использовать.

Установите и настройте Nginx

Мы будем использовать Nginx в качестве нашего веб-сервера, поэтому давайте установим и настроим его сейчас.

Установите Nginx с помощью apt:

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

Ваша новая вики запущена и работает! Он доступен по IP-адресу вашего сервера или имени хоста.

Создать вики суперпользователя

Последнее, что вам нужно сделать перед использованием вашей вики, это создать учетную запись Superuser. Эта учетная запись имеет права администратора для блога. Мы настроили имя этого пользователя в поле + superuser + в файле + wikiconfig.py + в разделе * Configure Wiki * этого руководства, поэтому убедитесь, что вы используете здесь то же имя.

Подключитесь к вашему серверу в веб-браузере, используя его IP-адрес или имя хоста: + http: // +

Вас встретит следующая полоса:

Изображение: HTTPS: //assets.digitalocean.com/articles/moin/welcome.png [Первый лист]

Нажмите на ссылку * Логин * в верхней части страницы.

Изображение: https: //assets.digitalocean.com/articles/moin/login.png [Войти]

На странице входа в систему нажмите на ссылку *, которую вы можете создать *.

Изображение: https: //assets.digitalocean.com/articles/moin/create.png [Создать]

На странице «Создание учетной записи» введите имя, соответствующее вашей конфигурации суперпользователя (в примере используется «WikiAdmin»), свой пароль и адрес электронной почты, затем нажмите кнопку * Создать профиль *.

Если все прошло хорошо, вы должны увидеть следующее сообщение об успехе:

изображение: https: //assets.digitalocean.com/articles/moin/created.png [Пользователь создан]

Это оно! Ваша вики готова к использованию.

Заключение

Теперь, когда у вас есть и работает ваша вики MoinMoin, вы готовы использовать ее для совместной работы! Не стесняйтесь добавлять контент и пользователей, или изменять его конфигурацию и темы.

TOC