Как настроить GitHub Style Wiki с помощью Gollum на CentOS 7

• Предпосылки
• Шаг 1: Обновите систему
• Шаг 2: Установите Gollum используя gem
• Шаг 3: Настройте Gollum вики
• Шаг 4. Разрешить веб-доступ
• Шаг 5: Доступ к Gollum из Интернета
• Шаг 6: Создание или редактирование вики-страниц Gollum из CLI

Gollum - это вики-приложение на основе Git, используемое в качестве бэкэнда вики-сайта GitHub. Развертывание Gollum позволит вам разместить GitHub-подобную систему Wiki на вашем сервере.

Заинтересованы? Большой! Давайте посмотрим, как установить 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

Помимо создания или изменения страниц из веб-браузера, вы также можете создавать или редактировать страницы из 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 .