컨테이너 이미지로 Lambda 함수 배포

작성자: Ram Kandaswamy(AWS)

요약

AWS Lambda 는 컨테이너 이미지를 배포 모델로 지원합니다. 이 패턴은 컨테이너 이미지를 통해 Lambda 함수를 배포하는 방법을 보여줍니다. 

Lambda는 서버를 프로비저닝하거나 관리하지 않고도 사실상 모든 유형의 애플리케이션이나 백엔드 서비스에 대한 코드를 실행할 수 있는 서버리스 이벤트 기반 컴퓨팅 서비스입니다. Lambda 함수에 대한 컨테이너 이미지 지원을 통해 애플리케이션 아티팩트에 최대 10GB의 스토리지와 친숙한 컨테이너 이미지 개발 도구를 사용할 수 있는 이점을 얻을 수 있습니다.

이 패턴의 예제에서는 Python을 기본 프로그래밍 언어로 사용하지만 Java, Node.js, Go와 같은 다른 언어를 사용할 수 있습니다. 소스의 경우 GitHub, GitLab GitLab 기반 시스템을 고려하거나 Amazon Simple Storage Service(Amazon S3 사용합니다.

사전 조건 및 제한 사항

사전 조건 

제한 사항

아키텍처

대상 아키텍처

자동화 및 규모 조정

이 패턴은 SDK에서 AWS CloudFormation AWS Cloud Development Kit (AWS CDK)또는 API 작업을 사용하여 자동화할 수 있습니다. Lambda는 요청 수에 따라 자동으로 규모를 조정할 수 있으며, 동시성 파라미터를 사용하여 Lambda를 조정할 수 있습니다. 자세한 내용은 Lambda 설명서.를 참조하세요.

도구

서비스

기타 도구

모범 사례

에픽

aws ecr create-repository --cf-demo 

문제 해결

관련 리소스

추가 정보

Dockerfile 편집

다음 코드는 Dockerfile에서 편집하는 명령을 보여줍니다.

FROM public.ecr.aws/lambda/python:3.xx

# Copy function code
COPY app.py ${LAMBDA_TASK_ROOT} 
COPY requirements.txt  ${LAMBDA_TASK_ROOT} 

# install dependencies
RUN pip3 install --user -r requirements.txt

# Set the CMD to your handler (could also be done as a parameter override outside of the Dockerfile)
CMD [ "app.lambda_handler" ]

FROM 명령에서 Lambda에서 지원하는 Python 버전에 적절한 값을 사용합니다(예: 3.12). 이는 퍼블릭 Amazon ECR 이미지 리포지토리에서 사용할 수 있는 기본 이미지입니다. 

이 COPY app.py ${LAMBDA_TASK_ROOT} 명령은 Lambda 함수가 사용할 작업 루트 디렉터리에 코드를 복사합니다. 이 명령은 환경 변수를 사용하므로 실제 경로에 대해 걱정할 필요가 없습니다. 실행할 함수는 CMD [ "app.lambda_handler" ] 명령에 인수로 전달됩니다.

이 COPY requirements.txt 명령은 코드에 필요한 종속성을 캡처합니다. 

이 RUN pip install --user -r requirements.txt 명령은 로컬 사용자 디렉터리에 종속성을 설치합니다. 

이미지를 빌드하려면 다음 명령을 실행합니다.

docker build -t <image name> .

Amazon ECR에 이미지를 추가합니다.

다음 코드에서 aws_account_id를 계정 번호로 바꾸고, 다른 리전을 사용하는 경우 us-east-1을 바꾸십시오. 이 buildspec 파일은 CodeBuild 빌드 번호를 사용하여 이미지 버전을 태그 값으로 고유하게 식별합니다. 이를 요구 사항에 맞게 변경할 수 있습니다.

빌드스펙 사용자 지정 코드

phases:
  install:
    runtime-versions:
       python: 3.xx
  pre_build:
    commands:
      - python3 --version
      - pip3 install --upgrade pip
      - pip3 install --upgrade awscli
      - sudo docker info
  build:
    commands:
      - echo Build started on `date`
      - echo Building the Docker image...
      - ls
      - cd app
      - docker build -t cf-demo:$CODEBUILD_BUILD_NUMBER .
      - docker container ls
  post_build:
    commands:
      - echo Build completed on `date`
      - echo Pushing the Docker image...
      - aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin aws_account_id.dkr.ecr.us-east-1.amazonaws.com
      - docker tag cf-demo:$CODEBUILD_BUILD_NUMBER aws_account_id.dkr.ecr.us-east-1.amazonaws.com/cf-demo:$CODEBUILD_BUILD_NUMBER
      - docker push aws_account_id.dkr.ecr.us-east-1.amazonaws.com/cf-demo:$CODEBUILD_BUILD_NUMBER