MicroServices & APIs
- 1. Cloud Next 2018 MicroServices & APIs
- 2. 自己紹介 twitter pospome 読み方 ポスポメ 職種 サーバサイドエンジニア 興味 クラス設計全般, DDD いわゆるアプリケーションアーキテクチャ ここら辺の技術に興味ある方は フォローしてくださると嬉しいです
- 4. 今回は以下の2つのセッションを取り上げる Microservices - Born and Raised (and Growing) on Gooble Cloud Designing Quality APIs
- 5. Microservices - Born and Raised (and Growing) on Gooble Cloud
- 14. Pizza Hut では使い分けている REST … 外部通信 gRPC … 内部通信（サービス間通信）
- 16. API管理の課題 ・API Key, JWT などのセキュリティ ・使い方とパフォーマンスの可視化 ・OpenAPI への統合
- 18. ESP によって REST API へのリクエストを Rest Server Container にプロキシする。 Rest Server Container はリクエストを gRPC に変換する。
- 19. 外部提供する gRPC のエンドポイントを Rest Server Container 経由で RestAPI として外部に提供できる
- 20. gRPC ↔ REST の変換は CloudEndpoints や gRPC- Gateway を利用せずに手作業でやっている。 ボイラーテンプレート気味なので改善していく予定。
- 21. UseCase: Store Location Service ・Cloud Datastore を採用 ・速い ・スケールする ・マルチリージョンによる高い可用性
- 24. Kubernetes にも高い可用性をもたせたい ・Cloud Load Balancing（Ingress） ・マルチリージョンによる高い可用性 ・地理的に近いクラスターの提供 ・動かないサービスを自動的に除外
- 25. 既存の GEK の Service = LoadBalancer は そのまま残している トラフィックが残っている & テストで利用するため
- 28. 概要 API設計の Tips
- 29. APIが直面する問題 ・変更の難しさ 既存のレガシーなソフトウェアは複雑である 変更は困難である ・統合の難しさ それぞれのAPIが独自の仕様を持つ それらを統合して特定の目的を達成するのは難しい
- 30. 解決方法 ・アプリケーションをまたがって統一されたAPI ・統一されたモデルの関係性 ・free of implementation assumptions 実装仮定からの開放(?)
- 32. APIのスタイル ・Entity Oriented いわゆるリソース指向な REST API APIはエンティティを持ち、 それに対する CRUD 操作を提供する
- 38. 解決方法 ・アプリケーションをまたがって統一されたAPI ・統一されたモデルの関係性 ・free of implementation assumptions 実装仮定からの開放(?) ↑ Entity Oriented な API が適している
- 39. Entity Oriented な API の問題 HTTP がベースなので、 HTTP Method による直感的な操作が可能である。 一方で “クエリ”, “バージョン” に関しては定義されてい ない。
- 40. クエリにおける失敗例と解決案
- 41. 例1 リソースの id = 12345 ということはわかるが、 どのように取得するのかは分からない。
- 42. 解決案 リソースの id にパスを含めることによって、 “どのように取得するのか?” を伝えることができる
- 43. 例2 ownerID は id = 12345 のリソースに対する親リソース である。 しかし、どのように owner リソースを取得するのかが分 からない
- 44. 解決案 ownerID ではなく、owner リソースに対する URL を指 定することによって解決できる。
- 46. バージョン
- 47. バージョンの種類 1. Entity Versioning エンティティのデータ構造が変わる 新エンティティ、旧エンティティが存在する 2. Format Versioning フィールド名のリネーム レスポンス構造の変更 エンティティ自体は1種類しかない 3. Historical Versioning Entity Version, FormatVersion を統合したバージョン 特定バージョンへの undo, redo に利用することができる ＊解釈が間違っているかもしれません
- 50. 例 レスポンスを受け取るクライアントが v1 を利用すると は限らない。 owner のみ v2 を利用したいかもしれない。
- 51. 例 owner には v2 が存在するが、 id のリソースには v2 が存在しないかもしれない。
- 54. 解決案 ・version-free な URI を用意する。 ・HTTP Header に “Accept-Version” を指定可能にす る。 ・オプションとして URL 内に version を含められるよ うにする。
- 55. gPRC vs REST ・gRPC スループットが高い コードを自動生成できるので楽 結合度の高いコンポーネント同士で利用する ・REST 将来的な変更に適用しやすい システム統合に強い 顧客に提供するのであれば REST にすべき
- 56. おわり