Lambda + Apex 事例紹介
全ては AWS コスト削減のために
@kakakakakku
2017.03.10 社内勉強会

Yoshiaki Yoshida ( @kakakakakku )
‣ Makuake : CyberAgent Crowd Funding, Inc.
‣ Web Operations Engineer 兼 技術広報
‣ AWS, Ruby, Certified Scrum Master
‣ プログラミング講師の仕事を始めました
‣ http://kakakakakku.hatenablog.com/

＼ 最近 CyberAgent Developers Blog に記事出してます ／
https://developers.cyberagent.co.jp/blog/archives/4079/
https://developers.cyberagent.co.jp/blog/archives/4900/

＼ ポッドキャストデビューしました ／
http://lean-agile.fm/episode/22

使ってますか？
AWS Lambda

開発環境の
AWS コスト削減に使ってます

？？？
開発環境の
AWS コスト削減に使ってます

AWS Well-Architected Framework

AWS Well-Architected Framework
Cost Optimization Pillar
Time-based approach
Examples of a time-based approach include following
the sun, turning off Development and Test
instances over the weekend, following
quarterly or annual schedules (e.g., Black Friday).

AWS Well-Architected Framework
Cost Optimization Pillar
簡単に言うと
Time-based approach
Examples of a time-based approach include following
「週末は開発用インスタンスを止めよう」
the sun, turning off Development and Test
instances over the weekend, following
quarterly or annual schedules (e.g., Black Friday).

Mon
Tue
Wed Thu
Fri
Sat
Sun
00:00
09:00
24:00

Mon
Tue
Wed Thu
Fri
Sat
Sun
00:00
09:00
1 Instance : 93 hours / week
削減してます
24:00

アーキテクチャ紹介

[実行フロー]
2. メンテナンス on / off
1. cron 実行
3. start / stop
EC2
CloudWatch
Lambda
Events
EC2
EC2

[実行フロー]
2. メンテナンス on / off
1. cron 実行
3. start / stop
EC2
CloudWatch
Lambda
Events
EC2
EC2

