Sådan konfigureres en GitHub Style Wiki ved hjælp af Gollum på CentOS 7

Gollum er den Git-baserede wiki-software, der bruges som backend af GitHub Wiki. Implementering af Gollum vil give dig mulighed for at være vært for et GitHub-lignende Wiki-system på din server.

Interesseret? Store! Lad os tage et kig på, hvordan man installerer Gollum på CentOS 7.

Forudsætninger

• En CentOS 7 x64-serverinstans.
• En sudo-bruger .
• Den EPELyum repository.

Trin 1: Opdater systemet

Log ind på din server via SSH ved hjælp af sudo-brugeren til at installere epel, opdatere systemet og genstarte for at anvende opdateringerne.

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

Trin 2: Installer Gollum ved hjælp af gem

På CentOS 7 er den nemmeste måde at installere Gollum på ved at bruge 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

Bemærk: gem installKommandoen ovenfor kan tage et stykke tid at fuldføre. Hvis du har travlt, kan du fremskynde installationen ved at springe dokumenter over som følger. Du kan også køre det i en screensession

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

Gollum binær vil blive installeret i dit system på /usr/local/bin/gollum, og du kan bekræfte, om installationen var en succes eller ej, ved at køre den simple kommando nedenfor:

gollum --v

Trin 3: Opsæt en Gollum-wiki

Alt du skal gøre for at opsætte en Gollum Wiki er at oprette et git-lager og køre gollumkommandoen inde i det:

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

Bemærk: Når det er nødvendigt, kan du bruge Ctrl+Ctil at afslutte Gollum.

Trin 4: Tillad webadgang

Før du kan besøge dit Gollum wiki-websted i din webbrowser, skal du ændre firewallreglerne som følger:

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

Trin 5: Få adgang til Gollum fra internettet

Mens Gollum kører, skal du pege på din webbrowser for http://203.0.113.1:4567at begynde at oprette den første Gollum wiki-side. Du er velkommen til at oprette flere wiki-sider der, og alle de sider, du opretter, vil blive gemt som .mdfiler i den aktuelle git-repo-mappe.

Trin 6: Opret eller rediger Gollum wiki-sider fra CLI

Udover at oprette eller ændre sider fra en webbrowser, kan du også oprette eller redigere sider fra CLI. For at gøre det behøver du kun at oprette .mdfiler i overensstemmelse med MarkDown-syntaksen og derefter forpligte dem til git-repoen:

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"

Det er det. For at lære mere om Gollum, skriv for gollum --helpat tjekke Gollum-hjælpen eller besøg Gollums officielle hjemmeside .