CentOS 7でGollumを使用してGitHubスタイルのWikiをセットアップする方法

• 前提条件
• ステップ1：システムを更新する
• ステップ2：gemを使用してGollumをインストールする
• ステップ3：Gollum wikiをセットアップする
• ステップ4：Webアクセスを許可する
• ステップ5：WebからGollumにアクセスする
• ステップ6：CLIからGollum wikiページを作成または編集する

Gollumは、GitHub Wikiのバックエンドとして使用されるGitベースのwikiソフトウェアです。Gollumをデプロイすると、サーバーでGitHubのようなWikiシステムをホストできます。

興味がある？すごい！CentOS 7にGollumをインストールする方法を見てみましょう。

前提条件

• CentOS 7 x64サーバーインスタンス。
• sudoのユーザー。
• EPELYUMリポジトリ。

ステップ1：システムを更新する

sudoユーザーを使用してSSH経由でサーバーにログインし、をインストールしepelてシステムを更新し、再起動して更新を適用します。

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

ステップ2：gemを使用してGollumをインストールする

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 wikiをセットアップする

Gollum Wikiをセットアップするために必要なのは、gitリポジトリを作成して、そのgollum中でコマンドを実行することだけです。

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

注：必要に応じて、を使用Ctrl+CしてGollumを終了できます。

ステップ4：Webアクセスを許可する

WebブラウザでGollum wikiサイトにアクセスする前に、ファイアウォールルールを次のように変更する必要があります。

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

ステップ5：WebからGollumにアクセスする

Gollumの実行中に、Webブラウザーをポイントhttp://203.0.113.1:4567して最初のGollum wikiページの作成を開始します。そこで自由にwikiページを作成してください。作成したすべてのページ.mdは、現在のgit repoディレクトリにファイルとして保存されます。

ステップ6：CLIからGollum wikiページを作成または編集する

Webブラウザーからページを作成または変更する以外に、CLIからページを作成または編集することもできます。これを行うには、.mdMarkDown構文に従ってファイルを作成し、それらを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"

それでおしまい。Gollumの詳細については、入力gollum --helpしてGollumのヘルプを確認するか、Gollumの公式Webサイトにアクセスしてください。