Comment installer MoinMoin sur CentOS 7

• Conditions préalables
• Étape 1: installer et configurer Nginx
• Étape 2: installer et configurer MoinMoin
• Étape 3: installer et configurer uWSGI
• Étape 4: autoriser l'accès Web
• Étape 5: accéder à MoinMoin à partir d'un navigateur Web

MoinMoin est un moteur wiki open source basé sur un système de fichiers écrit en Python. De nos jours, MoinMoin est largement utilisé dans la communauté open source. De nombreux fournisseurs, y compris, mais sans s'y limiter, Apache, Ubuntu, Debian et Python, ont configuré leurs propres wikis avec le moteur wiki MoinMoin.

Dans ce didacticiel, vous apprendrez à configurer un seul site wiki MoinMoin sur une instance de serveur CentOS 7. Afin de servir MoinMoin, Nginx et uWSGI seront également installés.

Conditions préalables

• Une nouvelle instance de serveur Vultr CentOS 7 x64. Supposons que son adresse IP soit 203.0.113.1.
• Un utilisateur sudo .
• L'instance de serveur a été mise à jour vers le dernier état stable à l'aide du référentiel EPEL YUM .

Étape 1: installer et configurer Nginx

Avant de pouvoir installer MoinMoin et le faire fonctionner, vous devez configurer un serveur Web pour cela, et Nginx est un excellent choix à cet effet.

1) Par souci de commodité, vous pouvez installer Nginx à l'aide du référentiel EPEL YUM:

sudo yum install nginx -y

2) Configurez Nginx comme suit pour qu'il puisse fonctionner avec uWSGI et MoinMoin.

Utilisez l' viéditeur de texte pour ouvrir le fichier de configuration principal de Nginx /etc/nginx/nginx.conf:

sudo vi /etc/nginx/nginx.conf

Dans le http { }segment, trouvez le server { }segment qui est extrait ci-dessous:

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) Utilisez l'adresse IP du serveur pour définir un nom de serveur pour Nginx:

Trouvez la ligne:

server_name _;

Remplacez-le par:

server_name  203.0.113.1;

2.2) Configurez Nginx comme utilisant le protocole uWSGI pour les communications:

Trouvez le location / { }segment:

location / {
}

Insérez deux lignes comme ci-dessous:

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

Sauvegarder et quitter:

:wq!

3) En option, vous pouvez tester la configuration modifiée avec la commande suivante:

sudo nginx -t

Si rien ne va mal, vous devriez voir la sortie comme ci-dessous:

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

4) Enfin, démarrez le service Nginx et faites-le démarrer automatiquement au démarrage du système:

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

Étape 2: installer et configurer MoinMoin

1) Utilisez les commandes suivantes pour installer MoinMoin 1.9.9, la dernière version stable de MoinMoin au moment où j'ai écrit cet article:

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

Après avoir exécuté les commandes ci-dessus, l'exécutable MoinMoin et tous les fichiers de bibliothèque seront installés dans le /opt/moinrépertoire, et les données utilisées pour créer votre propre wiki MoinMoin unique seront installées dans le /srv/share/moinrépertoire.

2) Créez un fichier de configuration nommé moin.wsgidans le répertoire de données MoinMoin en utilisant un fichier modèle du même nom:

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

Ouvrez le fichier de configuration nouvellement créé à l'aide de l' viéditeur de texte:

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

Trouvez la ligne suivante:

import sys, os

Ajoutez les deux lignes suivantes sous:

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

Sauvegarder et quitter:

:wq!

3) Créez un autre fichier de configuration wiki MoinMoin qui sera utilisé pour personnaliser votre propre wiki:

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

Vous pouvez configurer de nombreuses fonctionnalités pour votre wiki MoinMoin dans ce fichier, mais pour l'instant, il vous suffit de configurer plusieurs fonctionnalités comme ci-dessous.

Définissez le nom du site (dites-le My First Wiki):

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

Définissez un superutilisateur (dites que c'est le cas admin):

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

Remarque: Vous devez encore enregistrer cet utilisateur à partir de l'interface Web MoinMoin ultérieurement.

Désactivez les recherches DNS inversées pour l'accélération:

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

4) Modifiez la propriété des fichiers MoinMoin installés:

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

Étape 3: installer et configurer uWSGI

Agissant comme un hub entre le serveur Web Nginx et une application Python, uWSGI est conçu pour produire les meilleures performances en utilisant le protocole uWSGI hautes performances. Ensuite, regardons comment installer et configurer uWSGI pour exécuter MoinMoin.

1) Utilisez pip pour installer uWSGI comme suit:

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

Si tout se passe bien, vous devriez voir la sortie similaire à:

...
Successfully installed uwsgi-2.0.15

2) Après avoir installé uWSGI, vous devez créer un répertoire pour stocker les fichiers journaux uWSGI:

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

3) De plus, vous devez créer un répertoire pour stocker le fichier socket MoinMoin:

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

4) Créez un fichier de configuration uWSGI uwsgi.inidans le répertoire de données wiki MoinMoin et remplissez-le comme suit:

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) Afin d'utiliser systemd pour gérer uWSGI, vous devez configurer un fichier d'unité systemd pour 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) Démarrez le service uWSGI et faites-le démarrer automatiquement au démarrage du système:

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

Étape 4: autoriser l'accès Web

Configurez les règles de pare-feu comme suit pour que les utilisateurs puissent visiter votre site wiki MoinMoin à l'aide d'un navigateur Web:

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

Étape 5: accéder à MoinMoin à partir d'un navigateur Web

Désormais, un seul site wiki MoinMoin est opérationnel sur votre instance de serveur CentOS 7.

Pointez votre navigateur Web préféré sur http://203.0.113.1, puis vous accéderez à l'interface Web MoinMoin. Inscrivez-vous et connectez-vous en tant que superutilisateur que adminnous avons mentionné plus tôt, puis vous pourrez gérer votre site wiki comme vous le souhaitez.

Si nécessaire, vous pouvez personnaliser davantage en modifiant le /srv/share/moin/wikiconfig.pyfichier.

Ceci conclut le didacticiel. Merci d'avoir lu.