IoTで何をやったか

1. 0
IoTで何をやったか
エスキュービズム・テクノロジー
エンジニア勉強会
February 19,2016
S-cubism Technology Inc.

2. 1
1. RaspberryPiでものを動かした話
2. Yii2でAPIを外付けした話
3. Swaggerを使った話
目次

3. ０．IoTといえば...?
Webエンジニアにとっては
• モノを作る
• 回路を作る
• 大量のデータ処理
2

4. ０．IoTといえば...?
• モノを作る
– タブレットPCを入れる筐体を設計、発注
• もう製品化できそう
– 筐体を作って回路を入れて屋外に設置
• 進行中だけど、もうちょい時間がかかる
• 回路を作る
– 回路設計をして、機械に埋め込み、制御する
• 進行中だけど、もうちょい時間がかかる
3

5. RaspberryPiでモノを動かした話
今回紹介するのは、もっと簡単なIoT
ざっくり言うと
• 今まで単体で動いていたモノに
• RaspberryPiを繋ぎ込んで、
• インターネットに繋げました
4

6. 機器構成イメージ
もともと動いていたシステムの
入力装置と制御装置を
5
※画像はイメージです

7. 機器構成イメージ
切り離してRaspberryPiに接続
6
※画像はイメージです

8. 機器構成イメージ
通信はRS-232Cで行う
7
※画像はイメージです

9. 機器構成イメージ
RaspberryPiは有線LANでインターネット接続
8
※画像はイメージです

10. プログラムイメージ (Ruby)
9

11. プラス１の知識で始められるIoT
今回、Webプログラマに馴染みのないのは
RS-232Cによるシリアル通信くらい
あとは普通のWebAPIとLinuxで走るスクリプト
-> IoT向けの技術は色々あるが、
別に全部使わなくてもIoTはできる
10

12. 2. Yii2でAPIを外付けした話
• サーバサイドはEC-Orange(OrangeDB)ベー
ス
– ECからPOSのサーバまで、1台で何でもできる
Webアプリ
• 下記が課題
– 巨大化、複雑化してメンテコストが高い
– 古いフレームワークでつらい
11

13. 対策
• 巨大化、複雑化してメンテコストが高い
-> マイクロサービス化して細分化
• 古いフレームワークでつらい
-> 最新のフレームワークyii2を使おう
12

14. マイクロサービス化
• いきなり全部マイクロサービス化は無理
– 今回開発した機能は独立性が高く、
– マイクロサービス化可能だった
• いきなりマイクロサービスはハードルが高い
– なんちゃってマイクロサービスから始める
13

15. なんちゃってマイクロサービス
• 構築時の設定でのみで、または僅かなコード
修正でマイクロサービスとしても動く
• 実際には、メインシステムのモジュールとして
動く
-> サーバ管理コストは増えない
-> コードの独立性というメリットは教授できる
14

16. Yii2を利用する
• EC-Orangeでは既にyii1を使っているのでは
？
– ActiveRecord回りの出来が良くなった。
– NameSpaceとかphpの最新機能を活用できる
– yii1のExtensionは微妙なのが多い（イメージ）
• 既に社内にテンプレートプロジェクトがある
15

17. 実際の構築方法
• 社内用yii2プロジェクトテンプレートをベース
に、APIの独自リポジトリを作成
– サーバ構築は、普通のEC-Orange+α
– リポジトリを準備後、シンボリックリンクを貼るだけ
– DBは同じものを参照
• ぶっちゃけ、単にリポジトリを分けただけ
16

18. 3. Swaggerを使った話
下記をやりたかった
• 実装中、確認のために適当にリクエストを
投げたい
• 一応ドキュメントを残しておきたい
• 自動テストしたい
17

19. Swaggerとは？
• APIドキュメントを作成するツール群
• 実装のコメントから自動でドキュメントを生成
したり、ドキュメントからモックサーバを生成し
たり
• 今回は、swagger-editorのみを使った
• あまり調べられてないので、適当な使い方を
してます
18

20. SwaggerEditorを使てみる
• ここにアクセス
– http://editor.swagger.io/#/
• または、下記コマンドでローカルに立てる
– git clone https://github.com/swagger-
api/swagger-editor.git
– cd swagger-editor
– npm start
19

21. SwaggerEditor
左側の領域にyamlで定義を書き
右側にドキュメントが自動的に作成される
ドキュメントで定義に沿ったリクエストを投げられる
20

22. SwaggerEditor
• あくまでドキュメント作成ツールだが、簡単な
手動テストくらいはできる。
– 右側から定義に沿ったリクエストを投げられる
• ただし、下記に注意
– 投げる場合にバリデーションが入るので、必須項
目をあえて入れずにエラーを見る、というのが面
倒
– 本命のリクエストを投げる前にOptrionsメソッドを
実行するので、対応させる必要がある。
21

23. SwaggerEditor
• 全然使いこなせていないが、今紹介した使い
方だけでも結構便利
• 学習、準備にほとんどコストをかけずに導入
できる
• 人にAPIのテストをお願いする時にも便利
22

24. 自動テスト
• Swaggerはテストまではサポートしていない
• レスポンススキーマ定義はJsonSchemaなの
で手動で自動テストを作成してみた
mochaをベースに、yaml読み込みモジュール
を使ってswagger.yamlを読み込み、レスポンス
がスキーマに合致するかテスト
23

25. 自動テストコードイメージ
24
describe('Model一覧', function() {
it ('一覧が取得できる', function(done) {
api.get("/v1/models", {}, function (error,
response, body) {
console.log(body);
expect(body).to.be.jsonSchema({
type: 'array',
items: schema.get('Model')
});
done()
});
});
});
yaml = require('js-yaml');
fs = require('fs');
exports.SchemaManager = function() {
// swaggerで定義したモデルのjson
schemaを持ってくる
this.get = function (schemaName) {
var swagger = yaml.safeLoad(
fs.readFileSync(__dirname +
'/../../docs/swagger.yaml', 'utf8'));
return
swagger.definitions[schemaName]
};
}

26. まとめ
• RaspberryPiでモノを動かした
– 今までのWebの知識+シリアル通信の知識だけ
で作れる
• Yii2でAPIを外付けしてみた
– 大きな変更を加えずに、マイクロサービス風に作
れる
• SwaggerでAPIドキュメントを書いてみた
– ほとんど学習コストなしでドキュメントを作れる
25