Download as PDF, PPTX
![SDKの確認
■ goappの確認
■ dev_appserver.pyの確認
■ appcfg.pyの確認
$goapp version
go version go1.6.3 (appengine-1.9.46) darwin/amd64
$dev_appserver.py -h
usage: dev_appserver.py [-h] [-A APP_ID] [--host
HOST] [--port PORT]
...
$appcfg.py -h
Usage: appcfg.py [options] <action>
...](https://image.slidesharecdn.com/geagoweb-161126012945/85/GAE-Go-Web-14-320.jpg)
![Datastoreからデータを取得する
■ クエリで取得する
const k = "Person" // Kind名
q := datastore.NewQuery(k) // クエリの作成
q = q.Filter("Age >=", 20) // フィルター
q = q.Order("Age") // 並べ替え
var ps []*Person
keys, err := q.GetAll(c, &p) // すべて取得
if err != nil {/*エラー処理*/}
for i := range keys {
ps[i].ID = keys[i].IntID() // IDを設定
}](https://image.slidesharecdn.com/geagoweb-161126012945/85/GAE-Go-Web-37-320.jpg)
![このハンズオンでは
■ アカウントを作るのを省きます
● Google グループに入って頂きます
● このグループは私のGCPプロジェクトのメン
バーに設定されています
● [消しました]
あとで消します！
SNS拡散はダメ！](https://image.slidesharecdn.com/geagoweb-161126012945/85/GAE-Go-Web-46-320.jpg)
![GCPのコンソールを開く
■ プロジェクトを開く
● https://console.cloud.google.com
● 初めての場合は同意するを選ぶ
● プロジェクトを開く→さらに表示
● [project-id]を開く](https://image.slidesharecdn.com/geagoweb-161126012945/85/GAE-Go-Web-47-320.jpg)
![app.yamlの編集
■ プロジェクトIDとモジュールなどを設定
application: [project-id]
runtime: go
api_version: go1
module: モジュール名
version: main
handlers:
- url: /.*
script: _go_app
プロジェクトID
モジュール名
今回は重複を避けるため
モジュール名はtwitterアカウント
とかにしておいて下さい
バージョン](https://image.slidesharecdn.com/geagoweb-161126012945/85/GAE-Go-Web-48-320.jpg)
![デプロイする
■ デプロイしてみる
■ ダメだったら（一度だけ）
■ 開いてみる
● https://[modulename]-dot-[project-id].app
spot.com
$goapp deploy .
$rm $HOME/.appcfg_oauth2_tokens
$appcfg.py update --noauth_local_webserver .](https://image.slidesharecdn.com/geagoweb-161126012945/85/GAE-Go-Web-49-320.jpg)
Uploaded byTakuya Ueda
GAE/GoでWebアプリ開発入門
GDG石巻×GCPUG仙台 Devfest 2016で発表した資料です。 https://gdgishinomaki.connpass.com/event/43815/
GAE/GoでWebアプリ開発入門
- 1. GAE/Goで Webアプリ開発入門 2016/11/26（土） @GDG石巻×GCPUG仙台 Devfest 2016 The Gogopher was designed by Renee French. The gopher stickers was made by Takuya Ueda. Licensed under the Creative Commons 3.0 Attributions license.
- 2. 自己紹介 メルカリ／ソウゾウ 上田拓也 twitter: @tenntenn ■ Go歴/ GAE歴 Go：5〜6年くらい？ GAE：最近再開、GCPUG Tokyoのスタッフ ■ 業務 GAE/Goでメルカリアッテを作ってます Goのコミュニティを盛り上げる仕事 Gopherを描く仕事（LINEスタンプ）
- 3. アジェンダ ■ Go入門（30分） ● Goの特徴 ●Tour of Goをやってみよう ● Goを学習する方法 ■ GAE/Go入門（2時間） ● 開発環境を用意しよう ● ゲストブックを作ってみよう ● デプロイしてみよう
- 4.
- 5. Goの特徴 Googleが開発しているプログラミング言語 ■ 特徴 ● 強力でシンプルな言語設計と文法 ●並行プログラミング ● 豊富な標準ライブラリ群 ● 周辺ツールの充実 ● シングルバイナリ／クロスコンパイル
- 6. A Tour ofGo ■ Web上で行えるチュートリアル ● https://go-tour-jp.appspot.com ● 日本語版もある ● まずはBasicsとFlowControlをやってみよ う！
- 7.
- 8. 公式ドキュメント ■ パッケージドキュメント ● https://golang.org/pkg ●標準パッケージの使い方が書いてある ■ FAQ ● https://golang.org/doc/faq ● なぜGoに◯◯がないのか？など ■ 言語仕様 ● https://golang.org/ref/spec 公式ドキュメントを読もう！！
- 9. Playground ■ Go Playground ●http://play.golang.org/ ● Web上でGoを実行できる ● Share機能で、SNSで共有したり質問する
- 10. その他 ■ コミュニティ ● GophersSlack #japan ● Google+ Golang JP ■ Qiita ● Goタグでまとまっている ● Go言語の初心者が見ると幸せになれる場所 ■ 書籍 ● プログラミング言語Go ● Go in Action ● みんなのGo言語
- 11.
- 12. Google App Engine（GAE） ■ Google が提供するPaaS ● 高いスケーラビリティ ● メンテナンスコストが低い ■ スタンダード環境とフレキシブル環境 ● スタンダード環境 ○ 従来からあるGAEの環境、SEとも ○ Go、Java7、Python 2.7、PHPが使える ○ インスタンスの起動が恐ろしく早い ● フレキシブル環境 ○ 旧MVMs、FEとも ○ 実際はGCE上で動いている ○ Go、Java8、Python 2.7/3.4、Node.js、Ruby
- 13. SDKのインストール ■ 公式サイトからダウンロード ● https://cloud.google.com/appengine/docs/ go/download ●WindowsはPython2.7も必要 ○ すでにPython 3.x系が入ってる場合は注意 ■ zipファイルの展開 ● ダウンロードしたzipをホーム以下に展開 ■ PATHの設定 ● go_appengineにPATHを通す $ export PATH=$HOME/go_appengine:$PATH
- 14. SDKの確認 ■ goappの確認 ■ dev_appserver.pyの確認 ■appcfg.pyの確認 $goapp version go version go1.6.3 (appengine-1.9.46) darwin/amd64 $dev_appserver.py -h usage: dev_appserver.py [-h] [-A APP_ID] [--host HOST] [--port PORT] ... $appcfg.py -h Usage: appcfg.py [options] <action> ...
- 15. ゲストブックを作ろう ■ GAE/Goの公式チュートリアル ● https://cloud.google.com/appengine/docs/ go/getting-started/creating-guestbook ●1ステップごとに学習できる ● httpパッケージの学習 ● html/templateパッケージの学習
- 16. 手元で動かしてみる ■ ソースコードのクローン ■ ローカルサーバで動かす $gitclone https://github.com/GoogleCloudPlatform/appengine-g uestbook-go $git fetch $git checkout part4-usingdatastore $goapp serve http://localhost:8080 をブラウザで開こう 止める際はCtrl+C
- 17. Hello, World ■ Part1を動かしてみる ■ファイル構成 $git checkout part1-helloworld $goapp serve $tree . . ├── app.yaml └── hello.go
- 18. app.yaml ■ アプリケーションの設定ファイル runtime: go api_version:go1 handlers: - url: /.* script: _go_app すべてのリクエストをGoで処理 ルーティングやログインの有無など を設定することができる
- 19. hello.go ■ init関数 func init(){ http.HandleFunc("/", handler) } パッケージで最初に呼ばれる関数 /というパターンのパスで来たリクエストを ハンドリングする関数を登録 GAE/Goではmain関数は使用しない
- 20. hello.go ■ ハンドラ func handler(whttp.ResponseWriter, r *http.Request) { fmt.Fprint(w, "Hello, world!") } レスポンスを書き込むWriter GAE/GoとGo標準でやり方は同じ！ リクエスト レスポンスとして "Hello, world！"を返している
- 21. ユーザ情報の取得 ■ Part2を動かしてみる ■ ファイル構成 $gitcheckout part2-usingusers $goapp serve $tree . . ├── app.yaml └── hello.go
- 22. コンテキストの取得 ■ コンテキストの取得 ■ コンテキストとは？ ●GAEのAPIを使うのに必要 ● 第1引数に渡すことが多い ● 基本的にラップして情報を付加するので、構 造体のフィールドなどには記録しない c := appengine.NewContext(r) rはリクエスト
- 23. コンテキストの種類 ■ appengine.Context ● 初代コンテキスト ●Goの標準とは関係ない ■ golang.org/x/net/context.Context ● Go1.6までのGo準標準のコンテキスト ● 最近のGAEで使用されている ○ google.golang.org/appengine ■ フレキシブル環境対応がされたラッパー ■ context.Context ● Go1.7からのGo標準のコンテキスト ● 現在GAEはGo1.6なので使えない 今回はこれを使う GAEの主流はこれ Goの主流はこれ 時代の流れ
- 24. ユーザ情報の取得 ■ Googleのユーザ情報の取得 ■ ログインURLの取得とリダイレクト u:= user.Current(c) cはコンテキスト url, err := user.LoginURL(c, r.URL.String()) if err { /* エラー処理 */ } w.Header().Set("Location", url) w.WriteHeader(http.StatusFound) リダイレクト http.Redirectを使っても大丈夫
- 25.
- 26. ユーザ入力を受け付ける ■ Part3を動かしてみる ■ ファイル構成 $gitcheckout part3-handlingforms $goapp serve $tree . . ├── app.yaml └── hello.go
- 27. ユーザ入力を受け付ける ■ リクエストからFormデータを取得する func handler(whttp.ResponseWriter, r *http.Request) { v := r.FormValue("myvalue") fmt.Fprint(w, v) } <form action="/post" method="post"> <input type="text" name="myvalue"> <input type="submit" value="post"> </form> Go HTML POSTで送られた 値を取得できる
- 28. HTMLの表示 ■ ResponseWriterにHTMLを書き込む func root(whttp.ResponseWriter, r *http.Request) { fmt.Fprint(w, guestbookForm) } const guestbookForm = ` <html> ... </html> ` HTMLを書き込めばブラウザが HTMLをレンダリングしてくれる
- 29. テンプレートエンジンの利用 ■ html/templateを使う ● Go標準のテンプレートエンジン ●text/templateのhtml特化版 ■ テンプレートの生成 ■ テンプレートに埋め込む template.New("sign").Parse(signTemplateHTML) テンプレート名 HTML template.Mustはエラーを panicに変換する関数 signTemplate.Execute(w, r.FormValue("content")) リクエストから貰った値を埋め込む
- 30. よく使うテンプレートの記法 ■ その文脈でトップレベルのデータを埋め込む ■ フィールドやメソッド ■条件分岐 ■ 繰り返し {{.}} {{.Filed}} {{.Method arg1 arg2}} {{if .}}{{.Filed}}{{else}}NO{{end}} {{range .}}{{.}}{{end} rangeの中の {{.}}は要素になる
- 31. データの埋め込み ■ HTMLにリクエストの値を埋め込む const signTemplateHTML= ` <html> <body> <p>You wrote:</p> <pre>{{.}}</pre> </body> </html> ` signTemplate.Execute(w, r.FormValue("content")) ここに埋め込まれる
- 32. Datastoreを使う ■ Part4を動かしてみる ■ ファイル構成 $gitcheckout part4-usingdatastore $goapp serve $tree . . ├── app.yaml ├── hello.go └── index.yaml
- 33. Datastoreについて ■ Cloud Datastoreとは？ ●Googleの提供するKey-Valueストア ■ 各種用語のRDBとの対応 概念 Cloud Datastore RDB オブジェクトのカテゴリ Kind Table 1つのオブジェクト Entitiy Row 1つのオブジェクト各データ Property Field オブジェクトに対するユニークなID Key Primary Key
- 34. Kindと構造体 ■ Kindを表す構造体を作る type Personstruct { ID int64 `datastore:"-"` Name string `datastore:"name"` Age int `datastore:"age"` } 構造体のフィールドが Kindのプロパティに対応 structタグでDatastore上の プロパティ名を指定 `datastore:"-"`にすると Datastoreのプロパティにはしない structタグを省略すると フィールド名がそのままプロパティ名になる
- 35. Datastoreにデータを保存する ■ Incompleteなキーを作る ■ 保存する constk = "Person" // Kind名 key := datastore.NewIncompleteKey(c, k, nil) 親のキーコンテキスト p := &Person{Name:"A", Age:30} newkey, err := datastore.Put(c, key, p) if err != nil {/*エラー処理*/} p.ID = newKey.IntID() エンティティのIDの入った完全なキー
- 36. Datastoreからデータを取得する ■ キーを指定して取得する const k= "Person" // Kind名 nID := 100 sID := "" key := datastore.NewKey(c, k, sID, nID, nil) var p Person err := datastore.Get(c, key, &p) if err != nil {/*エラー処理*/} p.ID = key.IntID() どちらかを指定する 複数一気に取得する場合は GetMultiを使う
- 37. Datastoreからデータを取得する ■ クエリで取得する const k= "Person" // Kind名 q := datastore.NewQuery(k) // クエリの作成 q = q.Filter("Age >=", 20) // フィルター q = q.Order("Age") // 並べ替え var ps []*Person keys, err := q.GetAll(c, &p) // すべて取得 if err != nil {/*エラー処理*/} for i := range keys { ps[i].ID = keys[i].IntID() // IDを設定 }
- 38. 結果整合性と強い整合性 ■ 結果整合性 ● 更新結果が必ずしも即時読み取り処理に反 映されない ●スケールしやすい ■ 強い整合性 ● 更新結果が即時次の読み取り処理に反映さ れる ● スケールしにくい 参考 ：https://cloud.google.com/datastore/docs/articles/balancing- strong-and-eventual-consistency-with-google-cloud-datastor Cloud Datastoreは 選ぶことができる
- 39.
- 40.
- 41. Datastoreと結果整合性・強い整合性 ■ Cloud DatastoreAPIと整合性の関係 Cloud Datastore API エンティティの読み取り インデックスの読み取り グローバルクエリ 結果整合性 結果整合性 キーのみのグローバルクエリ なし 結果整合性 Ancestorクエリ 強い整合性 強い整合性 キーによる検索（get） 強い整合性 なし Ancestorクエリを 使うと強い整合性が実現できる 参考 ：http://www.slideshare.net/enakai/google-cloud-datastore-insid eout?ref=https://gcpja.connpass.com/event/44024/presentation
- 42.
- 43. Ancestorクエリ ■ 祖先キーを指定してAncestorクエリを実行 // 祖先キーの作成=> guestbookKey() const akind = "Guestbook" const asid = "default_guestbook" akey := datastore.NewKey(c,akind,asid,0,nil) q := datastore.NewQuery("Greeting") q = q.Ancestor(akey).Order("-Date").Limit(10) Ancestorクエリになる＝強い整合性
- 44. エンティティグループへの更新 ■ 祖先キーを指定してPutを実行 // 祖先キーの作成=> guestbookKey() const akind = "Guestbook" const asid = "default_guestbook" akey := datastore.NewKey(c,akind,asid,0,nil) const kind = "Greeting" key := datastore.NewIncompleteKey(c,kind,akey) newkey, err := datastore.Put(c, key, &g) 同一エンティティグループへの 更新は1回／秒の制限がある
- 45.
- 46. このハンズオンでは ■ アカウントを作るのを省きます ● Googleグループに入って頂きます ● このグループは私のGCPプロジェクトのメン バーに設定されています ● [消しました] あとで消します！ SNS拡散はダメ！
- 47. GCPのコンソールを開く ■ プロジェクトを開く ● https://console.cloud.google.com ●初めての場合は同意するを選ぶ ● プロジェクトを開く→さらに表示 ● [project-id]を開く
- 48. app.yamlの編集 ■ プロジェクトIDとモジュールなどを設定 application: [project-id] runtime:go api_version: go1 module: モジュール名 version: main handlers: - url: /.* script: _go_app プロジェクトID モジュール名 今回は重複を避けるため モジュール名はtwitterアカウント とかにしておいて下さい バージョン
- 49. デプロイする ■ デプロイしてみる ■ ダメだったら（一度だけ） ■開いてみる ● https://[modulename]-dot-[project-id].app spot.com $goapp deploy . $rm $HOME/.appcfg_oauth2_tokens $appcfg.py update --noauth_local_webserver .
- 50. Thank you! twitter: @tenntenn Qiita:tenntenn connpass: tenntenn