Як налаштувати Wiki Style GitHub за допомогою Gollum на CentOS 7

Gollum — це вікі-програмне забезпечення на основі Git, яке використовується як серверна частина GitHub Wiki. Розгортання Gollum дозволить вам розмістити на своєму сервері систему Wiki, подібну до GitHub.

Цікаво? Чудово! Давайте подивимося, як встановити Gollum на CentOS 7.

Передумови

• Примірник сервера CentOS 7 x64.
• Користувач sudo .
• EPELНі сховище.

Крок 1: Оновіть систему

Увійдіть на свій сервер через SSH за допомогою користувача sudo, щоб встановити epel, оновити систему та перезапустити, щоб застосувати оновлення.

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

Крок 2: Встановіть Gollum за допомогою gem

У CentOS 7 найпростіший спосіб встановити Gollum - це використовувати 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

Примітка. Для виконання gem installнаведеної вище команди може знадобитися деякий час. Якщо ви поспішаєте, ви можете прискорити встановлення, пропустивши документи, як показано нижче. Ви також можете запустити його в screenсеансі

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

Бінарний файл Gollum буде встановлений у вашу систему за адресою /usr/local/bin/gollum, і ви можете підтвердити, чи була установка успішною, виконавши просту команду нижче:

gollum --v

Крок 3: Налаштуйте вікі Gollum

Все, що вам потрібно зробити, щоб налаштувати Gollum Wiki, це створити репозиторій git і запустити в ньому gollumкоманду:

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

Примітка: за потреби ви можете Ctrl+Cвийти з Gollum.

Крок 4. Надайте доступ до Інтернету

Перш ніж ви зможете відвідати свій вікі-сайт Gollum у своєму веб-переглядачі, вам потрібно змінити правила брандмауера таким чином:

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

Крок 5. Отримайте доступ до Gollum з Інтернету

Під час роботи Gollum наведіть на свій веб-браузер, http://203.0.113.1:4567щоб почати створювати першу вікі-сторінку Gollum. Не соромтеся створювати там більше вікі-сторінок, і всі створені вами сторінки будуть збережені як .mdфайли в поточному каталозі git repo.

Крок 6. Створіть або відредагуйте вікі-сторінки Gollum із CLI

Окрім створення або редагування сторінок за допомогою веб-браузера, ви також можете створювати або редагувати сторінки за допомогою інтерфейсу командної команди. Для цього вам потрібно лише створити .mdфайли відповідно до синтаксису MarkDown, а потім зафіксувати їх у git repo:

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"

Це воно. Щоб дізнатися більше про Gollum, введіть, gollum --helpщоб переглянути довідку Gollum, або відвідайте офіційний веб-сайт Gollum .