serverless frameworkによるAWS Lambdaの実践的デプロイ

モバイルアプリサービス部の五十嵐です。

まえがき

以前のserverless framework（当時はJAWS）は独自の仕組みで環境変数のような機能をサポートしていましたが、AWS Lambdaに環境変数がサポートされるようになり、serverless frameworkも設定ファイルに環境変数を設定できるようになりました。

また、serverless frameworkになってからは設定ファイル内で変数が使えるようになり、変数とデプロイコマンドの引数を組み合わせることにより、柔軟なデプロイ設定が可能になりました。

これらのアップデートにより、ようやく実際の開発で使えるデプロイツールになったなと感じています。本記事では、ステージング環境・本番環境など環境毎に適切なデプロイ設定をする方法を紹介します。

環境

• serverless framework 1.4

Credentialsの切り替え

ステージング環境・本番環境など環境毎に「AWSアカウントが異なる場合」や「デプロイに必要なロールが異なる場合」に以下のように設定することでデプロイ時に使用するCredentialsを切り替えることができます。

provider:
name: aws
region: ap-northeast-1
runtime: nodejs4.3
stage: ${opt:stage, self:custom.defaultStage}
profile: ${self:custom.profiles.${self:provider.stage}}

custom:
defaultStage: dev
profiles:
dev: sample_dev
prd: sample_prd

上記の例は公式ドキュメントで紹介されている例とほぼ同様です。

• Serverless Framework - AWS Lambda Guide - Credentials

provider.profile にプロファイル名を指定することで ~/.aws/credentials のプロファイルを使うことができます。上記の例ではさらに custom.profiles. にプロファイル名を設定しています。どちらのプロファイル名を使うかは provider.stage の値によって決まります。 provider.stage は deployコマンドのオプションで --stage に設定された値があればそれが設定され、無ければ custom.defaultStage の値が設定されるようになっています。

設定ファイル内での変数の利用方法について、より詳しくは公式のドキュメントを参照してください。

• Serverless Framework - AWS Lambda Guide - Variables

AWS Lambdaの設定の切り替え

やっていることはCredentialsの切り替えとほぼ同じですが、AWS Lambdaの設定の切り替えの例としてAWS LambdaをVPC内で起動する際に設定するVPCを設定する方法を紹介します。

custom:
vpc:
dev:
securityGroupIds:
- sg-xxxxxxxx
subnetIds:
- subnet-11111111
- subnet-22222222
prd:
securityGroupIds:
- sg-yyyyyyyy
subnetIds:
- subnet-33333333
- subnet-44444444

functions:
sample:
handler: sample.handler
vpc: ${self:custom.vpc.${self:provider.stage}}

上記の例では functions.sample.vpc を変数にしました。このように変数には複数の値やネストした値を設定することもできます。

• Serverless Framework - AWS Lambda Guide - Functions

AWS Lambdaの環境変数の切り替え

こちらもやっていることはCredentialsの切り替えとほぼ同じです。serverless frameworkでは全functionに共通して設定する環境変数と、function毎に設定する環境変数を設定することができます。

provider:
environment:
SOME_VAR: 0

custom:
sample:
environment:
dev:
SOME_VAR: 1
prd:
SOME_VAR: 2

functions:
sample:
handler: sample.handler
environment: ${self:custom.sample.environment.${self:provider.stage}}

上記は説明用の例ですが、 provider.environment が全functionに設定される環境変数、 functions.*.environment がfunction毎に設定される環境変数となります。全functionに設定される環境変数より、function毎に設定される環境変数の方が優先されるため、この設定ファイルでデプロイするとSOME_VARには1または2が設定されます。

環境変数を扱う上での注意点としては、CLIやAWS ConsoleからAWS Lambdaの環境変数を設定した上で設定ファイルに環境変数を設定すると、デプロイ時に 設定ファイルにない環境変数は削除 されてしまいます。CLIやAWS Consoleからは環境変数を設定しないようにしましょう。（理解した上で一時的に変更したいだけなら良いですが。）

• Serverless Framework - AWS Lambda Guide - Functions

デプロイ

各種設定の切り替えはdeployコマンドの stageオプションにより行うことができます。

$ sls deploy # dev環境へのデプロイ
$ sls deploy --stage prd # prd環境へのデプロイ

まとめ

1年前にserverless framework（当時はJAWS）について調べて発表した時は、実務で使うにはまだ色々と足りてないと感じていましたが、今は十分に実務で使えるだけの機能がサポートされ、実際に実務でも使ってもいます。

今年も引き継きサーバレス界隈をウォッチしつつ実務に取り入れて行きたいと思います！