インスタンスを操作する
params に InstanceIds を設定して
‣ AWS SDK for JavaScript
複数インスタンスを操作する
‣ startInstances(params = {}, callback)
‣ stopInstances(params = {}, callback)
‣ 1 Lambda Function でイベントごとに処理を分岐している
‣ { "action": start" } → インスタンス起動
‣ { "action": stop" } → インスタンス停止

[実行フロー]
2. メンテナンス on / off
1. cron 実行
3. start / stop
EC2
CloudWatch
Lambda
Events
EC2
EC2

モニタリン
だけじゃない
グ
よ？
AWS CloudWatch Events

スケジューリング実行
‣ 脱 Jenkins したい
‣ AWS CloudWatch Events
‣ cron 式で設定したスケジューリングで Lambda を起動できる
‣ 要注意ポイント
‣ 1. cron 式
‣ 2. UTC 前提

cron 式
分 時間 日 月 曜日 製造年
0 0 ? * MON-FRI *
製造年 ?
* * はエラーになる
片方を ? にする必要がある

UTC 前提
日本時間 火水木金土 00:00
stopInstances()

Mon
Tue
Wed Thu
Fri
Sat
Sun
00:00
09:00
24:00

UTC 前提
日本時間 火水木金土 00:00
stopInstances()
0 15 ? * MON-FRI *
直感的に理解しにくい 😱

[実行フロー]
2. メンテナンス on / off
1. cron 実行
3. start / stop
EC2
CloudWatch
Lambda
Events
EC2
EC2

ど
デプ うやっ
ロイす て
る？
AWS Lambda

[実行フロー]
2. メンテナンス on / off
1. cron 実行
3. start / stop
EC2
CloudWatch
Lambda
Events
EC2
3. apex deploy
1. merge
2. hook
EC2
[デプロイフロー]

Apex
‣ Lambda 管理ツール（ビルド＆デプロイ）
‣ 関連 : Serverless Framework, Lamvery, AWS SAM など
‣ Lambda に特化しているため非常に薄く実装されている
‣ ドキュメントも充実している
‣ Terraform 連携
‣ `apex infra` コマンドは `terraform` コマンドのラッパー

Apex コマンド紹介
‣ apex init - 初期化する（IAM Role と IAM Policy の自動生成も含む）
‣ apex deploy - Lambda Function をデプロイする
‣ apex invoke - Lambda Function を実行する
‣ apex logs (-f) - CloudWatch Logs を確認する
‣ apex docs - ドキュメントを参照する

Apex 設定ファイル
{
project.json
"name": "project-name",
"description": "project-name",
"memory": 128,
"timeout": 300,
"role": "",
"environment": {
"DEBUG_SHIM": "true"
}
}
Lambda Function のメモリとタイムアウトも設定できる

Apex 設定ファイル
{
project.json
"name": "project-name",
"description": "project-name",
"memory": 128,
"timeout": 300,
"role": "",
"environment": {
"DEBUG_SHIM": "true"
}
"hooks": {
"build": "cp ../../package.json . && npm install"
}
}
npm ライブラリを含めることもできる

CircleCI からデプロイする
machine:
circle.yml
timezone: Asia/Tokyo
dependencies:
post:
- curl https://raw.githubusercontent.com/apex/
apex/master/install.sh | sudo sh
deployment:
master:
branch: master
master にマージされたら
commands:
自動的にデプロイする
- apex deploy
test:
pre:
ESLint を
- npm install eslint --save-dev
override:
実行する
- ./node_modules/.bin/eslint .

[実行フロー]
2. メンテナンス on / off
1. cron 実行
3. start / stop
EC2
CloudWatch
Lambda
Events
EC2
3. apex deploy
1. merge
2. hook
EC2
[デプロイフロー]

気付きました？

[実行フロー]
2. メンテナンス on / off
1. cron 実行
3. start / stop
Serverless EC2
CloudWatch
Lambda
Events
Architecture EC2
3. apex deploy
1. merge
2. hook
EC2
[デプロイフロー]

もっと詳し
く！

apex/apex

apex/apex

apex/apex

with Go support ?

Lambda サポート言語
‣ Node.js
re:Invent 2016 で
‣ Java
Ruby と Golang サポートの
‣ Python
発表が無くて
‣ C#
ガッカリした人も多いでしょう

index.js を読んだ

var child = require('child_process')
index.js
var byline = require('./byline')
/**
* Callback for the request.
子プロセスで
*/
Go ( ./main )を動かして
var callback
プロセス間通信をする
/**
* Child process for binary I/O.
*/
var proc = child.spawn('./main', { stdio: ['pipe', 'pipe', process.stderr] })
proc.on('error', function(err){
console.error('[shim] error: %s', err)
0 : 標準入力 (stdin)
process.exit(1)
1 : 標準出力 (stdout)
})
2 : 標準エラー出力 (stderr)
proc.on('exit', function(code, signal){
console.error('[shim] exit: code=%s signal=%s', code, signal)
process.exit(1)
})

/**
index.js
* Newline-delimited JSON stdout.
*/
var out = byline(proc.stdout)
out.on('data', function(line){
if (process.env.DEBUG_SHIM) console.log('[shim] parsing: `%s`', line)
var msg = JSON.parse(line)
callback(msg.error, msg.value)
})
/**
* Handle events. Go の標準出力を返す
開発中はデバッグモード
*/
にしておくと便利
exports.handle = function(event, ctx, cb) {
{
callback = cb
（中略）
ctx.callbackWaitsForEmptyEventLoop = false
"environment": {
proc.stdin.write(JSON.stringify({
"DEBUG_SHIM": "true"
"event": event,
"context": ctx
}
})+'\n');
}
}

簡略化すると

invoke
STDERR
child_process.spawn
STDIN
index.js
main.go
(apex/shim)
STDOUT

どうしても Lambda で
Go を動かしたいなら使えるかも？
（公式サポートを待っても良さそう）

時間余ったら
AWS Tips 紹介

awslogs
CloudWatch Logs を簡単に処理できる CLI
（フィルタ, ウォッチ, 日時指定など）

git-secrets
IAM クレデンシャルの誤コミットを防止するツール
（一言で言えば git hooks）

roadworker
Route 53 の設定を Infrastructure as Code 化する
（個人ドメインの管理に使ってる）

piculet
セキュリティグループを Infrastructure as Code 化する

まとめ

Lambda + Apex 便利！