Як встановити MoinMoin на CentOS 7

MoinMoin — це вікі-движок з відкритим вихідним кодом на основі файлової системи, написаний на Python. Нині MoinMoin широко використовується у спільноті з відкритим кодом. Багато постачальників, включаючи, але не обмежуючись ними, Apache, Ubuntu, Debian і Python, налаштували власні вікі за допомогою вікі-движка MoinMoin.

У цьому підручнику ви дізнаєтеся, як налаштувати один вікі-сайт MoinMoin на екземплярі сервера CentOS 7. Для обслуговування MoinMoin також будуть встановлені Nginx та uWSGI.

Передумови

• Свіжий екземпляр сервера Vultr CentOS 7 x64. Скажімо, його IP-адреса 203.0.113.1.
• Користувач sudo .
• Екземпляр сервера оновлено до останнього стабільного стану за допомогою репозиторії EPEL YUM .

Крок 1: Встановіть та налаштуйте Nginx

Перш ніж ви зможете запустити MoinMoin, вам потрібно налаштувати для нього веб-сервер, і Nginx — чудовий вибір для цієї мети.

1) Для зручності ви можете встановити Nginx за допомогою репозиторії EPEL YUM:

sudo yum install nginx -y

2) Налаштуйте Nginx таким чином, щоб він міг працювати з uWSGI та MoinMoin.

Використовуйте viтекстовий редактор, щоб відкрити основний конфігураційний файл Nginx /etc/nginx/nginx.conf:

sudo vi /etc/nginx/nginx.conf

У http { }сегменті знайдіть server { }сегмент, який наведено нижче:

