AWS Lambda in Golang
•
6 gefällt mir•2,521 views
JAWS-UG沖縄 真夏の熱すぎるサーバレス祭り！ 2016年08月でお話した資料です。
Empfohlen
Weitere ähnliche Inhalte
Was ist angesagt?
Was ist angesagt? (20)
Andere mochten auch
Andere mochten auch (20)
Ähnlich wie AWS Lambda in Golang
Ähnlich wie AWS Lambda in Golang (20)
AWS Lambda in Golang
- 1. @k_nishijima AWS Lambda in Golang JAWS-UG沖縄 真夏の熱すぎるサーバレス祭り！ 2016年08月 @k_nishijima The Go gopher was designed by Renee French. (http://reneefrench.blogspot.com/) The design is licensed under the Creative Commons 3.0 Attributions license.
- 5. @k_nishijima あんた誰？ 5 西島 幸一郎 / にしじま こういちろう アールスリーインスティテュート ソリューションアーキテクト https://www.r3it.com 大阪の会社に所属、宜野湾の自宅から100%リモートワーク okinawa.goのコアメンバー JAWS−UG沖縄のコアメンバー ハッカーズチャンプルー実行委員長 ご質問などあればFacebook/Twitterなどでお気軽に〜♪ @k_nishijima nishijima.koichiro
- 6. @k_nishijima アジェンダ 6 ๏ AWSとGolangの関係をおさらい ๏ 利用ツールの紹介 ๏ 実際のLambda関数の書き方 ๏ 簡単なハンズオン
- 8. @k_nishijima AWSとGo言語 8 ๏ AWS SDK for Go あります https://aws.amazon.com/jp/sdk-for-go/ ๏ 新サービスにもかなりの勢いで追随してます https://github.com/aws/aws-sdk-go ๏ ただし今のところ公式にはLambdaの対応言語ではありません 【Node.js (JavaScript)、Python、および Java (Java 8 互換)】 https://aws.amazon.com/jp/lambda/faqs/
- 11. @k_nishijima 三種の神器：利用ツールの紹介 11 ๏ APEX : Lambda関数のデプロイ管理 http://apex.run/ https://github.com/apex/apex ๏ Simple API Gateway : API Gatewayの設定 https://github.com/horike37/simple-api-gateway ๏ Terraform : インフラの管理 https://www.terraform.io/
- 12. @k_nishijima 12 ๏ Lambda関数の管理に特化したツール ๏ 環境構築はTerraformを組み合わせて使うことを想定 ๏ Node.jsのshimの魔法によりGo言語の実行をサポート →このおかげでGoでLambdaが書ける！ APEX
- 13. @k_nishijima 13 ๏ 個人的にも支援中 ๏ コードで貢献したかったがGoスキルが足りず… ひとまずお金で支援することにした(^_^;) APEX
- 14. @k_nishijima Simple API Gateway 14 ๏ API Gatewayの設定をCLIで行うツール ๏ マネコンの設定画面は罠が多すぎるので… API作る際にはこれを利用して作るととても楽です
- 15. @k_nishijima Simple API Gateway 15 ๏ こっちはコードで貢献できた！
- 16. @k_nishijima 16 ๏ みんな大好きHashiCorp社謹製のインフラ管理ツール ๏ JSONライクな設定ファイルからインフラを自動生成/破棄 ๏ 組み合わせとしては、IAMの権限設定やLambda以外のリソース 管理に利用すると吉 Terraform
- 20. @k_nishijima 20 ๏ https://github.com/k-nishijima/lambda-handson- jawsug-okinawa-201608 ๏ infra以下にTerraformのtfファイル ๏ lambda以下にLambda関数のファイル ソースリポジトリ
- 21. @k_nishijima 21 ๏ Terraformで作られたAWSの環境（IAMロール、DynamoDB） ๏ API GatewayでホストされるWeb API ๏ Goで書かれたLambda関数（APEXでデプロイ） ๏ Goで書かれたコアライブラリ（AWSリソースを利用する実体） 全体構成 Goで書かれたLambdaSimple API Gatewayで設定 HTTPリクエスト Lambdaで動いてるところに API GatewayでHTTP経由で 呼び出すインターフェイス をつけるイメージ
- 22. @k_nishijima 実際の開発の流れ 22 1. Terraform でDB環境・IAM実行権限などを設定 2. Goでコーディング、テスト 3. APEXでLambda関数としてデプロイ 4. Simple API GatewayでAPI作成、デプロイ（はじめの1回だけ） 5. APIを叩いてテスト。OK? 問題があれば、2と3と5をぐるぐる繰り返す…
- 23. @k_nishijima 23 ๏ インストールは https://www.terraform.io/intro/getting-started/install.html ๏ リポジトリのinfraディレクトリのREADME.mdを確認の上、 “terraform apply" ๏ DynamoDBのテーブルとIAM Roleが作られる Terraformで環境構築
- 26. @k_nishijima この構成のメリット 26 ๏ コアライブラリ側の、通常のGo言語のコーディング・デバッグ でほとんど作業は完結する （Lambda関数としてのデバッグはほぼ不要） ๏ AWSのサービスを呼び出すものもローカルで完結 ๏ DynamoDB local、GoAws（未使用だけどSNS/SQSエミュレータ）
- 27. @k_nishijima コアライブラリのコーディング、テスト 27 ๏ https://github.com/k-nishijima/lambda-handson-golang-201608/ blob/master/dao.go ๏ 普通にGoでAWSを利用するコーディング （制約はさておき、Lambdaから呼ばれるからといって特殊なコーディ ングはない） ๏ HTTPリクエストを構造体経由で受け取る想定で書くと良い
- 29. @k_nishijima コアライブラリのコーディング、テスト 29 ๏ テストが終わったら、”go install” しておく ※これでAPEX管理下のLambdaから呼び出す準備が整う ๏ コアライブラリを改修したら 再度go installをお忘れなく
- 31. @k_nishijima APEXでプロジェクトひな形作成 31 ๏ $ apex -p lambda-handson-201608 init でプロジェクト雛形作成 （-pはプロジェクトを作るときに使うAWS profile名）。 ๏ Lambda関数の実行用ロールなんかも作ってくれる （が、今回はTerraformで作ったロールを使う）
- 32. @k_nishijima APEXでプロジェクトひな形作成 32 ├── functions │ └── hello │ └── index.js └── project.json ── 関数ディレクトリ ── ディレクトリ名が関数名suffix ── 実装 ── プロジェクト全体の設定ファイル ๏ Node.jsならそのままindex.jsをいじっていけば hello関数が出来上がる（が、今回は削除する）
- 33. @k_nishijima project.json重要 33 ๏ project.jsonはプロジェクト全体の設定ファイル ๏ name: 各関数のprefixになる ๏ メモリ量とかタイムアウトとかここで書ける ๏ Lambda関数実行時のroleもここで指定 ๏ 同じような書式で関数ごとの設定もfunction.jsonで可
- 35. @k_nishijima 実際のソース： イベントから構造体への変換 35 func main() { apex.HandleFunc(func(event json.RawMessage, ctx *apex.Context) (interface{}, error) { // リクエストを格納する構造体 var request lambdaHandson.AddValueRequest if err := json.Unmarshal(event, &request); err != nil { return nil, err }
- 36. @k_nishijima 実際のソース： json.Unmarshalするときに、JSONアノテーションが効く 36 type AddValueRequest struct { Stage string `json:"stage" valid:"required"` Email string `json:"email" valid:"email,length(1|512),required"` Message string `json:"message" valid:"length(1|1024),required"` } { "stage": "dev", "email": "foo@bar.com", "message": "hello golang"} まあunmarshalだけなら アノテーション書かなくても 大丈夫だけど・・・ JSONをレスポンスするとき アノテーション重要 リクエスト のJSON
- 37. @k_nishijima 実際のソース： validateはgovalidatorを使ってみました 37 type AddValueRequest struct { Stage string `json:"stage" valid:"required"` Email string `json:"email" valid:"email,length(1|512),required"` Message string `json:"message" valid:"length(1|1024),required"` } ๏ https://github.com/asaskevich/govalidator ๏ 他にも同種の便利なパッケージはあると思うので探してみて！
- 38. @k_nishijima 実際のソース： 実行したいメソッドを呼ぶ 38 err = dao.Put(request) if err != nil { return nil, err } ๏ Lambda関数側はほぼ定形的なコーディングとするように仕向け、 可能な限りシンプルにしておく ๏ Lambda上にロジックやら条件分岐やらを書き出すと・・・(^_^;)
- 39. @k_nishijima Lambda環境で動かす時のTIPS： 必要な権限の取り方 39 ๏ LambdaはIAM Roleを使って動くので、権限はAccessKeyなどを 指定などする必要はない = 「Profile指定とロール指定の両対応にしておくと便利」の件 ๏ このコードの実装では、Lambda関数が読む設定ファイルから、 Profileの指定を削除しておけばOK
- 41. @k_nishijima 41 $ apex -p lambda-handson-201608 deploy contact ๏ これで contact関数をデプロイ。 コードを修正してテストを通したらデプロイ、 そして確認。これを何度も繰り返す。 ๏ これをマネコンのGUIでやってたら死んじゃいます(^_^;) APEXでデプロイ
- 43. @k_nishijima APEXでLambda関数実行 43 $ apex -p lambda-handson-201608 invoke contact < request_contact.json ๏ JSONファイルを引数としてcontact関数をinvoke。 上手く動けばレスポンスが返ってくる。
- 45. @k_nishijima APEXで実行時ログを見る 45 $ apex -p lambda-handson-201608 logs contact ๏ 動かなかったりした時はログをチェック
- 51. @k_nishijima Simple API GatewayでAPI作成 51 ๏ インストールは “npm install -g simple-api-gateway” ๏ ES6のコードなのでNodeは4以上、 勿論AWS CLIも必要です。詳しくは https://github.com/horike37/simple-api-gateway
- 53. @k_nishijima 実際作ってみる 53 ๏ POST /contactにリクエスト投げると ๏ Lambdaが呼ばれてよろしく処理される ๏ そんなAPIを作りましょう
- 55. @k_nishijima 実際作ってみる 55 west-mbp:lambda-handson-jawsug-okinawa-201608 nishijima$ apigw create ? Please select Region for API Gatway ap-northeast-1 ? Please input API Name Handson API API Create Success!! Please action `apigw edit` and set up API
- 56. @k_nishijima 実際作ってみる 56 west-mbp:lambda-handson-jawsug-okinawa-201608 nishijima$ apigw edit ? Please select Region for API Gatway ap-northeast-1 ? Please select API Handson API ? Do you want to use an existing Resources on Handson APIor create a new one? Create A New Resouce ? Please select parent Resource / ? Please input Resouce Path contact ? Please select method POST ? Please select backend lambda function lambda-handson-jawsug-okinawa-201608_contact ? May I set enable CORS? Yes ? Set up mapping template? (y/N) y で、エディタが開くのでマッピングテンプレートを入れて ? Please edit mapping template Received ? May I create the API? Yes Create Success!! Resource and Method on Handson API API.
- 57. @k_nishijima マッピングテンプレートって何？ 57 ๏ Integration Requestに指定できる、URLパラメータ/パス パラメータ/HTTPヘッダなどをLambda関数のコードに渡す ためのテンプレート ๏ 想定するURLパラメータとともに、APIGWのステージやHTTP ヘッダなどをLambda関数に渡すことが出来る
- 58. @k_nishijima APIを作ったら、ステージ名をつけてデプロイ 58 west-mbp:lambda-handson-jawsug-okinawa-201608 nishijima$ apigw deploy ? Please select Region for API Gatway ap-northeast-1 ? Please select API Handson API ? Please input Stage Name dev Deploy success! Endpoint:https://あなたの.execute-api.ap-northeast-1.amazonaws.com/dev ๏ これでステージ「dev」のAPI完成。ステージ = 環境と言い換えてもOK。 ๏ ステージごとURLが発行されるので、まったく別の環境として利用可能。 ๏ Lambdaのエイリアスと連動したり、このコードの例のように環境変数と して扱ってプログラムの動作を切り替えたり、いろいろ利用できます。
- 59. @k_nishijima 呼び出してみる 59 $ curl -H "Content-Type: application/json" -X POST -d "email=curl@foo.com&message=hello world via curl" https://あなたのURL.execute-api.ap-northeast-1.amazonaws.com/dev/contact "ok"
- 61. @k_nishijima はじめに戻って： サーバレスアーキテクチャとは？ 61 ๏ Q: 開発は楽になった？ ๏ A: 1関数の責任範囲がとても狭くなるので、相対的に楽にな る。デバッグも楽。 また、とにかく繰り返しになるデプロイが楽なのがいい。
- 62. @k_nishijima はじめに戻って： サーバレスアーキテクチャとは？ 62 ๏ Q: スケールする感じする？ ๏ A: 極力ステートレスな実装にして、バックエンドのデータ ソースも速度で詰まらないDynamoDBなどを活用すれば、ス ケールしないほうがおかしい
- 63. @k_nishijima セッションとか クライアント側の状態管理は！？ 63 ๏ 何を言っとるんですか、時代は21世紀ですよ。 そんなものはありません（建前 ๏ JavaScriptでAWS SigV4を実装した話を聞きたいですか、 そうですか（イラネw
- 64. @k_nishijima おや、こんなのも… 64 ๏ A Go framework for AWS Lambda microservices http://gosparta.io/ ๏ 誰か試してLTしてくださいな(^^)/
- 65. @k_nishijima まとめ 65 ๏ AWS SDK for Go があるので AWSリソースを使ったLambdaを書くのはとても簡単
- 67. @k_nishijima まとめ 67 ๏ きっとAWS CLIがGoでリライトされる未来が来る！（来ないかもw ๏ それはどうでもいいとして(^_^;) 現状でまったく不満はないですが、公式にLambdaでサポートされ ると更に嬉しいですね！
- 68. @k_nishijima 68 Thank you so much! Any questions?