기본 개념 AWS SAM 템플릿 사양은 무엇입니까?템플릿이란 무엇입니까? AWS SAM 무엇입니까? AWS SAMCLI 자세히 알아보기 다음 단계

AWS Serverless Application Model (AWS SAM) 란 무엇입니까?

AWS Serverless Application Model (AWS SAM) 는 서버리스 애플리케이션을 빌드하고 실행하는 개발자 경험을 개선하는 툴킷입니다. AWS AWS SAM 다음과 같은 다양한 이점을 제공합니다.

더 적은 코드를 사용하여 애플리케이션 인프라 코드 빠르게 정의하기: AWS SAM 템플릿을 작성하여 서버리스 애플리케이션 인프라 코드를 정의합니다. 에 템플릿을 직접 AWS CloudFormation 배포하여 리소스를 프로비저닝하세요.
전체 개발 수명 주기에 걸쳐 서버리스 애플리케이션을 관리합니다.: 개발 수명 주기의 작성, 구축, 배포, 테스트 및 모니터링 단계에 걸쳐 서버리스 애플리케이션을 관리하려면 AWS SAMCLI를 사용합니다. 자세한 정보는 AWS SAM CLI 사용을 참조하세요.
AWS SAM 커넥터를 사용하여 리소스 간에 권한을 빠르게 프로비저닝할 수 있습니다.: AWS SAM 템플릿의 AWS SAM 커넥터를 사용하여 AWS 리소스 간 권한을 정의하세요. AWS SAM 코드를 의도를 지원하는 데 필요한 IAM 권한으로 변환합니다. 자세한 정보는 AWS SAM 커넥터를 사용한 리소스 권한 관리을 참조하세요.
개발 과정에서 로컬 변경 사항을 클라우드에 지속적으로 동기화: AWS SAMCLIsam sync명령을 사용하면 로컬 변경 사항을 클라우드에 자동으로 동기화하여 개발 및 클라우드 테스트 워크플로의 속도를 높일 수 있습니다. 자세한 정보는 sam sync 사용하기을 참조하세요.
Terraform 서버리스 애플리케이션 관리: AWS SAMCLI를 사용하여 Lambda 함수 및 계층의 로컬 디버깅 및 테스트를 수행할 수 있습니다. 자세한 정보는 AWS SAM CLI Terraform 지원을 참조하세요.

주제

기본 개념
AWS SAM 템플릿 사양은 무엇입니까?
템플릿이란 무엇입니까? AWS SAM
무엇입니까? AWS SAMCLI
자세히 알아보기
다음 단계
서버리스 개념

기본 개념

AWS SAM 세 가지 주요 부분으로 구성됩니다.

AWS SAM 템플릿 사양 — 서버리스 애플리케이션 인프라를 정의하는 데 사용할 수 있는 오픈 소스 프레임워크입니다. AWS이 프레임워크는 템플릿을 통해 AWS SAM 액세스할 수 있습니다.
AWS SAM 템플릿 — AWS SAM 템플릿 사양에 액세스하는 데 사용하는 것으로, 서버리스 애플리케이션 인프라를 정의하는 데 사용할 수 있는 오픈 소스 프레임워크입니다. AWS AWS SAM 템플릿은 작업하기 쉽도록 몇 가지 추가 구성 요소가 포함된 AWS CloudFormation 템플릿의 확장입니다.
AWS SAM 명령줄 인터페이스 (AWS SAMCLI) — AWS SAM 템플릿 및 지원되는 타사 통합과 함께 사용하여 서버리스 애플리케이션을 빌드하고 실행할 수 있는 명령줄 도구입니다.

서버리스가 처음이신가요?

서버리스 개념검토해 보는 것이 좋습니다.

AWS SAM 템플릿 사양은 무엇입니까?

AWS SAM 템플릿 사양은 서버리스 애플리케이션 인프라 코드를 정의하고 관리하는 데 사용할 수 있는 오픈 소스 프레임워크입니다. AWS SAM 템플릿 사양은 다음과 같습니다.