http {

...

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;
    root         /usr/share/nginx/html;

    # Load configuration files for the default server block.
    include /etc/nginx/default.d/*.conf;

    location / {
    }

...

2.1) Використовуйте IP-адресу сервера, щоб визначити ім'я сервера для Nginx:

Знайдіть рядок:

server_name _;

Замініть його на:

server_name  203.0.113.1;

2.2) Налаштуйте Nginx як використання протоколу uWSGI для зв'язку:

Знайдіть location / { }відрізок:

location / {
}

Вставте два рядки, як показано нижче:

location / {
    uwsgi_pass unix:///run/moin/moin.sock;
    include uwsgi_params;
}

Збережіть і вийдіть:

:wq!

3) За бажанням, ви можете перевірити змінену конфігурацію за допомогою такої команди:

sudo nginx -t

Якщо нічого не піде не так, ви повинні побачити результат, як показано нижче:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

4) Нарешті, запустіть службу Nginx і змусьте її автоматично запускатися під час завантаження системи:

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

Крок 2: Встановіть та налаштуйте MoinMoin

1) Використовуйте такі команди, щоб інсталювати MoinMoin 1.9.9, останню стабільну версію MoinMoin на момент написання цієї статті:

cd
wget http://static.moinmo.in/files/moin-1.9.9.tar.gz
tar -zxvf moin-1.9.9.tar.gz
cd moin-1.9.9
sudo python setup.py install --force --record=install.log --prefix='/opt/moin' --install-data=/srv

Після виконання команд вище, виконуваний файл MoinMoin і всі файли бібліотеки будуть встановлені в /opt/moinкаталозі, а дані, використані для створення вашої власної єдиної вікі MoinMoin, будуть встановлені в /srv/share/moinкаталозі.

2) Створіть файл конфігурації з іменем moin.wsgiу каталозі даних MoinMoin, використовуючи файл шаблону з такою ж назвою:

cd /srv/share/moin/
sudo cp server/moin.wsgi moin.wsgi

Відкрийте щойно створений файл конфігурації за допомогою viтекстового редактора:

sudo vi /srv/share/moin/moin.wsgi

Знайдіть такий рядок:

import sys, os

Додайте наступні два рядки нижче:

sys.path.insert(0, '/opt/moin/lib/python2.7/site-packages/')
sys.path.insert(0, '/srv/share/moin/')

Збережіть і вийдіть:

:wq!

3) Створіть інший файл конфігурації вікі MoinMoin, який використовуватиметься для налаштування вашої власної вікі:

cd /srv/share/moin
sudo cp config/wikiconfig.py wikiconfig.py

Ви можете налаштувати багато функцій для своєї вікі MoinMoin у цьому файлі, але наразі вам просто потрібно налаштувати кілька функцій, як показано нижче.

Визначте назву сайту (скажімо, що це так My First Wiki):

sudo sed -i 's/Untitled Wiki/My First Wiki/' /srv/share/moin/wikiconfig.py

Визначте суперкористувача (скажімо, що це так admin):

sudo sed -i '/#superuser/a\    superuser = [u\"admin\", ]' /srv/share/moin/wikiconfig.py

Примітка: вам все одно потрібно зареєструвати цього користувача у веб-інтерфейсі MoinMoin пізніше.

Вимкніть зворотний пошук DNS для прискорення:

sudo sed -i '$a\    log_reverse_dns_lookups = False' /srv/share/moin/wikiconfig.py

4) Змініть право власності на встановлені файли MoinMoin:

sudo chown -R nginx:nginx /srv/share/moin
sudo chown -R nginx:nginx /opt/moin

Крок 3: Встановіть та налаштуйте uWSGI

Виступаючи як центр між веб-сервером Nginx і програмою Python, uWSGI розроблений для досягнення найкращої продуктивності за допомогою високопродуктивного протоколу uWSGI. Далі давайте подивимося, як встановити та налаштувати uWSGI для запуску MoinMoin.

1) Використовуйте pip, щоб встановити uWSGI наступним чином:

sudo yum install -y python-devel python-setuptools python-pip gcc
sudo pip install --upgrade pip
sudo pip install uwsgi

Якщо все пройшло добре, ви повинні побачити результат, подібний до:

...
Successfully installed uwsgi-2.0.15

2) Після встановлення uWSGI вам потрібно створити каталог для зберігання файлів журналів uWSGI:

sudo mkdir /var/log/uwsgi
sudo chown nginx:nginx /var/log/uwsgi

3) Крім того, вам потрібно створити каталог для зберігання файлу сокета MoinMoin:

sudo mkdir /run/moin
sudo chown nginx:nginx /run/moin

4) Створіть файл конфігурації uWSGI uwsgi.iniу каталозі даних вікі MoinMoin і заповніть його таким чином:

cat <<EOF | sudo tee -a /srv/share/moin/uwsgi.ini
[uwsgi]
uid = nginx
gid = nginx
socket = /run/moin/moin.sock
chmod-socket = 660
logto = /var/log/uwsgi/uwsgi.log

chdir = /srv/share/moin
wsgi-file = /srv/share/moin/moin.wsgi

master = true
processes = 3
max-requests = 200
harakiri = 30
vacuum = true
enable-threads = true
EOF

5) Щоб використовувати systemd для керування uWSGI, вам потрібно налаштувати файл модуля systemd для uWSGI:

cat <<EOF | sudo tee -a /etc/systemd/system/uwsgi.service
[Unit]
Description=uWSGI instance to serve MoinMoin
After=syslog.target

[Service]
ExecStart=/usr/bin/uwsgi --ini /srv/share/moin/uwsgi.ini
RuntimeDirectory=uwsgi
Restart=always
KillSignal=SIGQUIT
Type=notify
StandardError=syslog
NotifyAccess=all

[Install]
WantedBy=multi-user.target
EOF

6) Запустіть службу uWSGI і змусьте її автоматично запускатися під час завантаження системи:

sudo systemctl start uwsgi.service
sudo systemctl enable uwsgi.service

Крок 4. Надайте доступ до Інтернету

Налаштуйте правила брандмауера таким чином, щоб користувачі могли відвідувати ваш вікі-сайт MoinMoin за допомогою веб-переглядача:

sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --reload

Крок 5. Отримайте доступ до MoinMoin з веб-браузера

Тепер на вашому екземплярі сервера CentOS 7 запущено і працює єдиний вікі-сайт MoinMoin.

Наведіть свій улюблений веб-браузер на http://203.0.113.1, і тоді ви потрапите у веб-інтерфейс MoinMoin. Зареєструйтеся та увійдіть як суперкористувач, про який adminми згадували раніше, і тоді ви зможете керувати своїм вікі-сайтом за своїм бажанням.

Якщо необхідно, ви можете зробити додаткові налаштування, відредагувавши /srv/share/moin/wikiconfig.pyфайл.

На цьому підручник завершується. Дякую, що прочитали.