gcp ja night #27 Google Cloud Endpoints with Golang

1. Google Cloud Endpoints
with Golang

4. @soundTricker318
http://goo.gl/ZpUOs

5. どこの人？

6. http://www.bfts.co.jp

7. 何やってる？

9. https://www.flickr.com/photos/centralasian/ (CC)
電
車
プ
ロ
グ
ラ
マ

10. 話す事
http://creativecommons.org/licenses/by/3.0/us
https://github.com/mholt/golang-graphics/blob/master/official/talks.png

11. Google Cloud Endpoints
with
Golang

12. Google
Cloud
Endpoints

13. https://developers.google.com/appengine/docs/java/endpoints/
What?
Google
Cloud
Endpoints?

14. https://developers.google.com/appengine/docs/java/endpoints/
What?
Google
Cloud
Endpoints?
AppEngine上に
バックエンドAPIを
簡単に作成する仕組

15. https://developers.google.com/appengine/docs/java/endpoints/
What?
Google
Cloud
Endpoints?
作成したAPIに対する
クライアントライブラリを
自動生成

16. 使える言語
Google
Cloud
Endpoints?
サーバサイド

17. 使える言語
Google
Cloud
Endpoints?
サーバサイド
Python
Pythonで
Cloud Endpointsの
事例をあまりみないので
どっかLTとかするとウケそう

18. 使える言語
Google
Cloud
Endpoints?
サーバサイド
Java
事例もよく見るので
始めるのは楽かも
JAX-RSに似てる
でも結構違う
http://www.flickr.com/photos/andypiper/

19. 使え…..
Google
Cloud
Endpoints?
サーバサイド
PHP
過去にDeveloper Liveで
簡単なバージョンが実装されるも
その後詳細不明…
https://www.youtube.com/watch?v=yue4
rcGJU

20. 使える言語
Google
Cloud
Endpoints?
サーバサイド
Go
Googleが
直接サポートしているわけではなく、
サードパーティフレームワークを
使う(後述) 個人的には好き
http://www.flickr.com/photos/andybons/

21. 使える言語
Google
Cloud
Endpoints?
クライアント

22. クライアント
Google
Cloud
Endpoints?
自動生成ライブラリ
Android
Cloud Endpointsと
触ったことが無い( ｰ`дｰ´)ｷﾘｯ
https://www.flickr.com/photos/etnyk/

23. クライアント
Google
Cloud
Endpoints?
自動生成ライブラリ
iPhone
持ってない( ｰ`дｰ´)ｷﾘｯ
https://www.flickr.com/photos/reticulating/

24. クライアント
Google
Cloud
Endpoints?
自動生成ライブラリ
JavaScript
自動生成できる、
Google API client for JavaScript経由で
利用時に作成されたものが使える
感じ？
No
Image

25. クライアント
Google
Cloud
Endpoints?
自動生成ライブラリ
Dart
サードパーティ製
Dartを含めて自分で好きな言語の
クライアントLibrary Genは作れる

26. Google
Cloud
Endpoints
T

27. サーバサイド
Google
Cloud
Endpoints
T

28. サーバサイド
Google
Cloud
Endpoints
T
環境
• Appengine Go SDK
• MacユーザはbrewからでもOK
• 最近はGoogle Cloud SDK推奨
$ curl
https://dl.google.com/dl/cloudsdk/release
/install_google_cloud_sdk.bash | bash

29. サーバサイド
Google
Cloud
Endpoints
T
ライブラリインストール
• go-endpointsを使います
• Cloud Endpoinsフレームワーク
$ go get github.com/crhym3/go-
endpoints/endpoints
※インストール時にエラーが出ますが気にしないでください。

30. サーバサイド
Google
Cloud
Endpoints
T
ライブラリインストール(非必須)
• Datastore周りはgoonがオヌヌメ
• NDBみたいなもの
$ go get github.com/mjibson/goon
※インストール時にエラーが出ますが気にしないでください。

31. サーバサイド
Google
Cloud
Endpoints
T

32. サーバサイド
Google
Cloud
Endpoints
T
実装
• 4段階
1. 通信用構造体を作成
2. サービス(実処理部)を作成
3. サービスを登録
4. app.yamlを登録
• 詳しくは↓ or →
http://goo.gl/gBrZAD

33. サーバサイド
Google
Cloud
Endpoints
T
通信用構造体(struct)を作成
• go-endpointsが自動で
JSON←→Struct変換してくれます。

34. サーバサイド
Google
Cloud
Endpoints
T
通信用構造体(struct)を作成
Datastore格納兼JSON通信用

35. サーバサイド
Google
Cloud
Endpoints
T
通信用構造体(struct)を作成
JSON Arrayでやりとりする場合は別の構
造体が必要

36. サーバサイド
Google
Cloud
Endpoints
T
通信用構造体(struct)を作成
QueryString、URL ParamもStructで表現
注釈を付けれる

37. サーバサイド
Google
Cloud
Endpoints
T
サービス(実処理)を作成
• 単純なメソッドを定義します。
• go-endpointsが変換したstructを
引数に渡してくれます。

38. サーバサイド
Google
Cloud
Endpoints
T
サービス(実処理)を作成

39. サーバサイド
Google
Cloud
Endpoints
T
脇道:goon
• goonはGo版NDBみたいなもの
• GAE/GのDatastore周りを楽にしてく
れる
• Key系の検索は全てin-memory,
Memcacheにキャッシュ/検索

40. サーバサイド
Google
Cloud
Endpoints
T
脇道:goon
goon無し

41. type Group struct {
Id int64 `datastore:"-" goon:"id"`
Name string
}
n := goon.NewGoon(r)
g := &Group{Name: "name"}
err := n.Put(g)
サーバサイド
Google
Cloud
Endpoints
T
脇道:goon
goon有り

42. サーバサイド
Google
Cloud
Endpoints
T
サービスを登録
• サービスをgo-endpontsに登録

43. サーバサイド
Google
Cloud
Endpoints
T

44. サーバサイド
Google
Cloud
Endpoints
T
app.yamlで設定
• go-endpontsが動くようにします。
application: gpc-ja-night-27-go-endpoints
version: v1
runtime: go
api_version: go1
handlers:
- url: /.*
script: _go_app
# ここが絶対に必要
- url: /_ah/spi/.*
script: _go_app

45. サーバサイド
Google
Cloud
Endpoints
T
起動
• appengine go SDK経由
$ goapp serve

46. サーバサイド
Google
Cloud
Endpoints
T
テスト
• http://localhost:8080/_ah/api/explor
er
とかに行けば試せる

47. サーバサイド
Google
Cloud
Endpoints
T
テスト

48. サーバサイド
Google
Cloud
Endpoints
T
リリース
• goapp deployでリリース
$ goapp deploy

49. Google
Cloud
Endpoints
T
http://goo.gl/248Dh3

50. 使い所?
Google
Cloud
Endpoints
T
メリット
• 爆速スピンアップ
• 処理に集中できる
• テストしやすい気がする