【AWS】AWS SAM触ってみた

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
$ unzip awscliv2.zip
$ sudo ./aws/install

$ aws --version
> aws-cli/2.xxx Python/3.xxx Linux/5.xxx-WSL2 exe/x86_64.ubuntu.20

# ・awsユーザのアクセスキー/シークレット
# ・リソースを作成するリージョンの設定
# ・CLIの結果表示の形式の指定（基本的にJSONでOK）
$ aws configure
> ※すでに設定済みの場合の2回目以降は下記のように設定値が表示される。
AWS Access Key ID [********************]:
AWS Secret Access Key [********************]:
Default region name [ap-northeast-1]:
Default output format [json]:

$ unzip aws-sam-cli-linux-x86_64.zip
$ sudo ./install

$ sam --version
> SAM CLI, version 1.xxx

$ sam init

# テンプレートからの作成か、カスタム作成を選択できます。
# 今回は、Quick Start から Hello World を選択
> Which template source would you like to use?
  1 - AWS Quick Start Templates
  2 - Custom Template Location
1

> Choose an AWS Quick Start application template
  1 - Hello World Example
  2 - Data processing...
1

# Lambdaのランタイムのバージョン選択
> Use the most popular runtime and package type? (python3.13 and zip) [y/N]: y
# XRayを使用してリソース横断した監視を入れるか
> Enable X-Ray tracing? [y/N]: y
# Cloudwatch監視を入れるか
> Enable CloudWatch Application Insights? [y/N]: y
# リソースのログを残すか
> Enable Structured Logging in JSON format? [y/N]: y


#下記のようにテンプレートとして定義されたリソース情報が表示されればOK
-----------------------
Generating application:
-----------------------
Name: sam-app
Runtime: python3.13
Application Template: hello-world
...

import json

# hello worldというメッセージを返す。
def lambda_handler(event, context):
    return {
        "statusCode": 200,
        "body": json.dumps({
            "message": "hello world",
        }),
    }

# 特定リソース周りの設定を確認するには、Resource項目を確認する
Resources:
  HelloWorldFunction:
    Type: AWS::Serverless::Function # Lambdaを意味する
    Properties:
      CodeUri: hello_world/ # hello_worldについての設定だとわかる。
      Handler: app.lambda_handler
      Runtime: python3.13
      # API Gatewayというイベントが来た時に発動する。
      Events:
        HelloWorld:
          Type: Api
          # 具体的には、helloパスにGETメソッドでリクエストしたとき。
          Properties:
            Path: /hello
            Method: get

# SAMプロジェクト（sam-app）内で実行
$ sam build

Building codeuri: hello_world
runtime: python3.13 architecture: x86_64 functions: HelloWorldFunction

# ビルド成功
Build Succeeded

# ビルド済みテンプレート先
Built Artifacts : .aws-sam/build
Built Template  : .aws-sam/build/template.yaml

# SAMプロジェクト（sam-app）内で実行
$ sam deploy --guided

# デプロイ時の諸々設定（基本的にデフォルト設定で良いため、yもしくは空白を選択）
Configuring SAM deploy
======================
Stack Name [sam-app]:              # デプロイ先のCloudFormationスタック名
AWS Region [ap-northeast-1]:       # デプロイするリージョン
Confirm changes before deploy [Y/n]: y   # デプロイ前に差分確認するか
Allow SAM CLI IAM role creation [Y/n]: y # 必要なIAMロールをSAMに作成させるか
Disable rollback [y/N]: y               # エラー時に自動ロールバックを無効化するか
HelloWorldFunction has no authentication. Is this okay? [y/N]: y
Save arguments to configuration file [Y/n]: y # 設定を samconfig.toml に保存

>
CloudFormation outputs
======================
Key                 HelloWorldApi
Description         API Gateway endpoint URL
Value               https://****.execute-api.ap-northeast-1.amazonaws.com/Prod/hello/

Key                 HelloWorldFunction
Description         Hello World Lambda Function ARN
Value               arn:aws:lambda:ap-northeast-1:****:function:sam-app-HelloWorldFunction-****

curl https://****.execute-api.ap-northeast-1.amazonaws.com/Prod/hello/

>{"message": "hello world"}

# ローカルPCにて、Lambda上の関数を実行して結果確認
$ sam local invoke

Invoking app.lambda_handler (python3.9)
Local image was not found.
Building image...
Using local image: public.ecr.aws/lambda/pythonxxx
# 結果
{"statusCode": 200, "body": "{\"message\": \"hello world\"}"}

$ sam local start-api

# ローカルホスト上にAPI Gatewayのエンドポイントを構築
Mounting HelloWorldFunction at http://127.0.0.1:3000/hello [GET]
You can now browse to the above endpoints to invoke your functions.

#ブラウザやcurlで `http://127.0.0.1:3000/hello` にアクセスすると、Lambdaの応答が確認可能

# sam-appというプロジェクトの中のHelloWorldFunctionを呼び出し
$ sam remote invoke HelloWorldFunction --stack-name sam-app

{"statusCode": 200, "body": "{\"message\": \"hello world\"}"}

# 一旦sam syncを実行
$ sam sync --watch

# ローカルファイルを変更すると、リソースも変更される
Syncing Lambda Function HelloWorldFunction...
Finished syncing Lambda Function HelloWorldFunction.

# sam syncを実行したときに、リソースが変更される
$ sam sync --no-watch

Syncing Lambda Function HelloWorldFunction...
Finished syncing Lambda Function HelloWorldFunction.

$ sam list endpoints --output json

# lambdaとapi gatewayのリソースが表示される。
# lambdaはインターネットへの入出口がないので、CloudEndpointおよびMethods項目が「-」となる
[
  {
    "LogicalResourceId": "HelloWorldFunction",
    "CloudEndpoint": "-",
    "Methods": "-"
  },
  {
    "LogicalResourceId": "ServerlessRestApi",
    "CloudEndpoint": ["https://*****.execute-api.ap-northeast-1.amazonaws.com/Prod"],
    "Methods": ["/hello['get']"]
  }
]

$ sam delete

Are you sure you want to delete the stack sam-app in the region ap-northeast-1 ? [y/N]: y
Deleted successfully