![自動テストコードイメージ
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]
};
}](https://image.slidesharecdn.com/20160219-160408110456/85/IoT-25-320.jpg)
IoTで何をやったか
- 2. 1 1. RaspberryPiでものを動かした話 2. Yii2でAPIを外付けした話 3. Swaggerを使った話 目次
- 3. ０．IoTといえば...? Webエンジニアにとっては • モノを作る • 回路を作る • 大量のデータ処理 2
- 4. ０．IoTといえば...? • モノを作る – タブレットPCを入れる筐体を設計、発注 • もう製品化できそう – 筐体を作って回路を入れて屋外に設置 • 進行中だけど、もうちょい時間がかかる • 回路を作る – 回路設計をして、機械に埋め込み、制御する • 進行中だけど、もうちょい時間がかかる 3
- 5. RaspberryPiでモノを動かした話 今回紹介するのは、もっと簡単なIoT ざっくり言うと • 今まで単体で動いていたモノに • RaspberryPiを繋ぎ込んで、 • インターネットに繋げました 4
- 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
- 22. SwaggerEditor • あくまでドキュメント作成ツールだが、簡単な 手動テストくらいはできる。 – 右側から定義に沿ったリクエストを投げられる • ただし、下記に注意 – 投げる場合にバリデーションが入るので、必須項 目をあえて入れずにエラーを見る、というのが面 倒 – 本命のリクエストを投げる前にOptrionsメソッドを 実行するので、対応させる必要がある。 21
- 23. SwaggerEditor • 全然使いこなせていないが、今紹介した使い 方だけでも結構便利 • 学習、準備にほとんどコストをかけずに導入 できる • 人にAPIのテストをお願いする時にも便利 22
- 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