Linux

Docker + Growiでイントラ向けWikiを立ち上げる

チーム開発をしていくうえで、課題の1つになるのが情報共有です。チームの歴史が長いと経験値は溜まっていきますが、それらが情報として整理されていないとメンバー交代時などに大きなコストが発生します。

そこで、イントラ向けのナレッジベース(Wiki)を探していたところ、Growiという良さげなOSSを見つけたので、お試し環境を立ち上げてみることにしました。手元の環境はUbuntu18.04ですが、Linuxであれば大体同じような手順になると思います。

Dockerのインストール

今回はテスト環境なので、お手軽に環境を作ったり壊したりできるDockerを使います。こういうときにコンテナ技術のありがたみを感じます。

まずはDocker本体とDocker-Composeのインストールです。

$ sudo apt install docker
$ sudo apt install docker-compose

Docker-Composeというのは、複数のコンテナの連携などを簡単に行うための仕組みです。Growi公式でDocker-Compose向けの設定ファイルを用意してくれているので、その仕組みに乗っかる方が楽でオススメです。

Growiの準備

Growi本体の準備です。まずはGitHubからGrowiのリポジトリをダウンロード。

$ git clone https://github.com/weseek/growi-docker-compose.git growi

続いて、必要に応じてGrowiの設定を変えておきます。デフォルトのままコンテナを立ち上げると、

  • localhostからの接続しかできない
  • ローカルのファイルシステムに対するファイルアップロードができない

などの制約があるので、これらを解除しておきます。編集するのはdocker-compose.ymlというファイルになります。

$ cd growi
$ vi docker-compose.yml

接続ポートの変更

デフォルトのポート設定はlocalhost(127.0.0.1)の3000番になっているため、他PCからのアクセスが受け付けられません。そこで、localhostの指定を削除します。もしポート番号も変えたければ一緒に変えておきます。

ports:
-         - 127.0.0.1:3000:3000 # localhost only by default
+        - 3000:3000 # localhost only by default

ファイルアップロード先をローカルにする

続いて、ファイルアップロードの設定です。デフォルトではAWS(S3準拠のサーバー)にアップロードするようになっていますが、イントラ環境だとローカルのファイルシステムに保存したくなります。ここは「FILE_UPLOAD=local」のコメントを外してあげればOK。

-        # - FILE_UPLOAD=local # activate this line if you use local storage of server rather than AWS
+       - FILE_UPLOAD=local # activate this line if you use local storage of server rather than AWS

データをホスト環境に置くようにする

お試しで動かすだけならこの設定は不要ですが、実運用も考えるとデータの永続化も必要になります。デフォルトでは、データ置き場にDocker内のVolumeコンテナをマウントしていますが、これをホスト環境の場所に置き換えます。(これでよいのかな…?)

置き換えたいVolumeは、growi_data・mongo_configdb・mongo_db・es_dataの4つです。それぞれ適当な場所を指定してあげましょう。以下はGrowi本体のデータの例です。

-        - growi_data:/data
+       - /home/corgi0901/workspace/growi/data/growi_data:/data

コンテナを立ち上げる

最後にコンテナを起動します。こちらもコマンド1つ叩くだけです。コンテナ技術の便利さにあらためて感動します。

$ sudo docker-compose up -d

Dockerのコンテナを確認し、以下の3つが立ち上がっていればOKです。

あとはブラウザでサーバーの3000番ポートにアクセスし、Growiのトップ画面が出てくればOKです。(以下のキャプチャは初期設定を済ませた後のものです)

これで無事にお試し環境を立ち上げることができました。少し触ってみた感じでは、Wikiとしての完成度はとても高いように感じます。これなら本運用しても良いかも(・∀・)

直に立ち上げるとなかなかに面倒でも、Dockerを使うと簡単に立ち上げることができるので、興味のある方は試してみてはいかがでしょうか。

ではでは

関連記事

Linux

2020/3/28

SSHで公開鍵認証を設定する方法

これまでに何度かLinuxでサーバーを立てて遊んだりしていますが、毎回忘れてしまうのがSSHの公開鍵認証の設定方法です。一度設定してしまえば頻繁に触るものでもないので、ついつい忘却の彼方へ消えてしまいます(´・ω・`) この先、毎回調べなおすのも面倒なので、これを機に手順をまとめておくことにしました。ちなみに、サーバー(接続される側)がLinuxの想定です。 目次手順1:クライアント側で鍵ペアを作る手順2:サーバーに公開鍵を設定する手順3:SSHサーバーの設定 手順1:クライアント側で鍵ペアを作る まずは ...

この記事を読む

Flutter

2020/3/10

【Flutter】FutureBuilderで非同期にWidgetを生成する

ここ最近、Flutterでアプリを作ってきてある程度の知識がたまってきたので、徐々にこちらでもアウトプットしていこうと思います。 アプリの機能が複雑になってくると、外部との通信や重たい処理の終了を待ってからWidgetを生成したいときがあります。そんなときはFutureBuilderという仕組みを使うと簡単に非同期でWidgetが生成できます。 目次FutureBuilderの使い方builderについて非同期処理の状態を見る非同期処理の結果を取り出すまとめ参考 FutureBuilderの使い方 Fut ...

この記事を読む

日記 自作物

2020/3/7

FlutterでToDoアプリをつくってみた

最近、Flutterを使ったモバイルアプリの開発にハマっているのですが、前回このブログでも紹介した「SaltyStock」というアプリに続き、新しいアプリをリリースしました(・∀・) App Store‎CotoMemo‎CotoMemoはタブ型のToDoアプリです。仕事からプライベートまで、日々のやるべきこと(Coto)を気軽にメモ(Memo)する感覚で整理することができます。【主な機能】・タブによるタスク管理タブ毎にタスク整理ができるので、このアプリ1つで仕事もプライベートもあら... リリースしたの ...

この記事を読む

日記 自作物

2019/12/22

FlutterでiOS/Androidアプリを作ってみた

2019年の密かな目標の1つとして「スマホアプリを作ってリリースする」というのを掲げていたのですが、なんとか年内に達成することができました(・∀・) どうせ作るならiOS/Android両対応がいい!ということで、FlutterというGoogle製のフレームワークを使いました。開発したのは「SaltyStock」というアプリです。長期保有して塩漬け状態になっている株式銘柄を管理するというかなりニッチなアプリです笑。 「個人的にこういうのあったらいいな」というものを作ることができたので、概ね満足です。もし興 ...

この記事を読む

Linux

2020/3/10

Docker + Growiでイントラ向けWikiを立ち上げる

チーム開発をしていくうえで、課題の1つになるのが情報共有です。チームの歴史が長いと経験値は溜まっていきますが、それらが情報として整理されていないとメンバー交代時などに大きなコストが発生します。 そこで、イントラ向けのナレッジベース(Wiki)を探していたところ、Growiという良さげなOSSを見つけたので、お試し環境を立ち上げてみることにしました。手元の環境はUbuntu18.04ですが、Linuxであれば大体同じような手順になると思います。 目次DockerのインストールGrowiの準備接続ポートの変更 ...

この記事を読む

-Linux

Copyright© Corgi Lab. ~備忘録のための技術ブログ~ , 2020 All Rights Reserved.