코드형 인프라(IaC)와 함께 Lambda 사용

Lambda 함수는 단독으로 실행되는 경우는 거의 없습니다. 대신 데이터베이스, 대기열, 스토리지 등의 다른 리소스와 함께 서버리스 애플리케이션의 일부를 구성하는 경우가 많습니다. 코드형 인프라(IaC)로 배포 프로세스를 자동화하여 많은 개별 AWS 리소스를 포함하는 전체 서버리스 애플리케이션을 빠르고 반복적으로 배포하고 업데이트할 수 있습니다. 이 접근법을 사용하면 개발 주기가 단축되고 구성 관리가 쉬워지며 리소스가 매번 같은 방식으로 배포될 수 있습니다.

Lambda용 IaC 도구

AWS는 또한 간단한 그래픽 인터페이스를 사용하여 IaC 템플릿을 개발하기 위한 AWS 인프라 컴포저이라는 서비스를 제공합니다. Infrastructure Composer를 사용하여 시각적 캔버스에서 AWS 서비스를 드래그, 그룹화 및 연결하여 애플리케이션 아키텍처를 설계합니다. 그런 다음 Infrastructure Composer는 디자인을 기반으로 응용 프로그램을 배포하는 데 사용할 수 있는 AWS SAM 템플릿 또는 AWS CloudFormation 템플릿을 생성합니다.

아래 Lambda용 IaC 시작하기 섹션에서는 Infrastructure Composer를 사용하여 기존 Lambda 함수를 기반으로 서버리스 애플리케이션을 위한 템플릿을 개발합니다.

Lambda용 IaC 시작하기

이 자습서에서는 기존 Lambda 함수에서 AWS SAM 템플릿을 생성한 다음 다른 AWS 리소스를 추가하여 Infrastructure Composer에서 서버리스 애플리케이션을 구축함으로써 Lambda와 함께 IaC를 사용하기 시작할 수 있습니다.

이 자습서를 수행하면서 AWS 리소스가 AWS SAM에 지정되는 방식과 같은 몇 가지 기본 개념을 배우게 됩니다. 또한 Infrastructure Composer를 사용하여 AWS SAM 또는 AWS CloudFormation을 사용하여 배포할 수 있는 서버리스 애플리케이션을 빌드하는 방법도 배우게 됩니다.

이 자습서를 완료하려면 다음 단계를 수행하게 됩니다.

사전 조건

이 자습서에서는 Infrastructure Composer의 로컬 동기화 기능을 사용하여 템플릿과 코드 파일을 로컬 빌드 컴퓨터에 저장합니다. 이 기능을 사용하려면 웹 애플리케이션이 로컬 파일 시스템에서 파일을 읽고 쓰고 저장할 수 있도록 하는 File System Access API를 지원하는 브라우저가 필요합니다. 구글 크롬이나 Microsoft Edge를 사용하는 것이 좋습니다. 파일 시스템 액세스 API에 대한 자세한 내용은 파일 시스템 액세스 API란 무엇일까요?를 참조하세요.

Lambda 함수 생성

이 첫 단계에서는 자습서의 나머지 부분을 완료하는 데 사용할 수 있는 Lambda 함수를 생성합니다. 작업을 단순화하기 위해 Lambda 콘솔을 사용하여 Python 3.11 런타임을 사용하여 기본 'Hello world' 함수를 생성합니다.

함수에 대한 AWS SAM 템플릿 보기

함수 구성을 Infrastructure Composer로 내보내기 전에 Lambda 콘솔을 사용하여 함수의 현재 구성을 AWS SAM 템플릿으로 확인합니다. 이 섹션의 단계를 수행하면 AWS SAM 템플릿의 구조 및 Lambda 함수와 같은 리소스를 정의하여 서버리스 애플리케이션 지정을 시작하는 방법을 알아볼 수 있습니다.

함수의 YAML 템플릿을 살펴보고 몇 가지 주요 개념을 이해하는 시간을 갖도록 하겠습니다.

템플릿은 Transform: AWS::Serverless-2016-10-31 선언으로 시작합니다. AWS SAM 템플릿은 백그라운드에서 AWS CloudFormation을 통해 배포되기 때문에 이 선언이 필요합니다. Transform 문을 사용하면 템플릿이 AWS SAM 템플릿 파일로 식별됩니다.

