AWS LambdaでGoを使うに当たっての基本的なことの紹介

1. AWS Lambda + Go
2017/06/16
シナジーマーケティング(株) 河野健太朗

2. 自己紹介
• 河野 健太朗
• シナジーマーケティング(株)
プロダクト開発部 所属
• Synergy! のマルチチャネル対応が主業務
• アプリプッシュ基盤構築
• Goで構築 → 軽量化したい
• LINE メッセージング基盤構築
• callback部分をGoで

3. AWS Lambda おさらい

4. AWS Lambda とは
• Function as a Service
• AWSのサービス上のイベントに対応
• 例) S3に画像がアップロードされたとき、リサイ
ズする
• Node.js、Java、C#、Pythonがサポートされている
• Lambda Function という単位で管理

5. Lambda Functionの例（Node.js）
exports.handler = (event, context, callback) => {
// Do Something
callback(null, 'Hello from Lambda');
};
// event: イベント情報
// context: ランタイム情報
// callback: 呼び出し元に情報を返すための関数

6. サポートされていないのに
なんでGoでやるの？

7. なんでGo?
• 標準の言語と比較して、遜色ないパフォーマンス
• 社内のライブラリが使用できる
• 慣れ
• コスト

8. GoでできることはGoでやりたい！！！

9. どうやってGoを使うか

10. Apexを使用する

11. Apex とは
• Lambda Functionを管理するツール
• 公式以外の言語もサポート
• Functionの実装に使えるライブラリも提供
• 実装、ビルド、デプロイを一貫して行える
• Node.jsのhandler + Goのバイナリを同梱してデプロイ

12. AWS Lambda 実行の仕組み（Apex+Go）
1. イベント発生
2. Lambda Functionをコンテナ上で起動
3. 規定のhandlerを呼び出す(Node.js)
4. Node.jsからspawnでmainを実行
• apexのhandlerを実行

13. Apex 基本コマンド
# プロジェクト初期化(IAM role, policyの作成)
$ apex init
# ビルドのみ
$ apex build > hello.zip
# ビルド、デプロイを実行
$ apex deploy
# functionのリスト（AWS上の情報も確認できる）
$ apex list

14. Apex ファイル構成
.
├── functions
│ ├── bot # ディレクトリ単位で管理
│ ├── function.json # functionごとの設定
│ └── main.go
├── .apexignore # 無視するファイルの設定
└── project.json # プロジェクト全体の設定

15. project.json
{
"name": "line-kensho",
"description": "lineの検証用",
"memory": 128,
"timeout": 5,
"role": "arn:aws:iam::...",
"environment": {},
"runtime": "golang"
}

16. function.json
{
"environment": {
"CHANNEL_SECRET": ”...",
"CHANNEL_TOKEN": ”..."
}
}
function.jsonの方が優先される

17. .apexignore
• gitignoreと同じ書式
• ビルドの際にzipの対象にしない
• *.go でソースコードを除外

18. Lambda Function の例（Apex+Go）
import "github.com/apex/go-apex"
func main() {
apex.HandleFunc(
func(e json.RawMessage, c *apex.Context) (interface{}, error) {
return "Hello from Lambda", nil
})
}
// json.RawMessage: イベント情報
// apex.Context: ランタイム情報
// return値: 呼び出し元に返す情報

19. 注意点

20. 注意点
• 標準出力の内容はFunctionの結果として扱う
• ログは標準エラー出力に
• 残りの稼働可能時間が取得できない
• environment はマネジメントコンソールで丸見え
• 認証情報はきちんと管理しないと…（検討中）

21. AWS API Gatewayとの連携

22. API Gatewayとの連携
• API GatewayでAPIを作成
• リソース、メソッドを定義
• integrationにLambda Functionを指定
• Proxyリソースとして連携する
• リクエストの情報がJSONで渡ってくる

23. API Gatewayと連携後の実装
type Request struct {
Body string `json:"body"`
Headers map[string]string `json:"headers"`
HTTPMethod string `json:"httpMethod"`
Path string `json:"path"`
PathParameters map[string]string `json:"pathParameters"`
QueryStringParameters map[string]string `json:"queryStringParameters”`
// ...他いろいろ...
}
func main() {
apex.HandleFunc(
func(e json.RawMessage, c *apex.Context) (interface{}, error) {
// ここでリクエストの情報を json.Unmarshalなどする必要がある => ツライ
})
}

24. github.com/fujiwara/ridge

25. ridge とは
• Apexをラップ
• net/http.Request, net/http.ResponsWriterが使える
• logパッケージが使える

26. ridgeでの実装
import "github.com/fujiwara/ridge"
func main() {
var mux = http.NewServeMux()
mux.HandleFunc("/", handleRoot)
ridge.Run(":8080", "/api", mux)
}
func handleHello(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "text/plain")
fmt.Fprintf(w, "Hello %sn", r.FormValue("name"))
}
// いつもどおりの実装でらくちん

27. ridgeでの注意点
• ridge.Run のprefixはAWS上では無効
• handlerを渡すときにStripする
// ridge.Run(":8080", ”/callback", handler)
stripped := http.StripPrefix("/callback", handler)
ridge.Run(":8080", "", stripped)

28. まとめ

29. まとめ
• AWS LambdaでもGoは使える
• Apexを使う
• API Gatewayと連携するならridgeを使う