HoplonはClojureとClojureScriptで書けるフルスタックなWebフレームワークです。ClojureのビルドツールにはBootを使います。Bootには1.x系と2.x系がありますが残念ながら後方互換性がありません。現状ではHoplonはBoot 1で動作します。バージョンの問題で少し嵌まりますがClojureはScalaほど消耗しません。
プロジェクト
適当なディレクトリにHoplon用のプロジェクトを作成します。
$ cd ~/clojure_apps/
$ tree -L 1
.
├── Dockerfile
├── docker-compose.yml
└── m2
Dockerfile
ビルドツールはLeiningenとBootの1.x系と2.x系をインストールします。Bootのコマンドはそれぞれboot1とboot2としています。デフォルトではBootは非rootユーザーが推奨されるためDockerには作業ユーザーのdockerを作成しています。
FROM clojure
MAINTAINER Masato Shimizu <ma6ato@gmail.com>
WORKDIR /usr/src/app
ADD https://github.com/boot-clj/boot/releases/download/2.0.0/boot.sh /tmp/
RUN mv /tmp/boot.sh /usr/local/bin/boot2 && \
chmod 755 /usr/local/bin/boot2
ADD https://clojars.org/repo/tailrecursion/boot/1.1.1/boot-1.1.1.jar /tmp/
RUN mv /tmp/boot-1.1.1.jar /usr/local/bin/boot1 && \
chmod 755 /usr/local/bin/boot1
RUN adduser --disabled-password --gecos '' --uid 1000 docker && \
mkdir /home/docker/.m2 && \
chown -R docker:docker /usr/src/app /home/docker/.m2
VOLUME /home/docker/.m2
USER docker
RUN lein
Hoplonで使うBootについて
Hoplonは現状Boot 1で動作します。Runtime Exception #41にissueがあります。残念ながらBootには後方互換性がありません。Boot2を使うとjava.lang.RuntimeExceptionが発生します。
docker-compose.yml
Docker Composeの設定ファイルです。boot1サービスではHoplonのデフォルト8000ポートをpotsディレクティブに指定します。
lein: &defaults
image: clojure
volumes:
- .:/usr/src/app
- ./m2:/home/docker/.m2
boot1:
<<: *defaults
entrypoint: ["boot1"]
ports:
- "8000:8000"
アプリの作成
HoplonアプリのビルドツールはBootですがテンプレートはLeiningenを使います。アプリ名はspike-hoplonとしました。
$ lein new hoplon spike-hoplon
Docker Composeを使う場合は以下を実行します。
$ docker-compose run --rm lein new hoplon spike-hoplon
Getting Startedの説明とは構成が異なりますが、以下のディレクトリ構造ができました。
$ cd ~/clojure_apps/spike-hoplon/
$ tree
.
├── README.md
├── build.boot
└── src
├── index.cljs.hl
└── main.inc.css
作成したプロジェクトはdocker-compose.ymlのworking_dirに指定します。
lein: &defaults
image: clojure
volumes:
- .:/usr/src/app
- ./m2:/home/docker/.m2
working_dir: /usr/src/app/spike-hoplon
boot1:
<<: *defaults
entrypoint: ["boot1"]
ports:
- "8000:8000"
アプリの起動
build.bootファイルではhoplonのバージョンが6.0.0-alpha2になっています。このまま起動するとjava.io.FileNotFoundExceptionが発生します。The getting started example doesn't seem to work. #64にあるissueのようにバージョンを5.10.25に下げます。
...
:dependencies '[[tailrecursion/boot.task "2.2.4"]
[tailrecursion/hoplon "5.10.25"]]
5.10.25のproject.cljは以下のようになっています。
(defproject tailrecursion/hoplon "5.10.25"
:description "Hoplon web development environment."
:url "http://github.com/tailrecursion/hoplon"
:license {:name "Eclipse Public License"
:url "http://www.eclipse.org/legal/epl-v10.html"}
:plugins [[lein-marginalia "0.7.1"]]
:dependencies [[io.hoplon.vendor/jquery "1.8.2-0"]
[org.clojure/tools.reader "0.8.5"]
[tailrecursion/javelin "3.6.3"]
[tailrecursion/castra "2.2.2"]
[clj-tagsoup "0.3.0"]
[org.clojure/core.incubator "0.1.2"]
[org.clojure/clojurescript "0.0-2234"]])
leinのhoplon-templateのhoplon.cljを読むとbuild.bootファイルの生成時にtailrecursion/hoplonのバージョンを設定しています。バージョンはancient-cljを使い、Mavenリポジトリから最新のバージョンを取得しているようです。
(def deps
'[tailrecursion/boot.core
tailrecursion/boot.task
tailrecursion/hoplon])
(defn latest-deps-strs [deps]
(mapv #(latest-version-string! % {:snapshots? false}) deps))
Hoplonは6.0.0-alpha1からBoot 2になり新しい書式のbuild.bootにあわせディレクトリ構造も変わっています。hoplon-templateが生成するbuild.bootはBoot 1の書式なのでビルドに失敗しています。leinのhoplon-templateを使わない方が良さそうですが、初めてなのでこのままBootのdevelopmentタスクを実行してJettyを起動してみます。
$ boot1 development
Docker Composeのrunコマンド使う場合は--service-portsフラグを付けて起動します。
$ docker-compose run --rm --service-ports boot1 development
Compiling Hoplon dependencies...
Jetty server stored in atom here: #'tailrecursion.boot.task.ring/server...
Compiling Hoplon pages...
• src/index.cljs.hl
Compiling ClojureScript...
2015-06-19 01:56:49.296:INFO:oejs.Server:jetty-7.6.8.v20121106
2015-06-19 01:56:49.369:INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:8000
↳ Elapsed time: 27.392 sec › 00:01:19
ブラウザーから起動を確認します。
