Sådan installeres MoinMoin på CentOS 7

MoinMoin er en open source, filsystembaseret wiki-motor skrevet i Python. I dag er MoinMoin meget brugt i open source-fællesskaber. Mange leverandører, inklusive, men ikke begrænset til, Apache, Ubuntu, Debian og Python, har opsat deres egne wikier med MoinMoin wiki-motoren.

I denne vejledning lærer du, hvordan du opsætter et enkelt MoinMoin-wiki-websted på en CentOS 7-serverinstans. For at betjene MoinMoin vil Nginx og uWSGI også blive installeret.

Forudsætninger

• En frisk Vultr CentOS 7 x64-serverinstans. Sig, at dens IP-adresse er 203.0.113.1.
• En sudo-bruger .
• Serverforekomsten er blevet opdateret til den seneste stabile status ved hjælp af EPEL YUM-repoen .

Trin 1: Installer og konfigurer Nginx

Før du kan få MoinMoin op at køre, skal du konfigurere en webserver til det, og Nginx er et godt valg til det formål.

1) For nemheds skyld kan du installere Nginx ved hjælp af EPEL YUM repo:

sudo yum install nginx -y

2) Konfigurer Nginx som følger, så det kan fungere med uWSGI og MoinMoin.

Brug viteksteditoren til at åbne Nginx-hovedkonfigurationsfilen /etc/nginx/nginx.conf:

sudo vi /etc/nginx/nginx.conf

Indenfor http { }segmentet skal du finde server { }segmentet, som er uddraget nedenfor:

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) Brug serverens IP-adresse til at definere et servernavn for Nginx:

Find linjen:

server_name _;

Erstat den med:

server_name  203.0.113.1;

2.2) Konfigurer Nginx til at bruge uWSGI-protokollen til kommunikation:

Find location / { }segmentet:

location / {
}

Indsæt to linjer som nedenfor:

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

Gem og luk:

:wq!

3) Du kan eventuelt teste den ændrede konfiguration med følgende kommando:

sudo nginx -t

Hvis intet går galt, bør du se output som nedenfor:

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

4) Start endelig Nginx-tjenesten og få den til at starte automatisk ved systemopstart:

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

Trin 2: Installer og konfigurer MoinMoin

1) Brug følgende kommandoer til at installere MoinMoin 1.9.9, den seneste stabile udgivelse af MoinMoin på det tidspunkt, jeg skrev denne artikel:

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

Efter at have kørt kommandoer ovenfor, vil MoinMoin eksekverbare og alle biblioteksfiler blive installeret i /opt/moinmappen, og data, der bruges til at bygge din egen enkelt MoinMoin wiki, vil blive installeret i /srv/share/moinmappen.

2) Opret en konfigurationsfil navngivet moin.wsgii MoinMoin-databiblioteket ved hjælp af en skabelonfil af samme navn:

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

Åbn den nyoprettede konfigurationsfil ved hjælp af viteksteditoren:

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

Find følgende linje:

import sys, os

Tilføj følgende to linjer nedenfor:

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

Gem og luk:

:wq!

3) Opret endnu en MoinMoin wiki-konfigurationsfil, som vil blive brugt til at tilpasse din egen wiki:

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

Du kan konfigurere mange funktioner til din MoinMoin-wiki i denne fil, men indtil videre skal du blot konfigurere flere funktioner som nedenfor.

Definer webstedets navn (Sig det er My First Wiki):

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

Definer en superbruger (Sig det er admin):

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

Bemærk: Du skal stadig registrere denne bruger fra MoinMoin-webgrænsefladen senere.

Deaktiver omvendte DNS-opslag for acceleration:

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

4) Skift ejerskab af installerede MoinMoin-filer:

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

Trin 3: Installer og konfigurer uWSGI

UWSGI fungerer som et knudepunkt mellem Nginx-webserveren og en Python-applikation og er designet til at producere den bedste ydeevne ved hjælp af den højtydende uWSGI-protokol. Lad os derefter tage et kig på, hvordan du installerer og konfigurerer uWSGI til at køre MoinMoin.

1) Brug pip til at installere uWSGI som følger:

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

Hvis alt går godt, bør du se output svarende til:

...
Successfully installed uwsgi-2.0.15

2) Når uWSGI er installeret, skal du oprette en mappe til at gemme uWSGI-logfiler:

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

3) Derudover skal du oprette en mappe til at gemme MoinMoin-socket-filen:

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

4) Opret en uWSGI-konfigurationsfil uwsgi.inii MoinMoin wiki- datamappen og udfyld den som følger:

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) For at bruge systemd til at administrere uWSGI, skal du opsætte en systemd enhedsfil til 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) Start uWSGI-tjenesten og få den til at starte automatisk ved systemopstart:

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

Trin 4: Tillad webadgang

Konfigurer firewallregler som følger, så brugere kan besøge dit MoinMoin wiki-websted ved hjælp af en webbrowser:

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

Trin 5: Få adgang til MoinMoin fra en webbrowser

Nu har et enkelt MoinMoin-wiki-websted været oppe og køre på din CentOS 7-serverinstans.

Peg din yndlingswebbrowser til http://203.0.113.1, og så kommer du ind i MoinMoin-webgrænsefladen. Tilmeld dig og log ind som den superbruger, adminvi nævnte tidligere, og så er du i stand til at administrere din wiki-side, som du ønsker.

Hvis det er nødvendigt, kan du foretage flere tilpasninger ved at redigere /srv/share/moin/wikiconfig.pyfilen.

Dette afslutter selvstudiet. Tak fordi du læste med.