Requisits previs
Pas 1: actualitzeu el sistema
Pas 2: instal·leu Gollum amb gem
Pas 3: configureu una wiki de Gollum
Pas 4: permet l'accés web
Pas 5: accediu a Gollum des del web
Pas 6: creeu o editeu pàgines wiki de Gollum des de la CLI
Gollum és el programari wiki basat en Git que s'utilitza com a backend del GitHub Wiki. El desplegament de Gollum us permetrà allotjar un sistema Wiki semblant a GitHub al vostre servidor.
Interessat? Genial! Fem una ullada a com instal·lar Gollum a CentOS 7.
Requisits previs
- Una instància de servidor CentOS 7 x64.
- Un usuari de sudo .
- El
EPELrepositori yum.
Pas 1: actualitzeu el sistema
Inicieu sessió al vostre servidor mitjançant SSH utilitzant l'usuari sudo per instal·lar epel, actualitzar el sistema i reiniciar per aplicar les actualitzacions.
sudo yum install epel-release -y
sudo yum update -y && sudo shutdown -r now
Pas 2: instal·leu Gollum amb gem
A CentOS 7, la manera més senzilla d'instal·lar Gollum és utilitzar 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
Nota: l' gem installordre anterior pot trigar una estona a completar-se. Si teniu pressa, podeu accelerar la instal·lació saltant els documents de la següent manera. També podeu executar-lo en una screensessió
sudo gem install --no-rdoc --no-ri gollum
El binari de Gollum s'instal·larà al vostre sistema a /usr/local/bin/gollum, i podeu confirmar si la instal·lació va ser un èxit o no executant l'ordre senzill següent:
gollum --v
Pas 3: configureu una wiki de Gollum
Tot el que heu de fer per configurar un Gollum Wiki és crear un repositori git i executar l' gollumordre que hi ha dins:
cd
mkdir my-wiki
cd my-wiki
git init
gollum
Nota: quan sigui necessari, podeu utilitzar Ctrl+Cper sortir de Gollum.
Pas 4: permet l'accés web
Abans de poder visitar el vostre lloc wiki de Gollum al vostre navegador web, heu de modificar les regles del tallafoc de la següent manera:
sudo firewall-cmd --zone=public --permanent --add-port=4567/tcp
sudo firewall-cmd --reload
Pas 5: accediu a Gollum des del web
Mentre Gollum s'està executant, apunteu el vostre navegador web http://203.0.113.1:4567per començar a crear la primera pàgina wiki de Gollum. No dubteu a crear-hi més pàgines wiki i totes les pàgines que creeu es desaran com a .mdfitxers al directori de repositori git actual.
Pas 6: creeu o editeu pàgines wiki de Gollum des de la CLI
A més de crear o modificar pàgines des d'un navegador web, també podeu crear o editar pàgines des de la CLI. Per fer-ho, només heu de crear .mdfitxers d'acord amb la sintaxi de MarkDown i, a continuació, enviar-los al repositori 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"
Això és. Per obtenir més informació sobre Gollum, escriviu gollum --helpper consultar l'ajuda de Gollum o visiteu el lloc web oficial de Gollum .