crystal

rubyライクに書ける
静的型付け
golangの有力対抗馬(だと思ってる)
コンパイルしてバイナリ実行

作るAPIはDBから引っ張ってきた情報を適当にJSONで返すものです．
今回はユーザの人数を返すだけのAPIを作ります．

golang

今回crystalで作った理由として，
普段Rubyを使ってる身としては，GolangはシンプルといえどもCっぽい感じが…
最初はgolangで書いていたけど，crystalで書きなおしてみると書きやすい！と感じたのでこちらで書いてみた．

crystalはかなりrubyっぽいので学習コストがとても低い．

あと，golangと違ってコア数を増やすことはできないらしい(将来対応する予定だとか)．

amethyst

フルスタックフレームワーク，railsっぽいもの．
今回はAPIサーバなのでこれを使う理由はなかったが，ルーティング周りをさくっと書きたかったので使うことに．

大体使わない場合と比べて処理速度は2/3程度になる．

パッケージのインストール

さくっと作っていきます．

$ mkdir api_sample
$ cd api_sample
$ touch Projectfile

Projectfileがrubyでいうgemfile
インストールを開始すると.deps.lockというファイルが作られ，バージョンが固定される．

必要なパッケージは以下の通り．

deps do
  github "will/crystal-pg"
  github "Codcore/amethyst"
  github "spalger/crystal-mime"
end

crystal depsでインストールされ，コード中のrequireによって読み込みを行います．

続いて，API部分を作っていきます．

今回は簡単な形で作っていますが，
コントローラなどを分けて，Railsっぽくも書けるようなので詳細は公式リポジトリのexampleを参照して下さい．

$ mkdir src
$ vim src/app.cr

require "amethyst"
require "pg"

DB = PG.connect("postgres://user@host:port/db_name")

class UsersController < Base::Controller
  actions :index

  def index
    result = DB.exec({Int32}, "SELECT count(id) FROM users")
    hash = Hash(String, Int32).new
    hash["users"] = result.rows[0].to_a.first
    json hash.to_json
  end 
end

class ApiApp < Base::App
  routes.draw do
    get "/api/v1/users", "users#index"
    register UsersController
  end 
end

app = ApiApp.new
app.serve

たったこれだけです．
users#indexの最後の行でformatをjsonにしてhashをto_jsonにして返すだけ．
非常にrubyに似ていて書きやすいです．

返却値はこんな感じになります．

{users:100}

あとは本番用にビルドして使うだけですね．

$ crystal build --release src/app.cr
$ ./app

本番用(ubuntu 14.04)で起きた問題

crystal-pgがエラーを吐いてしまう不具合がありました．
どうも過去にissueも立っているけど直っていないっぽい？

前のissueを読んでいると，postgresを9.4系にすれば動く模様．
ということでpostgresを9.4にした所，正常に動作するようになりました．

追記

このgemはpg_configのパラメタからlinkを決めているようなのですが，
色々調査をしていると，postgres9.3系と9.4系では以下の様な違いが有りました．

# postgres 9.3.9
INCLUDEDIR = /usr/include/postgresql
LIBDIR = /usr/lib

# postgres 9.4.4
INCLUDEDIR = /usr/include/postgresql
LIBDIR = /usr/lib/x86_64-linux-gnu

LIBDIRの場所が違っており，これを修正するだけでも動くのでは？と試してみたところ，
正常に動作するのでcrystal-pgを直接書き換えても動作するようです．

module PG
  @[Link(ldflags: "-lpq -I`pg_config --includedir` -L /usr/lib/x86_64-linux-gnu")]
  lib LibPQ

ファイルとしては，root/.deps/will-crystal-pg/src/pg/libpq.crにあります．

nginxの設定

簡単にこんな感じにしています．
crystalの中でAccess-Control-Allow-Originを設定する方法がわからなかったので，
今回はnginx内で行っています．

upstream crystal {
  server localhost:8080;
  keepalive 300;
}

server {
  location /api {
    access_log off;
    error_log /dev/null crit;
    add_header Access-Control-Allow-Origin *;
    proxy_pass http://crystal;
    proxy_http_version 1.1;
    proxy_set_header Connection ""; 
  }
}

golangとのベンチマーク

golangではginを使って同じものを作り，ベンチマークをしてみました．

ab -k -c 10 -n 10000 http://127.0.0.1/api/v1/users

lang	request/sec
crystal(amethyst)	2272.13
golang(gin)	1278.75

結構crystalが圧勝気味です．
ただし，全コア数を使うとgolangのほうが上回るかと思います．

上記はnginxを通していますが，通さず直にやってcrystalが2700req/sec程度の速度でした．
ちなみにrailsでやった場合は，200-300req/sec行かない(worker: 2-8)の速度です．

お手軽にこれだけ高速化できるなら，publicなAPIはcrystalで書き直すのも良いかもしれません．

一応リポジトリのサンプルとして少し形が違いますが，github上にも挙げているので参考にどうぞ．

rubyライクなcrystalでamethystを使ってAPIサーバを作る