기본 제공 AWS CloudFormation— 리소스 및 속성 구성에 대한 광범위한 지원을 활용하여 AWS SAM 템플릿 내에서 직접 AWS CloudFormation 구문을 사용할 수 있습니다. 이미 AWS CloudFormation익숙하다면 애플리케이션 인프라 코드를 관리하기 위해 새로운 서비스를 배울 필요가 없습니다.
AWS CloudFormation—의 확장자는 특히 서버리스 개발 속도를 높이는 데 초점을 맞춘 고유한 구문을 AWS SAM 제공합니다. 동일한 템플릿 내에서 AWS CloudFormation 및 AWS SAM 구문을 모두 사용할 수 있습니다.
추상적이고 간단한 구문 - AWS SAM 구문을 사용하면 코드 줄 수를 줄이고 오류 발생 가능성을 줄이면서 인프라를 빠르게 정의할 수 있습니다. 구문은 서버리스 애플리케이션 인프라를 정의하는데 있어 복잡함을 해소할 수 있도록 특별히 엄선되었습니다.
변환 - 템플릿을 인프라를 프로비저닝하는 데 필요한 코드로 변환하는 복잡한 작업을 AWS SAM 수행합니다. AWS CloudFormation

템플릿이란 무엇입니까? AWS SAM

AWS SAM 템플릿은 서버리스 애플리케이션 인프라를 정의하는 데 사용할 수 있는 오픈 소스 프레임워크인 AWS SAM 템플릿 사양에 액세스하는 데 사용하는 것으로 AWS, 보다 쉽게 사용할 수 있는 몇 가지 추가 구성 요소를 포함합니다. 이런 점에서 AWS SAM 템플릿은 템플릿의 AWS CloudFormation 확장입니다.

다음은 기본 서버리스 애플리케이션의 예입니다. 이 애플리케이션은 HTTP 요청을 통해 데이터베이스의 모든 항목을 가져오는 요청을 처리합니다. 이것은 다음과 같은 요소로 구성됩니다.

요청을 처리하는 로직이 포함된 함수.
클라이언트(요청자)와 애플리케이션 간의 통신 역할을 하는 HTTP API.
항목을 저장하는 데이터베이스.
애플리케이션을 안전하게 실행할 수 있는 권한.

이 애플리케이션의 인프라 코드는 다음 AWS SAM 템플릿에서 정의할 수 있습니다.


AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::Serverless-2016-10-31
Resources:
  getAllItemsFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: src/get-all-items.getAllItemsHandler
      Runtime: nodejs12.x
      Events:
        Api:
          Type: HttpApi
          Properties:
            Path: /
            Method: GET
    Connectors:
      MyConn:
        Properties:
          Destination:
            Id: SampleTable
          Permissions:
            - Read
  SampleTable:
    Type: AWS::Serverless::SimpleTable

23줄의 코드에는 다음과 같은 인프라가 정의되어 있습니다.

AWS Lambda 서비스를 사용하는 함수입니다.
Amazon API Gateway 서비스를 사용하는 HTTP API.
Amazon DynamoDB 서비스를 사용하는 데이터베이스.
이러한 서비스가 서로 상호 작용하는 데 필요한 AWS Identity and Access Management (IAM) 권한.

이 인프라를 프로비저닝하기 위해 템플릿이 AWS CloudFormation로 배포됩니다. 배포 중에 23줄의 코드를 이러한 리소스를 생성하는 데 필요한 AWS CloudFormation 구문으로 AWS SAM 변환합니다. AWS변환된 AWS CloudFormation 템플릿에는 200줄 이상의 코드가 포함되어 있습니다!


