AWS SAMとは？ SAM仕様と使い方まとめ

Transform: AWS::Serverless-2016-10-31

Globals:
  set of globals

Description:
  String

Metadata:
  template metadata

Parameters:
  set of parameters

Mappings:
  set of mappings

Conditions:
  set of conditions

Resources:
  set of resources

Outputs:
  set of outputs

$ sam init [OPTIONS]

# パラメータ指定でSAMプロジェクトを開始
$ sam init --runtime python3.9 --dependency-manager pip --app-template hello-world --name sam-app

$ sam validate [OPTIONS]

# template.yamlの内容を検証
$ sam validate 
2022-02-07 13:44:50 Loading policies from IAM...
2022-02-07 13:44:55 Finished loading policies from IAM.
/home/ec2-user/environment/sam-app/template.yaml is a valid SAM Template

$ sam build [OPTIONS] [RESOURCE_LOGICAL_ID]

# LambdaのようなDockerコンテナ内にビルド
$ sam build --use-container
Starting Build inside a container
Building codeuri: /home/ec2-user/environment/sam-app/hello_world runtime: python3.9 metadata: {} architecture: x86_64 functions: ['HelloWorldFunction']

Fetching public.ecr.aws/sam/build-python3.9:latest-x86_64 Docker container image.............................................................................
Mounting /home/ec2-user/environment/sam-app/hello_world as /tmp/samcli/source:ro,delegated inside runtime container

Build Succeeded

Built Artifacts  : .aws-sam/build
Built Template   : .aws-sam/build/template.yaml

Commands you can use next
=========================
[*] Invoke Function: sam local invoke
[*] Deploy: sam deploy --guided
    
Running PythonPipBuilder:ResolveDependencies
Running PythonPipBuilder:CopySource

$ sam package [OPTIONS] [ARGS]...

# アプリケーションをZIP形式にパッケージング
$ sam package --s3-bucket xxxx --output-template-file output.yml

$ sam deploy [OPTIONS] [ARGS]...

# AWS クラウド上へデプロイする
$ sam deploy --template-file output.yml --stack-name SamAppStack

$ sam local generate-event [OPTIONS] COMMAND [ARGS]...

# S3バケットのPUTイベント
$ sam local generate-event s3 put
{
  "Records": [
    {
      "eventVersion": "2.0",
      "eventSource": "aws:s3",
      "awsRegion": "us-east-1",
      "eventTime": "1970-01-01T00:00:00.000Z",
      "eventName": "ObjectCreated:Put",
      "userIdentity": {
        "principalId": "EXAMPLE"
      },
      "requestParameters": {
        "sourceIPAddress": "127.0.0.1"
      },
      "responseElements": {
        "x-amz-request-id": "EXAMPLE123456789",
        "x-amz-id-2": "EXAMPLE123/5678abcdefghijklambdaisawesome/mnopqrstuvwxyzABCDEFGH"
      },
      "s3": {
        "s3SchemaVersion": "1.0",
        "configurationId": "testConfigRule",
        "bucket": {
          "name": "example-bucket",
          "ownerIdentity": {
            "principalId": "EXAMPLE"
          },
          "arn": "arn:aws:s3:::example-bucket"
        },
        "object": {
          "key": "test/key",
          "size": 1024,
          "eTag": "0123456789abcdef0123456789abcdef",
          "sequencer": "0A1B2C3D4E5F678901"
        }
      }
    }
  ]
}

$ sam local invoke [OPTIONS] [FUNCTION_LOGICAL_ID]

# ローカル実行
$ sam local invoke "HelloWorldFunction" -e events/event.json
Invoking app.lambda_handler (python3.9)
Skip pulling image and use local one: public.ecr.aws/sam/emulation-python3.9:rapid-1.33.0-x86_64.

Mounting /home/ec2-user/environment/sam-app/hello_world as /var/task:ro,delegated inside runtime container
END RequestId: 1e230d49-90ae-4ced-9a23-c2e775277916
REPORT RequestId: 1e230d49-90ae-4ced-9a23-c2e775277916  Init Duration: 0.69 ms  Duration: 122.02 ms     Billed Duration: 123 ms Memory Size: 128 MB     Max Memory Used: 128 MB
{"statusCode": 200, "body": "{\"message\": \"hello world\"}"}

# スタック削除コマンド
$ aws cloudformation delete-stack --stack-name SamAppStack