More than 5 years have passed since last update.

Lambda関数をアプリ化して、Serverless Application Repositoryで公開しよう [15分で完成編]

Last updated at 2019-05-10Posted at 2019-05-08

🔶 はじめに

業務の中で、Lambdaでちょっとした便利な関数を作っても、自分だけが使ってるだけでは勿体無いです。
しかし、他の人にもLambda関数を使ってもらおうと思うと、環境変数や権限設定が煩雑で、「気軽にどうぞ」とはなかなか行きません。

ところが、AWSのServerless Application Repositoryを使う事で、Lambda関数を、ボタンクリックでインストールできるアプリとして、公開する事が可能です。

🔶 利用サービス

🔷 Serverless Application Repository

https://aws.amazon.com/jp/serverless/serverlessrepo/
公式サイトの説明は以下の通りです。

AWS Serverless Application Repository は、サーバーレスアプリケーション用のマネージド型リポジトリです。チーム、組織、開発者個人が、再利用可能なアプリケーションを保存して共有できます。また、強力な新しい方法でサーバーレスアーキテクチャを簡単に組み立ててデプロイすることもできます。

一言で言うと、サーバレスアプリケーションを作成して登録すると、みんながボタンクリックで、登録したアプリをすぐに使えるようにしてくれるサービスです。
アプリを一般公開する事も可能ですが、今回は自分のAWSアカウント内の公開とします。

🔷 Lambda

https://aws.amazon.com/jp/lambda/
様々な言語のコードをデプロイできる実行環境。
ここで作った関数を、サーバレスアプリケーションにします。

🔷 Amazon S3

https://aws.amazon.com/jp/s3/
ストレージサービス。
サーバレスアプリケーションのソースコード置き場として使うので、実際には何でも良いのですが、今回はS3を使います。

🔶 作業手順

サーバレスアプリケーションの作成
Lambda関数から、ソースコードとSAMファイルを取得
S3にソースコードを格納
SAMファイルの修正
Serverless Application Repositoryに、サーバレスアプリケーションを登録

🔶 サーバレスアプリケーションの作成

まずは、Lambda関数をサーバレスアプリケーション化します。
何でも良いですが、今回は用意されているサンプルの関数を使用します。

サンプルの関数を用意する方法が分からなければ、以下を参照してください。
参考：[API Gateway + LambdaでREST API開発を体験しよう [10分で完成編]]
(https://qiita.com/tamura_CD/items/46ba8a2f3bfd5484843f)

🔷 Lambda関数から、ソースコードとSAMファイルを取得

1. Lambda関数を選択して、画面上部の [アクション] → [関数のエクスポート] をクリックする。

2. 以下のダイアログが表示されるので、[AWS SAMファイルのダウンロード] [デプロイパッケージのダウンロード]の両方をクリックする。

⬛ SAMファイル

AWSにはサーバーレスアプリケーションを構築するために使用するフレームワークがあるのですが、そこで構築するために必要な定義情報が書かれたファイル。
開いてみたらわかりますが、今回はLambda関数のプロジェクト情報が書かれています。

⬛ デプロイパッケージ

関数のソースコード一式を、ZIPで圧縮したもの。
開いてみたら分かりますが、今回はJSファイルが圧縮されているだけです。

🔷 S3にソースコードを格納

1. S3のバケットを作成して、ポリシーを設定する。

[アクセス権限] → [バケットポリシー] を開く。

以下のようにポリシーを記述します。

バケットポリシー

 {
    "Version": "2012-10-17",
    "Id": "■■■■■■■■■■■■■■■■■",
    "Statement": [
        {
            "Sid": "chouhuku-sinakya-nandemo-yoi",
            "Effect": "Allow",
            "Principal": {
                "Service": "serverlessrepo.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::sample-hello-bucket/*"
        }
    ]
}

ポリシーの内容を簡単に解説すると、

このバケットは、Serverless Application Repositoryで公開するアプリの、ソースコードの格納先になるので、バケットの利用を認める対象はServerless Application Repositoryになります。よって、"Service": "serverlessrepo.amazonaws.com"を設定します。
このバケットに格納したソースコードを利用したいので、バケットの中を取得する"Action": "s3:GetObject"権限を設定します。
上記の設定の対象範囲としては、本バケット配下としたいので、"Resource": "arn:aws:s3:::sample-hello-bucket/*"を設定します。

2. S3のバケットに、ソースコードをアップロードする。

S3のバケットに、先程ダウンロードしたデプロイパッケージをアップロードします。
アップロードしたら、以下の[コピーパス]をクリックして、ファイルのパスを取得します。

🔷 SAMファイルの修正

1. 先程ダウンロードしたSAMファイルを開いて、設定情報を記載する。

SAMファイルを開いて、以下のCodeUriに先程コピーしたファイルパスを貼り付けます。

sample_Hello.yaml

AWSTemplateFormatVersion: '2010-09-09'
Transform: 'AWS::Serverless-2016-10-31'
Description: An AWS Serverless Specification template describing your function.
Resources:
  sampleHello:
    Type: 'AWS::Serverless::Function'
    Properties:
      Handler: index.handler
      Runtime: nodejs8.10
      CodeUri: s3://sample-hello-bucket/sample_Hello-cba9fc2c-bd5b-407c-81fa-cc8d832858ad.zip
      Description: ''
      MemorySize: 128
      Timeout: 3
      Role: 'arn:aws:iam::■■■■■■:role/service-role/sample_Hello-role-k6eww01p'