¶ 課題(体感上はそこまででもないが読み込みが遅い)
Google Pagespeed Insightsのスコアがすこぶる悪い。
adsenseのせいもあるが、基本的に読み込みが遅い。
このページの前提
- 3系（v3.x）のGROWIを、Synology NASのDocker（docker-compose）で動かしたときの記録だ。本文中のホスト名やドメイン（wiki.nagoya88.net / hackmd.nagoya88.net）は自分の環境の例なので、読むときは自分の環境に読み替える。
- GROWIはNode.js製のWikiで、全文検索にElasticsearch、データにMongoDBを使う3コンテナ構成。1コンテナあたりのメモリ消費がそれなりに大きいので、NASのメモリが2GBクラスだと足りない。合計で4GB以上は確保しておきたい。
- 表示が遅い原因はAdSenseだけではない。GROWIのSSR（サーバ側でのHTML生成）とElasticsearchのインデックス作成が効いてくる。Pagespeedのスコアは広告ブロックの有無でも変わるので、数値だけで一喜一憂しないほうがいい。
¶ adsenseコードをカスタム HTML Headerに貼り付けた場合。
¶ adsenseコードをカスタムスクリプトに貼り付けた場合。
モバイルに限って若干の改善は見られたがPCではほぼ変化なし。
この実験から言えること
- AdSenseをカスタムHTMLヘッダに置くと、全ページのheadで同期的に読み込まれて初回描画を止める。カスタムスクリプト側に移すと読み込みのタイミングを遅らせられるので、モバイルでは少し効いた。
- PCで変化しなかったのは、広告の読み込みよりGROWI本体（SSR）とElasticsearchの応答時間のほうが支配的だったためだと思う。広告をいじる前にサーバ側の応答を疑ったほうが早い。
- 計測はキャッシュを消した状態で、同じ条件で複数回やらないとブレる。1回のスコアで判断しない。
¶ 4.0系へのアップデートその他
以降、3系での手順だがほぼ同じ。
¶ よくやりがちな反省点
・NASのアップデートなど、再起動時にDockerがうまく起動しないことがあるが、その解決手順をDocker上のGROWIに書いていると詰む。
我ながらアホ。
同じ轍を踏まないためのメモ
- 復旧手順・パスワード・composeファイルの控えは、NASに依存しない場所（紙・別端末・クラウド）にも残しておく。wikiの中だけに置くと、そのwikiが落ちたときに読めない。
- NASの再起動後にコンテナが起動しないときは、SSHで
sudo docker ps -aを見て停止や再起動ループの状態を確認する。restart: unless-stoppedを付けていても、依存先（mongo / elasticsearch）より先にappが起動しようとして失敗することがある。 - SynologyのDocker GUIは、composeで作ったコンテナの稼働状況は見えるがcomposeそのものは管理していない。GUIで消したつもりがcomposeの定義に残っている、といった食い違いが起きるので、操作はCUI側に寄せたほうが事故が少ない。
¶ Docker-composeでGROWIをインストールする
Markdown で書けるオープンソースの Wiki システム"GROWI"をSynology NASのDocker上にインストールする。
今回はdocker-composeを使ってインストールする。
growi-docker-compose - The fastest way to boot All-in-One GROWI
どうせなので、HackMD(CodiMD) integrationもセットで導入。
基本は公式の手順に従う。NASにSSHして以下のコマンドを入力。Synology NASへのSSH
$ git clone https://github.com/weseek/growi-docker-compose.git growi
$ cd growi
$ docker-compose up
これで、NASのIP:3000にアクセスすると動くらしいのだが、環境の問題でそのままでは動かなかった。
ポート指定の意味
127.0.0.1:3000:3000は「ホストのループバックからだけ3000番に繋ぐ」指定で、LANの他端末からは見えない。3000:3000にするとホストの全インターフェースで待ち受ける。- いきなり全公開にするとLAN内とはいえ誰でも開ける状態になる。まずリバースプロキシ経由だけ公開するなど、段階を踏んだほうが安全だ。
docker-compose upは初回にイメージのビルドが走るので数分〜十数分かかる。止まったように見えても待つ。
今回はグローバルからも参照できるようにするために、ローカルアクセスの制限を取り除く。
Before
services:
app:
ports:
- 127.0.0.1:3000:3000
After
services:
app:
ports:
- 3000:3000
メモリを食うので多めに与える。
ES_JAVA_OPTS の意味
-Xms2g -Xmx2gはElasticsearchが使うJVMヒープの最小値と最大値をどちらも2GBに固定する指定。両方を揃えるとヒープの伸縮が減り、動きが安定する。- 物理メモリからコンテナやOSの分を引いた範囲で決める。ヒープに寄せすぎるとOS側が苦しくなり、かえってコンテナが落ちる。2GBモデルなら1g程度に落とすなど、実機に合わせて調整する。
bootstrap.memory_lock=trueとulimits.memlockはセットで、Elasticsearchのメモリをスワップさせないための設定。片方だけ書いても効かない。
For High-memory environment
If you have enough memory, increase heap size for Elasticsearch with ES_JAVA_OPTS value in docker-compose.yml.
environment:
- "ES_JAVA_OPTS=-Xms2g -Xmx2g"
以下、我が家の最終的に動作した設定。
主要な環境変数の読み方
PASSWORD_SEED=changemeはパスワードのハッシュに混ぜる種。初回起動後に変えると既存ユーザーがログインできなくなるので、決めたら変えない。MONGO_URI/ELASTICSEARCH_URIはコンテナ名（mongo / elasticsearch）で名前解決させる。composeのネットワーク内で解決されるので、IPは書かない。FILE_UPLOAD=localはアップロードファイルをサーバ側ボリュームに置く設定。/dataにマウントした/volume1/docker/growi/growi_dataが実体になる。S3を使わないならこのままでいい。HACKMD_URIはブラウザから見えるアドレス、HACKMD_URI_FOR_SERVERはGROWIコンテナから見たアドレス。外向けと内向けを別々に書くのがポイントで、ここを同じにするとコンテナ間の連携が失敗する。MATHJAX=1は数式表示、FORCE_WIKI_MODEは公開／非公開の固定に使う。コメントアウトのままでも動く。command:のdockerize -wait ...は、mongoとelasticsearchが起動するまでappの起動を待たせる仕掛け。NASが遅いと270秒でも足りないことがあるので、タイムアウトは長めにしておく。
/growi/docker-compose.yml
version: '3'
services:
app:
build:
context: .
dockerfile: ./Dockerfile
ports:
- 3000:3000 # localhost only by default #<=ローカル以外のアクセスを許す
links:
- mongo:mongo
- elasticsearch:elasticsearch
depends_on:
- mongo
- elasticsearch
environment:
- MONGO_URI=mongodb://mongo:27017/growi
- ELASTICSEARCH_URI=http://elasticsearch:9200/growi
- PASSWORD_SEED=changeme
# - FILE_UPLOAD=mongodb # activate this line if you use MongoDB GridFS rather than AWS
- FILE_UPLOAD=local # activate this line if you use local storage of server rather than AWS
- MATHJAX=1 # activate this line if you want to use MathJax
# - PLANTUML_URI=http:// # activate this line and specify if you use your own PlantUML server rather than public plantuml.com
- HACKMD_URI=https://hackmd.nagoya88.net #<=アクセスにはサブドメインを
- HACKMD_URI_FOR_SERVER=http://hackmd:3000 # activate this line and specify HackMD server URI which can be accessed from this server container
# - FORCE_WIKI_MODE='public' # activate this line to force wiki public mode
# - FORCE_WIKI_MODE='private' # activate this line to force wiki private mode
command: "dockerize
-wait tcp://mongo:27017
-wait tcp://elasticsearch:9200
-timeout 270s #<=タイムアウトを長めに
npm run server:prod"
restart: unless-stopped
volumes:
- /volume1/docker/growi/growi_data:/data #<=ボリュームをローカルに
mongo:
image: mongo:3.6
restart: unless-stopped
volumes:
- /volume1/docker/growi/mongo_configdb:/data/configdb #<=ボリュームをローカルに
- /volume1/docker/growi/mongo_db:/data/db #<=ボリュームをローカルに
elasticsearch:
build:
context: ./elasticsearch
dockerfile: ./Dockerfile
environment:
- bootstrap.memory_lock=true
- "ES_JAVA_OPTS=-Xms2g -Xmx2g" #<=ボリュームをローカルに
ulimits:
memlock:
soft: -1
hard: -1
restart: unless-stopped
volumes:
- /volume1/docker/growi/es_data:/usr/share/elasticsearch/data #<=ボリュームをローカルに
- /volume1/docker/growi/elasticsearch/config/elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml #<=ボリュームをローカルに
"/docker/growi/examples/integrate-with-hackmd/docker-compose.override.yml"を"/docker/growi/docker-compose.override.yml"にコピーして編集。
version: '3'
services:
##
# HackMD(CodiMD) container
# see https://github.com/hackmdio/codimd#configuration
#
hackmd:
build:
context: ./hackmd
environment:
- GROWI_URI=https://wiki.nagoya88.net #<=アクセスにはサブドメインを
- CMD_DB_URL=mysql://hackmd:hackmdpass@mariadb:3306/hackmd
- CMD_CSP_ENABLE=false
ports:
- 3100:3000 # localhost only by default #<=リバースプロキシは3100に
depends_on:
- mariadb
restart: unless-stopped
##
# MariaDB
# see https://hub.docker.com/_/mariadb/
mariadb:
image: mariadb:10.3
command: mysqld --character-set-server=utf8 --collation-server=utf8_general_ci
environment:
- MYSQL_USER=hackmd
- MYSQL_PASSWORD=hackmdpass
- MYSQL_DATABASE=hackmd
- MYSQL_RANDOM_ROOT_PASSWORD=true
restart: unless-stopped
volumes:
- /volume1/docker/growi/mariadb_data:/var/lib/mysql #<=ボリュームをローカルに
/docker/growi/elasticsearch/Dockerfile
FROM docker.elastic.co/elasticsearch/elasticsearch:6.6.1
LABEL maintainer Yuki Takei <yuki@weseek.co.jp>
RUN bin/elasticsearch-plugin install analysis-kuromoji
RUN bin/elasticsearch-plugin install analysis-icu
/docker/growi/elasticsearch/config/elasticsearch.yml
http.host: 0.0.0.0
# for elasticsearch-head
http.cors.enabled: true
http.cors.allow-origin: "*"
cluster.routing.allocation.disk.threshold_enabled: false #<=NASのストレージ残量が減るとElasticSearchがエラーを吐くのを防止
以上の設定を行ったうえで、GROWIとHackMDのアドレスそれぞれのサブドメインをhttps-portalでリバースプロキシで転送すれば自宅外からも動作する。
設定ファイルまわりの補足
cluster.routing.allocation.disk.threshold_enabled: falseは、ディスク残量が減ったときにElasticsearchがシャード配置を止めて読み取り専用になるのを防ぐ設定。空き容量の少ないNASでは実質必須。ただし残量を無視して書き込み続けるので、ストレージの監視は別途必要。http.cors.enabled: trueとhttp.cors.allow-origin: "*"は elasticsearch-head のような外部ツールから叩くための設定。9200番をLANに晒す前提になるので、使わないならこの2行は消しておく。- hackmdコンテナはホストの3100番にだけ出して、リバースプロキシから叩く。mariadbは文字コードをutf8固定にしているので、日本語のメモが化けない。
- elasticsearchのDockerfileで
analysis-kuromojiとanalysis-icuを入れている。これが無いと日本語の全文検索が実用にならない。
¶ コンテナの起動
$ docker-compose up
これだけで起動するはずだが、うまくいかない場合はこちらを参照。
ちなみにSynology NASではCUIでのDocker-composeの作業もGUIには反映される。（各コンテナの状況のみ。composeの状況は見えない）
起動・停止の基本操作
docker-compose upはフォアグラウンドで動く。SSHを切ると止まるので、常用するならdocker-compose up -dでバックグラウンド起動にする。- 設定を変えたときは
docker-compose up -dをもう一度実行すると、差分だけ作り直される。downはコンテナを消すが、ボリューム（/volume1/docker/growi 配下）は残る。 - イメージのタグはcomposeファイル内で固定しておく（mongo:3.6、mariadb:10.3、elasticsearch:6.6.1）。
latestを追うと、ある日突然起動しなくなる。
Synology Dockerで遭遇したエラー対策
/Knowledge/Synology/Docker/Error
¶ 参考URL
- GROWI 公式ドキュメント
- growi-docker-compose（公式リポジトリ）
- MongoDB 公式Dockerイメージ
- 構成やバージョンは導入時点の各公式ページで確認。
※ 本ページのAmazonリンクにはアフィリエイトタグ（toobf6-22）が付いている。
🤖 このページにはAIエージェント（ノア）による編集・加筆が含まれます。内容の正確性は保証できないため、重要な判断は一次情報でご確認ください。