MoinMoin è un motore wiki basato su filesystem open source scritto in Python. Al giorno d'oggi, MoinMoin è ampiamente utilizzato nella comunità open source. Molti fornitori, inclusi, a titolo esemplificativo, Apache, Ubuntu, Debian e Python, hanno installato i propri wiki con il motore wiki MoinMoin.
In questo tutorial imparerai come configurare un singolo sito wiki MoinMoin su un'istanza del server CentOS 7. Per servire MoinMoin, verranno installati anche Nginx e uWSGI.
Prerequisiti
Prima di poter mettere in funzione MoinMoin, è necessario configurare un server Web e Nginx è un'ottima scelta a tale scopo.
1) Per comodità, puoi installare Nginx usando il repository EPEL YUM:
sudo yum install nginx -y
2) Configura Nginx come segue in modo che possa funzionare con uWSGI e MoinMoin.
Utilizzare l' vieditor di testo per aprire il file di configurazione principale di Nginx /etc/nginx/nginx.conf:
sudo vi /etc/nginx/nginx.conf
All'interno del http { }segmento, trova il server { }segmento che è estratto di seguito:
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) Utilizzare l'indirizzo IP del server per definire un nome server per Nginx:
Trova la linea:
server_name _;
Sostituiscilo con:
server_name 203.0.113.1;
2.2) Configurare Nginx come usando il protocollo uWSGI per le comunicazioni:
Trova il location / { }segmento:
location / {
}
Inserisci due righe come di seguito:
location / {
uwsgi_pass unix:///run/moin/moin.sock;
include uwsgi_params;
}
Salva ed esci:
:wq!
3) Opzionalmente, è possibile testare la configurazione modificata con il seguente comando:
sudo nginx -t
Se nulla va storto, dovresti vedere l'output come di seguito:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
4) Infine, avvia il servizio Nginx e avvialo automaticamente all'avvio del sistema:
sudo systemctl start nginx.service
sudo systemctl enable nginx.service
1) Utilizzare i seguenti comandi per installare MoinMoin 1.9.9, l'ultima versione stabile di MoinMoin al momento in cui ho scritto questo articolo:
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
Dopo aver eseguito i comandi sopra, l'eseguibile MoinMoin e tutti i file della libreria verranno installati nella /opt/moindirectory e i dati utilizzati per creare il tuo singolo wiki MoinMoin verranno installati nella /srv/share/moindirectory.
2) Crea un file di configurazione chiamato moin.wsginella directory dei dati MoinMoin usando un file modello con lo stesso nome:
cd /srv/share/moin/
sudo cp server/moin.wsgi moin.wsgi
Apri il file di configurazione appena creato usando l' vieditor di testo:
sudo vi /srv/share/moin/moin.wsgi
Trova la seguente riga:
import sys, os
Aggiungi le seguenti due righe di seguito:
sys.path.insert(0, '/opt/moin/lib/python2.7/site-packages/')
sys.path.insert(0, '/srv/share/moin/')
Salva ed esci:
:wq!
3) Crea un altro file di configurazione wiki MoinMoin che verrà utilizzato per personalizzare il tuo wiki:
cd /srv/share/moin
sudo cp config/wikiconfig.py wikiconfig.py
Puoi configurare molte funzionalità per la tua wiki MoinMoin in questo file, ma per ora, devi solo impostare diverse funzionalità come di seguito.
Definire il nome del sito (supponiamo che sia My First Wiki):
sudo sed -i 's/Untitled Wiki/My First Wiki/' /srv/share/moin/wikiconfig.py
Definire un superutente (supponiamo che sia admin):
sudo sed -i '/#superuser/a\ superuser = [u\"admin\", ]' /srv/share/moin/wikiconfig.py
Nota: in seguito è comunque necessario registrare questo utente dall'interfaccia Web di MoinMoin.
Disabilita le ricerche DNS inverse per l'accelerazione:
sudo sed -i '$a\ log_reverse_dns_lookups = False' /srv/share/moin/wikiconfig.py
4) Modifica la proprietà dei file MoinMoin installati:
sudo chown -R nginx:nginx /srv/share/moin
sudo chown -R nginx:nginx /opt/moin
Agendo come hub tra il web server Nginx e un'applicazione Python, uWSGI è progettato per produrre le migliori prestazioni utilizzando il protocollo uWSGI ad alte prestazioni. Ora diamo un'occhiata a come installare e configurare uWSGI per eseguire MoinMoin.
1) Utilizzare pip per installare uWSGI come segue:
sudo yum install -y python-devel python-setuptools python-pip gcc
sudo pip install --upgrade pip
sudo pip install uwsgi
Se tutto va bene, dovresti vedere un output simile a:
...
Successfully installed uwsgi-2.0.15
2) Dopo aver installato uWSGI, è necessario creare una directory per archiviare i file di registro uWSGI:
sudo mkdir /var/log/uwsgi
sudo chown nginx:nginx /var/log/uwsgi
3) Inoltre, è necessario creare una directory per archiviare il file socket MoinMoin:
sudo mkdir /run/moin
sudo chown nginx:nginx /run/moin
4) Creare un file di configurazione uWSGI uwsgi.ininella directory dei dati della wiki di MoinMoin e popolarlo come segue:
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) Per utilizzare systemd per gestire uWSGI, è necessario impostare un file di unità systemd per 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) Avviare il servizio uWSGI e farlo avviare automaticamente all'avvio del sistema:
sudo systemctl start uwsgi.service
sudo systemctl enable uwsgi.service
Passaggio 4: consentire l'accesso al Web
Configura le regole del firewall come segue in modo che gli utenti possano visitare il tuo sito wiki MoinMoin utilizzando un browser Web:
sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --reload
Passaggio 5: accedi a MoinMoin da un browser web
Ora, un singolo sito wiki MoinMoin è stato installato e funzionante sull'istanza del server CentOS 7.
Punta il tuo browser web preferito su http://203.0.113.1e poi entrerai nell'interfaccia web di MoinMoin. Iscriviti e accedi come il superutente che adminabbiamo menzionato in precedenza, quindi sei in grado di gestire il tuo sito wiki come desideri.
Se necessario, è possibile effettuare ulteriori personalizzazioni modificando il /srv/share/moin/wikiconfig.pyfile.
Questo conclude il tutorial. Grazie per aver letto.