はじめに

前回（エキサイトの開発現場でAWSサーバレス導入事例）を紹介しました。今回は、SAM CLIで構築手順を紹介したいと思います。

前提

今回はOSX環境で直接にコマンドを叩いて試しますが、次回はDocker化します。

まず、Pythonがインストールされている確認

$ python --version
Python 3.8.3

Python 3.8.3が入った

準備

AWS SAM CLIインストール

以下のコマンドでインストールします

$ pip3 install aws-sam-cli

sam cliが入っていること確認

$ sam --version
SAM CLI, version 1.7.0

SAM CLIがインストールされました。

AWS認証の準備

• AMIユーザーを作成
  AWSの公式ドキュメントのようにIAMユーザー作成を実施、アクセスキーIDとシークレットアクセスキーをメモしておいてください。

• AMIユーザーに必要なポリシー追加
  ポリシー管理まわり複雑化したくないので、全てFullAccess権限をアタッチします。

厳密に制限したい場合は、SAMの公式ドキュメントをご参考ください。

• AWSプロファイル登録

$ aws configure --profile sam-deploy
以下の情報入力
<アクセスキー ID>
<シークレットアクセスキー>
ap-northeast-1
json

複数のサービス運用の方は、--profileオプションを付けてください。

• リリースステージ用のS3バケット作成
  AWSコンソールにログイン、S3バケット（例：excite-api-lambda-deploy-bucket）を作成します。 Infrastructure as Codeによるインフラ構築の自動化を実現したい場合は、別のプロジェクトでCloudformationもしくはTerraformでS3バケット作成の手段もあります。

構築

アプリケーションのひな形生成

$ sam init \
    --runtime python3.8 \
    --name excite-lambda-deploy\
    --app-template hello-world

excite-lambda-deployプロジェクトが作成されました。

自動生成されたプロジェクト構成が以下のようになります。

excite-lambda-deploy
├── README.md
├── __init__.py
├── events
│   └── event.json
├── hello_world
│   ├── __init__.py
│   ├── app.py
│   └── requirements.txt
├── template.yaml
└── tests
    ├── __init__.py
    └── unit
        ├── __init__.py
        └── test_handler.py

4 directories, 10 files

SAMビルド

$ sam build

実行すると、.aws-sam/ 以下にいろいろと作成されています。

AWSへデプロイ

$ sam deploy \
   --profile sam-deploy \
    --template-file template.yaml \
    --stack-name excite-api-lambda-deploy-stack \
    --s3-bucket excite-api-lambda-deploy-bucket \
    --capabilities CAPABILITY_NAMED_IAM \
    --no-fail-on-empty-changeset

特にエラーがでなければ、これでデプロイが完了しました。

API Gatewayのアクセスポイントでアクセスしてみる（APIエンドポイントはAWSコンソール上に確認できます）

$ curl https://xxxxx.execute-api.ap-northeast-1.amazonaws.com/Prod/hello/
{"message": "hello world"}

と返ってくれば成功です。

作成したリソース削除

$ aws cloudformation delete-stack  \
   --profile sam-deploy \
   --stack-name excite-api-lambda-deploy-stack

作成されたリソースがすべて削除されます(CloudFormation用のS3バケットはSAMの管理用なので残ります)

最後に

SAMで作れないAWSリソース（IAM、S3、EC2など）はCloudfrontテンプレートもしくはTerraformで構築が必要です。個人的にこちらはサーバーレスアプリケーション用のプロジェクトで、別途でインフラ構築用のプロジェクトを用意した方が良いと思います。

今回は直接にMacOSにインストールしていますが、次のDocker編は実際の開発現場に近い環境構築を紹介したいと思います。