Dokku の概要

• Docker + Heroku の Buildpack を使って、VPS や EC2 に mini-heroku が作れる
• Buildpack を使うので自分でイメージを作る必要はない
• サーバにインストールして、クライアントから鍵を通せば git push するだけで実行環境ができてアプリケーションが起動する

Dokku の構成要素

• Dokku - Bash script
• Docker - Container runtime and manager
• Buildstep - Buildpack builder
• pluginhook - Shell based plugins and hooks
• sshcommand - Fixed commands over SSH
• Nginx, SSH, Git

Dokku のインストール

サーバで実行

$ wget -qO- https://raw.github.com/progrium/dokku/master/bootstrap.sh | sudo bash

クライアントで実行

• 鍵を通す

$ cat ~/.ssh/id_rsa.pub | ssh example.org "sudo sshcommand acl-add dokku banyan"

• デプロイしたいアプリケーションでリモートリポジトリの設定

$ git remote add example.org dokku@example.org:rails4-sample

• git push で Heroku と同じようにデプロイできる

$ git push example.org master

まず sshcommand の設定で

• SSH の authorized_keys にはログイン時に実行するコマンドを指定することができて、それを利用してdokku ユーザが ssh で接続すると常に dokku コマンドが叩かれるようになる

$ cat ~/.ssh/id_rsa.pub | ssh example.org "sudo sshcommand acl-add dokku banyan"

/home/dokku/.ssh/authorized_keys

command="FINGERPRINT=02:8d... NAME=banyan `cat /home/dokku/.sshcommand` $SSH_ORIGINAL_COMMAND",... ssh-rsa AAAAB3Nza...

$ cat /home/dokku/.sshcommand /usr/local/bin/dokku

これでメインの dokku スクリプトが実行される。

receive) APP="$2"; IMAGE="app/$APP" echo "-----> Cleaning up ..." dokku cleanup echo "-----> Building $APP ..." cat | dokku build $APP echo "-----> Releasing $APP ..." dokku release $APP echo "-----> Deploying $APP ..." dokku deploy $APP echo "=====> Application deployed:" echo " $(dokku url $APP)" echo ;;

dokku receive では4つのフローが実行されます。

• dokku cleanup
• dokku build
• dokku release
• dokku deploy

dokku cleanup

使われてないイメージやコンテナを消す

dokku build

build) APP="$2"; IMAGE="app/$APP"; CACHE_DIR="$DOKKU_ROOT/$APP/cache" id=$(cat | docker run -i -a stdin progrium/buildstep /bin/bash -c "mkdir -p /app && tar -xC /app") test $(docker wait $id) -eq 0 docker commit $id $IMAGE > /dev/null

パイプで docker のコンテナの中の /app にソースを inject して docker commit します。 またイメージは progrium/buildstep の Docker のイメージをベースにしています。

docker attach $id test $(docker wait $id) -eq 0 docker commit $id $IMAGE > /dev/null

その後、buildstep の build/builder というスクリプトが、このアプリケーションが何の言語かを調べて、各言語の buildpack を compile してコミットします。

dokku release

$ dokku config:set FOO=BAR

とかで設定してある ENV がある場合にコンテナに inject して、
コンテナを docker commit します。

id=$(cat "$DOKKU_ROOT/$APP/ENV" | docker run -i -a stdin $IMAGE /bin/bash -c "mkdir -p /app/.profile.d && cat > /app/.profile.d/app-env.sh") test $(docker wait $id) -eq 0 docker commit $id $IMAGE > /dev/null

dokku deploy

id=$(docker run -d -p 5000 -e PORT=5000 $DOCKER_ARGS $IMAGE /bin/bash -c "/start web")

ここで実際にコンテナが起動されます。これでアクセスできるようになりました :)

Dokku にある機能

• Plugins (PostgreSQL, Memcached, Redis...)
• SSL

Dokku 0.3.0 で予定されてる機能

(現在 2014/01/16 は v0.2.1)

• dokku-ps dokku ps:scale APP web=4 worker=1
• dokku-add-on heroku style addons.

まとめ

• Dokku の大まかな流れをみてきました。Docker と heroku の buildpack やその他のミドルウェアをシンプルに使いながら、小さな PaaS を実現していてコードを読んでいても面白いです。
• Dokku 動くけどバグはなかなか多いです。後方互換性のない変更も多いし Docker の変更も多く安定はしてない。
• Dokku よりも複雑なことがしたい場合 flynn というプロダクトがあり、現在開発中のようです。

参照URL

• http://progrium.com/blog/2013/06/19/dokku-the-smallest-paas-implementation-youve-ever-seen/
• http://off-the-stack.moorman.nu/2013-11-23-how-dokku-works.html
• http://git-scm.com/book/ch9-6.html