Comment configurer un wiki de style GitHub à laide de Gollum sur CentOS 7

• Conditions préalables
• Étape 1: mettre à jour le système
• Étape 2: installer Gollum à l'aide de Gem
• Étape 3: configurer un wiki Gollum
• Étape 4: autoriser l'accès Web
• Étape 5: accéder à Gollum à partir du Web
• Étape 6: créer ou modifier des pages wiki Gollum à partir de CLI

Gollum est le logiciel wiki basé sur Git utilisé comme backend du Wiki GitHub. Le déploiement de Gollum vous permettra d'héberger un système Wiki de type GitHub sur votre serveur.

Intéressé? Génial! Voyons comment installer Gollum sur CentOS 7.

Conditions préalables

• Une instance de serveur CentOS 7 x64.
• Un utilisateur sudo .
• Le EPELréférentiel yum.

Étape 1: mettre à jour le système

Connectez-vous à votre serveur via SSH en utilisant l'utilisateur sudo pour installer epel, mettre à jour le système et redémarrer pour appliquer les mises à jour.

sudo yum install epel-release -y
sudo yum update -y && sudo shutdown -r now

Étape 2: installer Gollum à l'aide de Gem

Sur CentOS 7, la façon la plus simple d'installer Gollum est d'utiliser RubyGems:

sudo yum group install "Development Tools" -y
sudo yum install ruby ruby-devel libicu libicu-devel zlib zlib-devel git -y
sudo gem install gollum

Remarque: la gem installcommande ci-dessus peut prendre un certain temps. Si vous êtes pressé, vous pouvez accélérer l'installation en sautant les documents comme suit. Vous pouvez également l'exécuter dans une screensession

sudo gem install --no-rdoc --no-ri gollum

Le binaire Gollum sera installé dans votre système à l'adresse /usr/local/bin/gollum, et vous pouvez confirmer si l'installation a réussi ou non en exécutant la commande simple ci-dessous:

gollum --v

Étape 3: configurer un wiki Gollum

Tout ce que vous devez faire pour configurer un wiki Gollum est de créer un référentiel git et d'exécuter la gollumcommande à l'intérieur:

cd
mkdir my-wiki
cd my-wiki
git init
gollum

Remarque: Si nécessaire, vous pouvez utiliser Ctrl+Cpour quitter Gollum.

Étape 4: autoriser l'accès Web

Avant de pouvoir visiter votre site wiki Gollum dans votre navigateur Web, vous devez modifier les règles de pare-feu comme suit:

sudo firewall-cmd --zone=public --permanent --add-port=4567/tcp
sudo firewall-cmd --reload

Étape 5: accéder à Gollum à partir du Web

Pendant que Gollum fonctionne, pointez votre navigateur Web http://203.0.113.1:4567pour commencer à créer la première page wiki de Gollum. N'hésitez pas à y créer plus de pages wiki, et toutes les pages que vous créez seront enregistrées sous forme de .mdfichiers dans le répertoire git repo actuel.

Étape 6: créer ou modifier des pages wiki Gollum à partir de CLI

Outre la création ou la modification de pages à partir d'un navigateur Web, vous pouvez également créer ou modifier des pages à partir de la CLI. Pour ce faire, il vous suffit de créer des .mdfichiers conformément à la syntaxe MarkDown, puis de les valider dans le référentiel git:

cd ~/my-wiki
vi page1.md
git config --global user.email "admin@example.com"
git config --global user.name "admin"
git add page1.md
git commit -m "create page1"

C'est tout. Pour en savoir plus sur Gollum, tapez gollum --helppour consulter l'aide de Gollum ou visitez le site Web officiel de Gollum .