AWS Serverless Application Model(AWS SAM)은 서버리스 애플리케이션을 빌드하기 위한 오픈 소스 프레임워크입니다. 자세한 내용은 GitHub의 AWS Serverless Application Model 리포지토리
AWS SAM 리포지토리 설정
AWS SAM CLI를 사용하여 AWS SAM Hello World
프로젝트를 생성합니다.
AWS SAM 프로젝트를 생성하려면
-
로컬 시스템에 AWS SAM CLI를 설치하기 위한 AWS Serverless Application Model 개발자 안내서의 지침을 따릅니다.
-
sam init
을 실행하고 다음 프로젝트 구성을 선택합니다.Which template source would you like to use?: 1 - AWS Quick Start Templates Choose an AWS Quick Start application template: 1 - Hello World Example Use the most popular runtime and package type? (Python and zip) [y/N]: N Which runtime would you like to use?: 8 - java21 What package type would you like to use?: 1 - Zip Which dependency manager would you like to use?: 1 - gradle Would you like to enable X-Ray tracing on the function(s) in your application? [y/N]: N Would you like to enable monitoring using CloudWatch Application Insights? [y/N]: N Would you like to set Structured Logging in JSON format on your Lambda functions? [y/N]: N Project name [sam-app]: <insert project name>
-
지원되는 소스 리포지토리에 AWS SAM 프로젝트 폴더를 업로드합니다. 지원되는 소스 유형 목록은 ProjectSource를 참조하세요.
CodeBuild Lambda Java 프로젝트 생성
AWS CodeBuild Lambda Java 프로젝트를 생성하고 빌드에 필요한 IAM 권한을 설정합니다.
CodeBuild Lambda Java 프로젝트를 생성하려면
-
https://console.aws.amazon.com/codesuite/codebuild/home
에서 AWS CodeBuild 콘솔을 엽니다. -
CodeBuild 정보 페이지가 나타나면 빌드 프로젝트 생성을 선택합니다. 그렇지 않을 경우, 탐색 창에서 빌드를 확장한 후 빌드 프로젝트를 선택하고 빌드 프로젝트 생성을 선택합니다.
프로젝트 이름에 이 빌드 프로젝트의 이름을 입력합니다. 각 AWS 계정에서 빌드 프로젝트 이름은 고유해야 합니다. 또한 선택에 따라 빌드 프로젝트에 대한 설명을 포함하여 다른 사용자가 이 프로젝트의 용도를 이해하도록 도울 수 있습니다.
-
소스에서 AWS SAM 프로젝트가 위치한 소스 리포지토리를 선택합니다.
-
환경에서 다음과 같이 합니다.
-
컴퓨팅에서 Lambda를 선택합니다.
-
런타임에서 Java를 선택합니다.
-
이미지에서 aws/codebuild/amazonlinux-x86_64-lambda-standard:corretto21을 선택합니다.
-
서비스 역할의 경우 새 서비스 역할을 선택한 상태로 둡니다. 역할 이름을 기록해 둡니다. 이는 이 샘플의 뒷부분에서 프로젝트의 IAM 권한을 업데이트할 때 필요합니다.
-
-
빌드 프로젝트 생성을 선택합니다.
-
https://console.aws.amazon.com/iam/
에서 IAM 콘솔을 엽니다. -
탐색 창에서 역할을 선택하고 프로젝트와 연결된 서비스 역할을 선택합니다. 빌드 프로젝트를 선택하고 편집, 환경, 서비스 역할을 선택하여 CodeBuild에서 프로젝트 역할을 찾을 수 있습니다.
-
신뢰 관계(Trust relationships) 탭을 선택한 후 신뢰 정책 편집(Edit trust policy)을 선택합니다.
-
다음 인라인 정책을 IAM 역할에 추가합니다. 이는 나중에 AWS SAM 인프라를 배포하는 데 사용됩니다. 자세한 내용은 IAM 사용 설명서의 IAM 자격 증명 권한 추가 및 제거를 참조하세요.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Action": [ "cloudformation:*", "lambda:*", "iam:*", "apigateway:*", "s3:*" ], "Resource": [ "*" ] } ] }
프로젝트 buildspec 설정
Lambda 함수를 빌드, 테스트 및 배포하기 위해 CodeBuild는 buildspec에서 빌드 명령을 읽고 실행합니다.
프로젝트 buildspec을 설정하려면
-
CodeBuild 콘솔에서 빌드 프로젝트를 선택한 다음 편집 및 Buildspec을 선택합니다.
-
Buildspec에서 빌드 명령 삽입을 선택한 후 편집기로 전환을 선택합니다.
-
사전 채워진 빌드 명령을 삭제하고 다음 buildspec에 붙여넣습니다.
version: 0.2 env: variables: GRADLE_DIR: "HelloWorldFunction" phases: build: commands: - echo "Running unit tests..." - cd $GRADLE_DIR; gradle test; cd .. - echo "Running build..." - sam build --template-file template.yaml - echo "Running deploy..." - sam package --output-template-file packaged.yaml --resolve-s3 --template-file template.yaml - yes | sam deploy
-
Update buildspec(buildspec 업데이트)을 선택합니다.
AWS SAM Lambda 인프라 배포
CodeBuild Lambda를 사용하여 Lambda 인프라 자동 배포
Lambda 인프라를 배포하려면
-
빌드 시작를 선택합니다. 이렇게 하면 AWS CloudFormation을 사용하여 AWS SAM 애플리케이션을 자동으로 빌드, 테스트하고 AWS Lambda에 배포합니다.
-
빌드가 완료되면 AWS Lambda 콘솔로 이동하여 AWS SAM 프로젝트 이름에서 새 Lambda 함수를 검색합니다.
-
함수 개요에서 API Gateway를 선택한 다음 API 엔드포인트 URL을 클릭하여 Lambda 함수를 테스트합니다.
"message": "hello world"
메시지가 포함된 페이지가 열려 있어야 합니다.
인프라 정리
이 자습서 중에 사용한 리소스의 추가 요금이 부과되지 않도록 AWS SAM 템플릿에서 생성된 리소스와 CodeBuild를 삭제합니다.
인프라를 정리하려면
-
AWS CloudFormation 콘솔로 이동하여
aws-sam-cli-managed-default
를 선택합니다. -
리소스에서 배포 버킷
SamCliSourceBucket
을 비웁니다. -
aws-sam-cli-managed-default
스택을 삭제합니다. -
AWS SAM 프로젝트와 연결된 AWS CloudFormation 스택을 삭제합니다. 이 스택의 이름은 AWS SAM 프로젝트와 동일해야 합니다.
-
CloudWatch 콘솔로 이동하여 CodeBuild 프로젝트와 연결된 CloudWatch 로그 그룹을 삭제합니다.
-
CodeBuild 콘솔로 이동하여 빌드 프로젝트 삭제를 선택하여 CodeBuild 프로젝트를 삭제합니다.