Como configurar um wiki de estilo do GitHub usando o Gollum no CentOS 7

• Pré-requisitos
• Etapa 1: atualizar o sistema
• Etapa 2: Instale o Gollum usando gem
• Etapa 3: Configurar um wiki do Gollum
• Etapa 4: permitir acesso à web
• Etapa 5: acesse o Gollum da web
• Etapa 6: Crie ou edite as páginas wiki do Gollum na CLI

Gollum é o software wiki baseado em Git usado como back-end do Wiki do GitHub. A implantação do Gollum permitirá que você hospede um sistema Wiki do tipo GitHub em seu servidor.

Interessado? Ótimo! Vamos dar uma olhada em como instalar o Gollum no CentOS 7.

Pré-requisitos

• Uma instância do servidor CentOS 7 x64.
• Um usuário sudo .
• O EPELrepositório yum.

Etapa 1: atualizar o sistema

Efetue login no servidor via SSH usando o usuário sudo para instalar epel, atualizar o sistema e reinicie para aplicar as atualizações.

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

Etapa 2: Instale o Gollum usando gem

No CentOS 7, a maneira mais fácil de instalar o Gollum é 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: O gem installcomando acima pode demorar um pouco para ser concluído. Se você estiver com pressa, poderá acelerar a instalação ignorando os documentos da seguinte maneira. Você também pode executá-lo em uma screensessão

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

O binário Gollum será instalado no seu sistema em /usr/local/bin/gollume você pode confirmar se a instalação foi ou não bem-sucedida executando o comando simples abaixo:

gollum --v

Etapa 3: Configurar um wiki do Gollum

Tudo o que você precisa fazer para configurar um Gollum Wiki é criar um repositório git e executar o gollumcomando dentro dele:

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

Nota: Quando necessário, você pode usar Ctrl+Cpara sair do Gollum.

Etapa 4: permitir acesso à web

Antes de poder visitar o site wiki da Gollum em seu navegador, você precisa modificar as regras de firewall da seguinte maneira:

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

Etapa 5: acesse o Gollum da web

Enquanto o Gollum estiver em execução, aponte seu navegador http://203.0.113.1:4567para começar a criar a primeira página wiki do Gollum. Sinta-se livre para criar mais páginas wiki lá, e todas as páginas que você criar serão salvas como .mdarquivos no diretório atual do git repo.

Etapa 6: Crie ou edite as páginas wiki do Gollum na CLI

Além de criar ou modificar páginas de um navegador da web, você também pode criar ou editar páginas da CLI. Para fazer isso, você só precisa criar .mdarquivos de acordo com a sintaxe do MarkDown e enviá-los ao repositório 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"

É isso aí. Para saber mais sobre a Gollum, digite gollum --helppara verificar a ajuda da Gollum ou visite o site oficial da Gollum .