Jak nainstalovat MoinMoin na CentOS 7

MoinMoin je open source wiki engine založený na souborovém systému napsaný v Pythonu. V současné době je MoinMoin široce používán v komunitě open source. Mnoho dodavatelů, včetně, ale nejen, Apache, Ubuntu, Debian a Python, nastavilo své vlastní wiki s wiki enginem MoinMoin.

V tomto tutoriálu se naučíte, jak nastavit jednu wiki stránku MoinMoin na instanci serveru CentOS 7. Aby bylo možné obsluhovat MoinMoin, budou nainstalovány také Nginx a uWSGI.

Předpoklady

• Nová instance serveru Vultr CentOS 7 x64. Řekněme, že jeho IP adresa je 203.0.113.1.
• Uživatel sudo .
• Instance serveru byla aktualizována na nejnovější stabilní stav pomocí EPEL YUM repo .

Krok 1: Nainstalujte a nakonfigurujte Nginx

Než budete moci spustit MoinMoin, musíte pro něj nastavit webový server a Nginx je pro tento účel skvělou volbou.

1) Pro pohodlí můžete nainstalovat Nginx pomocí repozitáře EPEL YUM:

sudo yum install nginx -y

2) Nakonfigurujte Nginx následovně, aby mohl pracovat s uWSGI a MoinMoin.

Pomocí vitextového editoru otevřete hlavní konfigurační soubor Nginx /etc/nginx/nginx.conf:

sudo vi /etc/nginx/nginx.conf

V rámci http { }segmentu najděte server { }segment, jehož výňatek je níže:

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) Použijte IP adresu serveru k definování názvu serveru pro Nginx:

Najděte řádek:

server_name _;

Nahraďte jej:

server_name  203.0.113.1;

2.2) Nakonfigurujte Nginx tak, aby používal pro komunikaci protokol uWSGI:

Najděte location / { }segment:

location / {
}

Vložte dva řádky, jak je uvedeno níže:

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

Uložit a ukončit:

:wq!

3) Volitelně můžete otestovat upravenou konfiguraci pomocí následujícího příkazu:

sudo nginx -t

Pokud se nic nepokazí, měli byste vidět výstup takto:

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

4) Nakonec spusťte službu Nginx a nechte ji automaticky spouštět při spouštění systému:

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

Krok 2: Nainstalujte a nakonfigurujte MoinMoin

1) Pomocí následujících příkazů nainstalujte MoinMoin 1.9.9, nejnovější stabilní verzi MoinMoin v době, kdy jsem psal tento článek:

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

Po spuštění výše uvedených příkazů se do /opt/moinadresáře nainstaluje spustitelný soubor MoinMoin a všechny soubory knihovny a do adresáře se nainstalují data použitá pro vytvoření vaší vlastní jediné wiki MoinMoin /srv/share/moin.

2) Vytvořte konfigurační soubor s názvem moin.wsgiv datovém adresáři MoinMoin pomocí souboru šablony se stejným názvem:

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

Otevřete nově vytvořený konfigurační soubor pomocí vitextového editoru:

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

Najděte následující řádek:

import sys, os

Níže připojte následující dva řádky:

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

Uložit a ukončit:

:wq!

3) Vytvořte další konfigurační soubor MoinMoin wiki, který bude použit k přizpůsobení vaší vlastní wiki:

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

V tomto souboru můžete nakonfigurovat mnoho funkcí pro vaši wiki MoinMoin, ale prozatím stačí nastavit několik funkcí, jak je uvedeno níže.

Definujte název webu (řekněme, že je My First Wiki):

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

Definujte superuživatele (řekněme, že je admin):

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

Poznámka: Tohoto uživatele musíte později zaregistrovat z webového rozhraní MoinMoin.

Zakázat zpětné vyhledávání DNS pro zrychlení:

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

4) Změňte vlastnictví nainstalovaných souborů MoinMoin:

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

Krok 3: Nainstalujte a nakonfigurujte uWSGI

UWSGI, který funguje jako rozbočovač mezi webovým serverem Nginx a aplikací Python, je navržen tak, aby poskytoval nejlepší výkon pomocí vysoce výkonného protokolu uWSGI. Dále se podíváme na to, jak nainstalovat a nakonfigurovat uWSGI pro spuštění MoinMoin.

1) Použijte pip k instalaci uWSGI následovně:

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

Pokud vše půjde dobře, měli byste vidět výstup podobný tomuto:

...
Successfully installed uwsgi-2.0.15

2) Po instalaci uWSGI musíte vytvořit adresář pro ukládání souborů protokolu uWSGI:

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

3) Kromě toho musíte vytvořit adresář pro uložení souboru soketu MoinMoin:

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

4) Vytvořte konfigurační soubor uWSGI uwsgi.iniv datovém adresáři wiki MoinMoin a naplňte jej následovně:

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) Abyste mohli používat systemd ke správě uWSGI, musíte nastavit soubor systemd unit pro 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) Spusťte službu uWSGI a nechte ji automaticky spouštět při startu systému:

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

Krok 4: Povolte přístup na web

Nakonfigurujte pravidla brány firewall následovně, aby uživatelé mohli navštívit vaši wiki stránku MoinMoin pomocí webového prohlížeče:

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

Krok 5: Přístup k MoinMoin z webového prohlížeče

Nyní je na vaší instanci serveru CentOS 7 spuštěna jediná wiki stránka MoinMoin.

Nasměrujte svůj oblíbený webový prohlížeč na http://203.0.113.1a poté se dostanete do webového rozhraní MoinMoin. Zaregistrujte se a přihlaste se jako superuživatel, o kterém adminjsme se zmínili dříve, a poté budete moci spravovat svou wiki stránku, jak si přejete.

V případě potřeby můžete provést další přizpůsobení úpravou /srv/share/moin/wikiconfig.pysouboru.

Tím je tutoriál uzavřen. Děkuji za přečtení.