{
  "AWSTemplateFormatVersion": "2010-09-09",
  "Resources": {
    "getAllItemsFunction": {
      "Type": "AWS::Lambda::Function",
      "Metadata": {
        "SamResourceId": "getAllItemsFunction"
      },
      "Properties": {
        "Code": {
          "S3Bucket": "aws-sam-cli-managed-default-samclisourcebucket-1a4x26zbcdkqr",
          "S3Key": "what-is-app/a6f856abf1b2c4f7488c09b367540b5b"
        },
        "Handler": "src/get-all-items.getAllItemsHandler",
        "Role": {
          "Fn::GetAtt": [
            "getAllItemsFunctionRole",
            "Arn"
          ]
        },
        "Runtime": "nodejs12.x",
        "Tags": [
          {
            "Key": "lambda:createdBy",
            "Value": "SAM"
          }
        ]
      }
    },
    "getAllItemsFunctionRole": {
      "Type": "AWS::IAM::Role",
      "Properties": {
        "AssumeRolePolicyDocument": {
          "Version": "2012-10-17",
          "Statement": [
            {
              "Action": [
                "sts:AssumeRole"
              ],
              "Effect": "Allow",
              "Principal": {
                "Service": [
                  "lambda.amazonaws.com"
                ]
              }
            }
          ]
        },
        "ManagedPolicyArns": [
          "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole"
        ],
        "Tags": [
          {
            "Key": "lambda:createdBy",
            "Value": "SAM"
          }
        ]
      }
    },
    "getAllItemsFunctionApiPermission": {
      "Type": "AWS::Lambda::Permission",
      "Properties": {
        "Action": "lambda:InvokeFunction",
        "FunctionName": {
          "Ref": "getAllItemsFunction"
        },
        "Principal": "apigateway.amazonaws.com",
        "SourceArn": {
          "Fn::Sub": [
            "arn:${AWS::Partition}:execute-api:${AWS::Region}:${AWS::AccountId}:${__ApiId__}/${__Stage__}/GET/",
            {
              "__ApiId__": {
                "Ref": "ServerlessHttpApi"
              },
              "__Stage__": "*"
            }
          ]
        }
      }
    },
    "ServerlessHttpApi": {
      "Type": "AWS::ApiGatewayV2::Api",
      "Properties": {
        "Body": {
          "info": {
            "version": "1.0",
            "title": {
              "Ref": "AWS::StackName"
            }
          },
          "paths": {
            "/": {
              "get": {
                "x-amazon-apigateway-integration": {
                  "httpMethod": "POST",
                  "type": "aws_proxy",
                  "uri": {
                    "Fn::Sub": "arn:${AWS::Partition}:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${getAllItemsFunction.Arn}/invocations"
                  },
                  "payloadFormatVersion": "2.0"
                },
                "responses": {}
              }
            }
          },
          "openapi": "3.0.1",
          "tags": [
            {
              "name": "httpapi:createdBy",
              "x-amazon-apigateway-tag-value": "SAM"
            }
          ]
        }
      }
    },
    "ServerlessHttpApiApiGatewayDefaultStage": {
      "Type": "AWS::ApiGatewayV2::Stage",
      "Properties": {
        "ApiId": {
          "Ref": "ServerlessHttpApi"
        },
        "StageName": "$default",
        "Tags": {
          "httpapi:createdBy": "SAM"
        },
        "AutoDeploy": true
      }
    },
    "SampleTable": {
      "Type": "AWS::DynamoDB::Table",
      "Metadata": {
        "SamResourceId": "SampleTable"
      },
      "Properties": {
        "AttributeDefinitions": [
          {
            "AttributeName": "id",
            "AttributeType": "S"
          }
        ],
        "KeySchema": [
          {
            "AttributeName": "id",
            "KeyType": "HASH"
          }
        ],
        "BillingMode": "PAY_PER_REQUEST"
      }
    },
    "getAllItemsFunctionMyConnPolicy": {
      "Type": "AWS::IAM::ManagedPolicy",
      "Metadata": {
        "aws:sam:connectors": {
          "getAllItemsFunctionMyConn": {
            "Source": {
              "Type": "AWS::Serverless::Function"
            },
            "Destination": {
              "Type": "AWS::Serverless::SimpleTable"
            }
          }
        }
      },
      "Properties": {
        "PolicyDocument": {
          "Version": "2012-10-17",
          "Statement": [
            {
              "Effect": "Allow",
              "Action": [
                "dynamodb:GetItem",
                "dynamodb:Query",
                "dynamodb:Scan",
                "dynamodb:BatchGetItem",
                "dynamodb:ConditionCheckItem",
                "dynamodb:PartiQLSelect"
              ],
              "Resource": [
                {
                  "Fn::GetAtt": [
                    "SampleTable",
                    "Arn"
                  ]
                },
                {
                  "Fn::Sub": [
                    "${DestinationArn}/index/*",
                    {
                      "DestinationArn": {
                        "Fn::GetAtt": [
                          "SampleTable",
                          "Arn"
                        ]
                      }
                    }
                  ]
                }
              ]
            }
          ]
        },
        "Roles": [
          {
            "Ref": "getAllItemsFunctionRole"
          }
        ]
      }
    }
  }
}

