SAMでLambdaをデプロイする

Lambda使ってますか、いいですよねLambda。使った分しか課金されないし無料枠多いし。そんなみんな大好きLambdaをCLIで登録する小技を紹介します。

AWSにアカウントがあってCLIからAWS環境に接続済みの前提で、Mac環境で作業することとします。

goまわりの設定とか、awsまわりの環境設定はここでは省きます。

SAMのインストール
Lambdaプログラムの用意
テンプレート編集
ビルド・デプロイ
確認
作成したLambdaの削除
サンプルコード

SAMのインストール

SAM CLIをインストールします。homebrewはインストールしておいて下さい。

brew install aws-sam-cli

公式のインストール方法はこちら

Lambdaプログラムの用意

今回はgoで記述します。

ディレクトリ構成はこちら。

template.yaml
src/
  main.go
  go.mod
  go.sum

環境変数を読み込んでログ出力するだけのプログラムです。

package main

import (
    "context"
    "log"
    "os"

    "github.com/aws/aws-lambda-go/lambda"
)

func handler(ctx context.Context) error {
    s := os.Getenv("PERMIT")
    log.Printf("PERMIT: %s", s)
    return nil
}

func main() {
    lambda.Start(handler)
}

go get 等しておきます。

テンプレート編集

つづいてSAMのテンプレートを編集します。SAMはServerless Application Modelの略です。

公式のドキュメントはこちら

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: >
  sam_lambda_sample
  
  SAM Template for sam_lambda_sample

# More info about Globals: https://github.com/awslabs/serverless-application-model/blob/master/docs/globals.rst
Globals:
  Function:
    Timeout: 180

Resources:
  SamLambdaSampleFunction:
    Type: AWS::Serverless::Function # More info about Function Resource: https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction
    Properties:
      CodeUri: src/
      Handler: sam-lambda-sample
      FunctionName: sam-lambda-sample
      Runtime: go1.x
      EventInvokeConfig:
        MaximumRetryAttempts: 0
      Events:
        ScheduledEvent:
          Type: Schedule
          Properties:
            Name: sam-lambda-sample-schedule
            Schedule: cron(* * * * ? *)
      Environment:
        Variables:
          PERMIT: "1"
      Tags:
        AppNameTag: sam-lambda-sample

  SamLambdaSampleLogGloup:
    Type: AWS::Logs::LogGroup
    Properties:
      LogGroupName: !Sub /aws/lambda/${SamLambdaSampleFunction}
      RetentionInDays: 7

Outputs:
  SamLambdaSampleFunction:
    Value: !GetAtt SamLambdaSampleFunction.Arn
  SamLambdaSampleFunctionIamRole:
    Value: !GetAtt SamLambdaSampleFunctionRole.Arn

ここでは次のことをしています。