Jak skonfigurować Wiki typu GitHub przy użyciu Gollum na CentOS 7

• Wymagania wstępne
• Krok 1: Zaktualizuj system
• Krok 2: Zainstaluj Gollum za pomocą klejnotu
• Krok 3: Skonfiguruj wiki Gollum
• Krok 4: Zezwól na dostęp do sieci
• Krok 5: Uzyskaj dostęp do Gollum z sieci
• Krok 6: Utwórz lub edytuj strony wiki Gollum z CLI

Gollum to oparte na Git oprogramowanie wiki używane jako backend GitHub Wiki. Wdrożenie Gollum pozwoli Ci hostować system Wiki podobny do GitHub na twoim serwerze.

Zainteresowany? Wspaniały! Zobaczmy, jak zainstalować Gollum na CentOS 7.

Wymagania wstępne

• Instancja serwera CentOS 7 x64.
• Użytkownik sudo .
• EPELYum składowania.

Krok 1: Zaktualizuj system

Zaloguj się do serwera za pośrednictwem SSH przy użyciu użytkownika sudo, aby zainstalować epel, zaktualizować system i uruchomić ponownie, aby zastosować aktualizacje.

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

Krok 2: Zainstaluj Gollum za pomocą klejnotu

W CentOS 7 najprostszym sposobem na zainstalowanie Gollum jest użycie 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

Uwaga: wykonanie gem installpowyższego polecenia może chwilę potrwać. Jeśli się spieszysz, możesz przyspieszyć instalację, pomijając dokumenty w następujący sposób. Możesz także uruchomić go w screensesji

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

Plik binarny Gollum zostanie zainstalowany w systemie pod adresem. /usr/local/bin/gollumMożesz potwierdzić, czy instalacja zakończyła się powodzeniem, uruchamiając poniższe proste polecenie:

gollum --v

Krok 3: Skonfiguruj wiki Gollum

Wszystko, co musisz zrobić, aby skonfigurować Gollum Wiki, to utworzyć repozytorium git i uruchomić w nim gollumpolecenie:

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

Uwaga: W razie potrzeby możesz użyć, Ctrl+Caby wyjść z Gollum.

Krok 4: Zezwól na dostęp do sieci

Aby móc odwiedzić witrynę wiki Gollum w przeglądarce internetowej, musisz zmodyfikować reguły zapory w następujący sposób:

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

Krok 5: Uzyskaj dostęp do Gollum z sieci

Gdy Gollum jest uruchomione, wskaż swoją przeglądarkę internetową, http://203.0.113.1:4567aby rozpocząć tworzenie pierwszej strony wiki Gollum. Utwórz tam więcej stron wiki, a wszystkie strony, które utworzysz, zostaną zapisane jako .mdpliki w bieżącym katalogu git repo.

Krok 6: Utwórz lub edytuj strony wiki Gollum z CLI

Oprócz tworzenia lub modyfikowania stron z przeglądarki internetowej, możesz także tworzyć lub edytować strony z poziomu interfejsu CLI. Aby to zrobić, musisz tylko utworzyć .mdpliki zgodnie ze składnią MarkDown, a następnie zatwierdzić je w repozytorium git:

cd ~/my-wiki
vi page1.md
git config --global user.email "[email protected]"
git config --global user.name "admin"
git add page1.md
git commit -m "create page1"

Otóż ​​to. Aby dowiedzieć się więcej o Gollum, wpisz, gollum --helpaby sprawdzić pomoc Gollum lub odwiedź oficjalną stronę Gollum .