AWS SAM를 사용하여 23줄의 인프라 코드를 정의합니다. AWS SAM 코드를 애플리케이션을 프로비저닝하는 데 필요한 200줄 이상의 AWS CloudFormation 코드로 변환합니다.

무엇입니까? AWS SAMCLI

AWS SAM 템플릿 및 지원되는 타사 통합과 함께 사용하여 서버리스 애플리케이션을 빌드하고 실행할 수 있는 명령줄 도구입니다. AWS SAMCLI AWS SAMCLI를 사용하여 다음을 수행할 수 있습니다.

새 애플리케이션 프로젝트를 빠르게 초기화합니다.
배포할 애플리케이션을 빌드합니다.
로컬 디버깅 및 테스트를 수행합니다.
애플리케이션 배포
CI/CD 배포 파이프라인을 구성합니다.
클라우드에서 애플리케이션을 모니터링하고 문제를 해결합니다.
개발 과정에서 로컬 변경 사항을 클라우드에 동기화합니다.
이 뿐만이 아닙니다!

및 AWS SAMCLI 템플릿과 함께 AWS SAM 사용할 때 가장 잘 활용됩니다. AWS CloudFormation Terraform과 같은 타사 제품에서도 사용할 수 있습니다.

새 프로젝트 초기화

스타터 템플릿 중에서 선택하거나 사용자 지정 템플릿 위치를 선택하여 새 프로젝트를 시작할 수 있습니다.

여기서는 sam init 명령을 사용하여 새 애플리케이션 프로젝트를 초기화합니다. 먼저 시작할 Hello World 예제 프로젝트를 선택합니다. 그러면 AWS SAMCLI가 스타터 템플릿을 다운로드하고 프로젝트 폴더 디렉터리 구조가 생성합니다.

sam init를 사용하여 AWS SAMCLI로 새 애플리케이션 프로젝트를 시작합니다.

배포를 위한 애플리케이션 빌드

함수 종속 항목을 패키징하고 프로젝트 코드 및 폴더 구조를 구성하여 배포를 준비합니다.

여기서는 sam build 명령을 사용하여 애플리케이션을 배포할 준비를 합니다. AWS SAMCLI는 .aws-sam 디렉터리를 만들고 배포를 위해 여기에 애플리케이션 종속성 및 파일을 구성합니다.

로컬 디버깅 및 테스트 수행

로컬 컴퓨터에서 이벤트를 시뮬레이션하고, API를 테스트하고, 함수를 호출하는 등 다양한 작업을 수행하여 애플리케이션을 디버깅 및 테스트할 수 있습니다.

여기서는 sam local invoke 명령을 사용하여 로컬에서 HelloWorldFunction를 호출합니다. 이를 위해 AWS SAMCLI는 로컬 컨테이너를 만들고, 함수를 빌드하고, 호출하고, 결과를 출력합니다.

AWS SAMCLIsam local invoke명령을 사용하여 로컬에서 함수를 호출합니다.

애플리케이션 배포

