Cómo configurar un Wiki de estilo GitHub usando Gollum en CentOS 7

• Prerrequisitos
• Paso 1: actualiza el sistema
• Paso 2: Instala Gollum usando gema
• Paso 3: Configura una wiki de Gollum
• Paso 4: permitir el acceso web
• Paso 5: accede a Gollum desde la web
• Paso 6: Cree o edite páginas wiki de Gollum desde la CLI

Gollum es el software wiki basado en Git que se utiliza como back-end de GitHub Wiki. La implementación de Gollum le permitirá alojar un sistema Wiki similar a GitHub en su servidor.

¿Interesado? ¡Excelente! Echemos un vistazo a cómo instalar Gollum en CentOS 7.

Prerrequisitos

• Una instancia de servidor CentOS 7 x64.
• Un usuario de sudo .
• El EPELrepositorio de yum.

Paso 1: actualiza el sistema

Inicie sesión en su servidor a través de SSH utilizando el usuario sudo para instalar epel, actualizar el sistema y reiniciar para aplicar las actualizaciones.

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

Paso 2: Instala Gollum usando gema

En CentOS 7, la forma más fácil de instalar Gollum es usando 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: El gem installcomando anterior puede tardar un tiempo en completarse. Si tiene prisa, puede acelerar la instalación saltando los documentos de la siguiente manera. También puedes ejecutarlo en una screensesión

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

El binario de Gollum se instalará en su sistema en /usr/local/bin/gollum, y puede confirmar si la instalación fue exitosa o no ejecutando el comando simple a continuación:

gollum --v

Paso 3: Configura una wiki de Gollum

Todo lo que necesita hacer para configurar un Gollum Wiki es crear un repositorio git y ejecutar el gollumcomando dentro de él:

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

Nota: Cuando sea necesario, puede usar Ctrl+Cpara salir de Gollum.

Paso 4: permitir el acceso web

Antes de que pueda visitar su sitio wiki de Gollum en su navegador web, debe modificar las reglas del firewall de la siguiente manera:

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

Paso 5: accede a Gollum desde la web

Mientras se ejecuta Gollum, apunte su navegador web http://203.0.113.1:4567para comenzar a crear la primera página wiki de Gollum. Siéntase libre de crear más páginas wiki allí, y todas las páginas que cree se guardarán como .mdarchivos en el directorio actual de repositorio de git.

Paso 6: Cree o edite páginas wiki de Gollum desde la CLI

Además de crear o modificar páginas desde un navegador web, también puede crear o editar páginas desde la CLI. Para hacer eso, solo necesita crear .mdarchivos de acuerdo con la sintaxis de MarkDown y luego enviarlos al repositorio 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"

Eso es. Para obtener más información sobre Gollum, escriba gollum --helppara consultar la ayuda de Gollum o visite el sitio web oficial de Gollum .