【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"}