Transform 선언 다음에는 Resources 섹션이 나타납니다. AWS 리소스가 함께 배포하려는 AWS SAM 템플릿과 여기에 정의됩니다. AWS SAM 템플릿에는 AWS SAM 리소스와 AWS CloudFormation 리소스의 조합이 포함될 수 있습니다. 배포 중에 AWS SAM 템플릿이 AWS CloudFormation 템플릿으로 확장돼, 유효한 모든 AWS CloudFormation 구문을 AWS SAM 템플릿에 추가할 수 있기 때문입니다.

현재 템플릿 Resources 섹션에 정의된 리소스는 Lambda 함수 LambdaIaCDemo뿐입니다. AWS SAM 템플릿에 Lambda 함수를 추가하려면 AWS::Serverless::Function 리소스 유형을 사용합니다. Lambda 함수의 Properties 리소스는 함수의 런타임, 함수 핸들러 및 기타 구성 옵션을 정의합니다. 함수를 배포하는 데 AWS SAM이 사용해야 하는 함수 소스 코드의 경로도 여기에 정의되어 있습니다. AWS SAM의 Lambda 함수 리소스에 대해 자세히 알아보려면 AWS::Serverless::Function을 AWS SAM 개발자 안내서에서 참조하세요.

템플릿은 함수 속성 및 구성뿐만 아니라 함수에 대한 AWS Identity and Access Management(IAM) 정책도 지정합니다. 이 정책은 Amazon CloudWatch Logs에 로그를 작성할 수 있는 권한을 함수에 제공합니다. Lambda 콘솔에서 함수를 생성하면 Lambda는 이 정책을 함수에 자동으로 연결합니다. AWS SAM 템플릿의 함수에 대한 IAM 정책을 지정하는 방법에 대해 자세히 알아보려면 policies 속성을 AWS::Serverless::Function 페이지, AWS SAM 개발자 안내서에서 참조하세요.

AWS SAM 템플릿 구조에 대한 자세한 내용은 AWS SAM 템플릿 분석을 참조하세요.

AWS 인프라 컴포저을 서버리스 애플리케이션을 설계하는 데 사용합니다.

함수의 AWS SAM 템플릿을 출발점으로 사용하여 간단한 서버리스 애플리케이션을 구축하려면 함수 구성을 Infrastructure Composer로 내보내고 Infrastructure Composer의 로컬 동기화 모드를 활성화해야 합니다. 로컬 동기화는 함수의 코드와 AWS SAM 템플릿을 로컬 빌드 컴퓨터에 자동으로 저장하고, Infrastructure Composer에 다른 AWS 리소스를 추가할 때 저장된 템플릿이 동기화된 상태로 유지됩니다.

함수를 Infrastructure Composer로 내보내려면 특정 API 작업을 사용할 권한이 필요합니다. 함수를 내보낼 수 없는 경우 필수 권한 섹션을 참조하고, 필요한 권한이 있는지 확인합니다.

이제 이러한 추가 리소스를 추가했으니 Infrastructure Composer가 생성한 업데이트된 AWS SAM 템플릿을 살펴보겠습니다.

이제 AWS SAM 템플릿에 다음과 같은 추가 리소스 및 속성이 포함되어야 합니다.