애플리케이션의 배포 설정을 구성하고 AWS 클라우드에 배포하여 리소스를 프로비저닝합니다.

여기서는 sam deploy --guided 명령을 사용하여 대화형 흐름을 통해 애플리케이션을 배포합니다. 애플리케이션의 배포 설정을 구성하고, 템플릿을 리소스로 변환하고 AWS CloudFormation, AWS CloudFormation 배포하여 리소스를 생성하는 과정을 AWS SAMCLI 안내합니다.

AWS SAMCLIsam deploy명령을 사용하여 애플리케이션을 클라우드에 배포합니다. AWS

CI/CD 배포 파이프라인 구성

지원되는 CI/CD 시스템을 사용하여 안전한 지속적 통합 및 제공(CI/CD) 파이프라인을 생성합니다.

여기서는 sam pipeline init --bootstrap 명령을 사용하여 애플리케이션을 위한 CI/CD 배포 파이프라인을 구성합니다. 옵션을 AWS SAMCLI 안내하고 CI/CD 시스템에서 사용할 AWS 리소스 및 구성 파일을 생성합니다.

AWS SAMCLIsam pipeline init --bootstrap명령을 사용하여 선호하는 CI/CD 시스템으로 CI/CD 파이프라인을 구성합니다.

클라우드에서 애플리케이션 모니터링 및 문제 해결

배포된 리소스에 대한 중요한 정보를 보고, 로그를 수집하고, AWS X-Ray와 같은 기본 제공 모니터링 도구를 활용합니다.

여기서는 sam list 명령을 사용하여 배포된 리소스를 확인합니다. API 엔드포인트를 가져와서 호출하면 함수가 트리거됩니다. 그런 다음 sam logs를 사용하여 함수의 로그를 확인합니다.

AWS SAMCLIsam list명령을 사용하여 API 엔드포인트를 획득합니다. 그런 다음, sam logs는 함수의 로그를 보는 데 사용됩니다.

개발 과정에서 로컬 변경 사항을 클라우드에 동기화

로컬 시스템에서 개발할 때 변경 내용을 클라우드에 자동으로 동기화합니다. 변경 사항을 빠르게 확인하고 클라우드에서 테스트 및 검증을 수행할 수 있습니다.

여기서는 sam sync --watch 명령을 사용하여 AWS SAMCLI가 로컬 변경 사항을 감시하도록 합니다. HelloWorldFunction 코드를 수정하면 AWS SAMCLI가 변경 사항을 자동으로 감지하고 업데이트를 클라우드에 배포합니다.

AWS SAMCLIsam sync명령을 사용하여 로컬 변경 사항을 AWS 클라우드에 동기화합니다.

클라우드에서 지원되는 리소스 테스트

이벤트를 호출하고 클라우드의 지원되는 리소스에 전달합니다.

여기서는 sam remote invoke 명령을 사용하여 클라우드에 배포된 Lambda 함수를 테스트합니다. Lambda 함수를 호출하고 해당 로그와 응답을 받습니다. 응답을 스트리밍하도록 구성된 Lambda 함수를 사용하면 AWS SAMCLI가 실시간으로 응답을 다시 스트리밍합니다.

AWS SAMCLIsam remote invoke명령어를 사용하여 AWS 클라우드에 배포된 함수를 테스트합니다.

자세히 알아보기

에 대해 계속 AWS SAM알아보려면 다음 리소스를 참조하십시오.

전체 AWS SAM 워크숍 — AWS SAM 제공되는 여러 주요 기능을 알려드리기 위해 마련된 워크숍입니다.
SAM과의 세션 — AWS 서버리스 개발자 지원 팀이 제작한 사용에 관한 동영상 시리즈입니다. AWS SAM
서버리스 랜드 — 서버리스에 대한 최신 정보, 블로그, 동영상, 코드 및 학습 리소스를 한데 모아 놓은 사이트입니다. AWS

다음 단계

처음 사용하는 AWS SAM경우 을 참조하십시오. AWS SAM 시작하기

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

서버리스 개념