Go＋SAMでLambda Layersのテンプレートを作成

GoでLambda Layers

re:Invent2018で発表されたLambda Layersですが、どのサイトを見てもPythonの記事ばかりなので、実際にGoを使ってLambda Layersに挑戦してみます。

環境準備

SAMがインストールされていることを確認します。ローカル環境でライブラリのインストールがうまくいかない場合や、Windowsを使用しているけどLinuxコマンドを使ってやりたい場合は、Cloud9上で開発すると便利です。ローカルPCのモジュールが肥大化しすぎないという利点もあります。

samのバージョン確認

$ sam --version
SAM CLI, version 0.8.1

※仮にSAMがない場合は、pipコマンドでインストールします。

pipでsam-cliをインストール

$ pip install aws-sam-cli

Goプロジェクトの作成

sam initを使用して、Goのプロジェクトを作成していきます。
今回は「cancer」という名前のプロジェクト名にします。

プロジェクト作成

$ sam init --runtime go1.x --name cancer
$ ls
cancer  README.md

デフォルトの状態からビルドして実行確認をしていきます。
Makefileにbuildコマンドがデフォルトで用意されているため、そのまま利用していきます。

ビルド実行

$ cd cancer/
$ ls
hello-world  Makefile  README.md  template.yaml
$ make build
GOOS=linux GOARCH=amd64 go build -o hello-world/hello-world ./hello-world

※cannot find packageエラーが発生したら、go getでインストールをしていきましょう。

パッケージインストール

$ go get "github.com/aws/aws-lambda-go/events"

動作確認

ビルドが完了したら、APIをローカルで実行してみます。

APIのローカル起動

$ sam local start-api

動作確認してみましょう。
ターミナル画面から「+」ボタンを押し、「New Terminal」を選択してcurlコマンドを実行します。

動作確認

$ curl http://127.0.0.1:3000/hello
Hello, 54.237.36.52

ここまでで、通常のGoプロジェクトテンプレートが完成しました。

Layer側のGoプロジェクトを作成

Layersのプロジェクトを作成するために、まずはディレクトリを作成しましょう。

Layerプロジェクトのディレクトリ作成

$ mkdir layers
$ cd layers
$ mkdir first-layer
$ cd first-layer
$ pwd
/home/ec2-user/environment/cancer/layers/first-layer

次に、第一レイヤであるfirst.goを作成していきます。

first.goの作成

$ vi first.go

first.go

package main

import (
  "fmt")

func main() {
  fmt.Println("Hello, First Layer!")
}

layerの実行確認

$ go run first.go
Hello, First Layer!

Lambdaにソースコードをアップロードするため、ビルドモジュールをzipに固めます。

zipの作成

$ GOOS=linux GOARCH=amd64 go build -o first
$ zip first.zip ./first
$ ls
first  first.go  first.zip

その後、S3にzipファイルをアップロードします。今回は「sam-template-store」というバケットを既に作成しているので、こちらにアップロードしていきます。バケットを作成していない場合はコンソールから作成しましょう。

S3にzipファイルをアップロード

$ aws s3 cp ./first.zip s3://sam-template-store/ --acl public-read                          

YAMLでレイヤのデプロイ

template.yamlを使用して、レイヤを作成していきます。
既にアップロードされたS3のzipをContentUriに指定しましょう。

template.yaml

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

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

Resources:
  FirstLayersFunction:
    Type: AWS::Serverless::LayerVersion
    Properties:
      LayerName: FirstLayer
      Description: First Layer
      ContentUri: 's3://sam-template-store/first.zip'
      CompatibleRuntimes: 
        - go1.x

Outputs:
  LayerVersionArn:
    Value: !Ref FirstLayersFunction

CloudFormationのコマンドでデプロイします。

レイヤのデプロイ

$ pwd
/home/ec2-user/environment/cancer
$ aws cloudformation deploy --stack-name first-layer --template-file template.yaml

Successfullyがターミナルに表示されたら、レイヤのArnを取得するため、以下コマンドを実行します。

レイヤのArn取得

$ aws cloudformation describe-stacks --stack-name first-layer
...
        "Description": "cancer\nSample SAM Template for cancer\n", 
            "Tags": [], 
            "Outputs": [
                {
                    "OutputKey": "LayerVersionArn", 
                    "OutputValue": "arn:aws:lambda:us-east-1:xxxxxxxxxxxx:layer:FirstLayer:3"
                }
            ]
...

OutputValueで表示されたArnを下記で使用していきます。

レイヤをLambdaFunctionに追加

ここで、HelloWorldFunctionを作成し、Layersとして先ほど作成したLambdaを指定します。
template.yamlに以下を追記していきましょう。

template.yaml

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

Globals:
  Function:
    Timeout: 5

Resources:
  HelloWorldFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: hello-world/
      Handler: hello-world
      Runtime: go1.x
      Tracing: Active
      Events:
        CatchAll:
          Type: Api
          Properties:
            Path: /hello
            Method: GET
      Layers:
        - "arn:aws:lambda:us-east-1:xxxxxxxxxxxx:layer:FirstLayer:3"
  FirstLayersFunction:
    Type: AWS::Serverless::LayerVersion
    Properties:
      LayerName: FirstLayer
      Description: First Layer
      ContentUri: 's3://sam-template-store/first.zip'
      CompatibleRuntimes: 
        - go1.x

Outputs:
  LayerVersionArn:
    Value: !Ref FirstLayersFunction

samコマンドでパッケージングとデプロイを行います。
Makefileに記載すると打ち込むコマンドが少なくなるので便利です。

Makefile

.PHONY: deps clean build

deps:
	go get -u ./...

clean: 
	rm -rf ./hello-world/hello-world
	
build:
	GOOS=linux GOARCH=amd64 go build -o hello-world/hello-world ./hello-world

# 追記	
package:
	sam package --template-file template.yaml --output-template-file output-template.yaml --s3-bucket sam-template-store 

# 追記
deploy:
	sam deploy --template-file output-template.yaml --stack-name sam-template-store --capabilities CAPABILITY_IAM

Makefileでデプロイまで実行してみましょう。

pakageの作成

$ make package
sam package --template-file template.yaml --output-template-file output-template.yaml --s3-bucket sam-template-store 

Functionのデプロイ

$ make deploy
sam deploy --template-file output-template.yaml --stack-name sam-template-store --capabilities CAPABILITY_IAM

最後に、Lambdaのコンソールから状況を確認してみます。
HelloWorldFunctionにLayersとして、先ほど作成したFirstLayerが参照されてことが確認できました。