완성된 최종 AWS SAM 템플릿은 다음과 같아야 합니다.

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: An AWS Serverless Specification template describing your function.
Resources:
  LambdaIaCDemo:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: .
      Description: ''
      MemorySize: 128
      Timeout: 3
      Handler: lambda_function.lambda_handler
      Runtime: python3.11
      Architectures:
        - x86_64
      EventInvokeConfig:
        MaximumEventAgeInSeconds: 21600
        MaximumRetryAttempts: 2
      EphemeralStorage:
        Size: 512
      RuntimeManagementConfig:
        UpdateRuntimeOn: Auto
      SnapStart:
        ApplyOn: None
      PackageType: Zip
      Policies:
        - Statement:
            - Effect: Allow
              Action:
                - logs:CreateLogGroup
              Resource: arn:aws:logs:us-east-1:594035263019:*
            - Effect: Allow
              Action:
                - logs:CreateLogStream
                - logs:PutLogEvents
              Resource:
                - arn:aws:logs:us-east-1:594035263019:log-group:/aws/lambda/LambdaIaCDemo:*
        - DynamoDBCrudPolicy:
            TableName: !Ref LambdaIaCTable
      Events:
        LambdaIaCQueue:
          Type: SQS
          Properties:
            Queue: !GetAtt LambdaIaCQueue.Arn
            BatchSize: 1
      Environment:
        Variables:
          LAMBDAIACTABLE_TABLE_NAME: !Ref LambdaIaCTable
          LAMBDAIACTABLE_TABLE_ARN: !GetAtt LambdaIaCTable.Arn
  LambdaIaCQueue:
    Type: AWS::SQS::Queue
    Properties:
      MessageRetentionPeriod: 345600
  LambdaIaCTable:
    Type: AWS::DynamoDB::Table
    Properties:
      AttributeDefinitions:
        - AttributeName: id
          AttributeType: S
      BillingMode: PAY_PER_REQUEST
      KeySchema:
        - AttributeName: id
          KeyType: HASH
      StreamSpecification:
        StreamViewType: NEW_AND_OLD_IMAGES

AWS SAM을 사용하여 서버리스 애플리케이션을 배포합니다(선택 사항).

Infrastructure Composer에서 방금 생성한 템플릿을 사용하여 AWS SAM을 서버리스 애플리케이션을 배포하는 데 사용하려면 먼저 AWS SAM 및 CLI를 설치해야 합니다. 그러려면 AWS SAM CLI 설치하기의 지침을 따릅니다.

애플리케이션을 배포하기 전에 Infrastructure Composer가 템플릿과 함께 저장한 함수 코드도 업데이트해야 합니다. 현재 Infrastructure Composer가 저장한 lambda_function.py 파일에는 함수를 생성할 때 Lambda가 제공한 기본 'Hello world' 코드만 포함되어 있습니다.

함수 코드를 업데이트하려면 다음 코드를 복사하여 Infrastructure Composer가 로컬 빌드 컴퓨터에 저장한 lambda_function.py 파일에 붙여넣습니다. 로컬 동기화 모드를 활성화할 때 Infrastructure Composer에서 이 파일을 저장할 디렉토리를 지정했습니다.

이 코드는 Infrastructure Composer에서 생성한 Amazon SQS 대기열의 메시지에 있는 키 값 쌍을 수락합니다. 키와 값이 모두 문자열인 경우 코드는 이를 사용하여 템플릿에 정의된 DynamoDB 테이블에 항목을 작성합니다.

import boto3
import os
import json

# define the DynamoDB table that Lambda will connect to
tablename = os.environ['LAMBDAIACTABLE_TABLE_NAME']

# create the DynamoDB resource
dynamo = boto3.client('dynamodb')

def lambda_handler(event, context):
    # get the message out of the SQS event
    message = event['Records'][0]['body']
    data = json.loads(message)
    # write event data to DDB table
    if check_message_format(data):
        key = next(iter(data))
        value = data[key]
        dynamo.put_item(
            TableName=tablename,
            Item={
                'id': {'S': key},
                'Value': {'S': value}
            }
        )
    else:
        raise ValueError("Input data not in the correct format")

# check that the event object contains a single key value  
# pair that can be written to the database
def check_message_format(message):
    if len(message) != 1:
        return False
        
    key, value = next(iter(message.items()))
    
    if not (isinstance(key, str) and isinstance(value, str)):
        return False

    else:
        return True

배포 프로세스 중에 AWS SAM은 다음 리소스를 AWS 계정 위치에 생성합니다.

AWS SAM은 또한 Lambda 함수가 Amazon SQS 대기열에서 메시지를 읽고 DynamoDB 테이블에서 CRUD 작업을 수행할 수 있도록 필요한 IAM 역할 및 정책을 생성합니다.

배포된 애플리케이션 테스트(선택 사항)

서버리스 애플리케이션이 올바르게 배포되었는지 확인하려면 키 값 쌍이 포함된 메시지를 Amazon SQS 대기열로 전송하고 Lambda가 이 값을 사용하여 DynamoDB 테이블에 항목을 기록하는지 확인합니다.