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

프로젝트에 대한 디렉터리를 생성하고 해당 디렉터리로 전환합니다.

mkdir hello
cd hello

새 Go 모듈을 초기화합니다.

go mod init example.com/hello-world

lambda 라이브러리를 새 모듈의 종속 구성 요소로 추가합니다.

go get github.com/aws/aws-lambda-go/lambda

이름이 main.go인 파일을 생성하여 텍스트 편집기에서 엽니다. Lambda 함수에 대한 코드입니다. 다음 샘플 코드를 테스트에 사용하거나 사용자 고유의 코드로 바꿀 수 있습니다.

package main

import (
	"context"
	"github.com/aws/aws-lambda-go/events"
	"github.com/aws/aws-lambda-go/lambda"
)

func handler(ctx context.Context, event events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {
	response := events.APIGatewayProxyResponse{
		StatusCode: 200,
		Body:       "\"Hello from Lambda!\"",
	}
	return response, nil
}

func main() {
	lambda.Start(handler)
}

텍스트 편집기를 사용하여 프로젝트 디렉터리에 Dockerfile을 생성합니다.

FROM golang:1.20 as build
WORKDIR /helloworld
# Copy dependencies list
COPY go.mod go.sum ./
# Build with optional lambda.norpc tag
COPY main.go .
RUN go build -tags lambda.norpc -o main main.go
# Copy artifacts to a clean image
FROM public.ecr.aws/lambda/provided:al2023
COPY --from=build /helloworld/main ./main
ENTRYPOINT [ "./main" ]

docker build 명령으로 도커 이미지를 빌드합니다. 다음 예제에서는 이미지 이름을 docker-image로 지정하고 test 태그를 지정합니다.

docker build --platform linux/amd64 -t docker-image:test .

docker run 명령을 사용하여 Docker 이미지를 시작합니다. 유의할 사항:

docker run -d -p 9000:8080 \
--entrypoint /usr/local/bin/aws-lambda-rie \
docker-image:test ./main

이 명령은 이미지를 컨테이너로 실행하고 localhost:9000/2015-03-31/functions/function/invocations에 로컬 엔드포인트를 생성합니다.

새 터미널 창에서 curl 명령을 사용하여 다음 엔드포인트에 이벤트를 게시합니다.

curl "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'

이 명령은 빈 이벤트와 함께 함수를 호출하고 응답을 반환합니다. 일부 함수에는 JSON 페이로드가 필요할 수 있습니다. 예시

curl "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{"payload":"hello world!"}'

컨테이너 ID를 가져옵니다.

docker ps

docker kill 명령을 사용하여 컨테이너를 중지합니다. 이 명령에서 3766c4ab331c를 이전 단계의 컨테이너 ID로 바꿉니다.

docker kill 3766c4ab331c

get-login-password 명령을 실행하여 Amazon ECR 레지스트리에 대해 Docker CLI를 인증합니다.

aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-east-1.amazonaws.com

create-repository 명령을 사용하여 Amazon ECR에 리포지토리를 생성합니다.

aws ecr create-repository --repository-name hello-world --region us-east-1 --image-scanning-configuration scanOnPush=true --image-tag-mutability MUTABLE

성공하면 다음과 같은 응답이 표시됩니다.

{
    "repository": {
        "repositoryArn": "arn:aws:ecr:us-east-1:111122223333:repository/hello-world",
        "registryId": "111122223333",
        "repositoryName": "hello-world",
        "repositoryUri": "111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world",
        "createdAt": "2023-03-09T10:39:01+00:00",
        "imageTagMutability": "MUTABLE",
        "imageScanningConfiguration": {
            "scanOnPush": true
        },
        "encryptionConfiguration": {
            "encryptionType": "AES256"
        }
    }
}

이전 단계의 출력에서 repositoryUri를 복사합니다.

docker tag 명령을 실행하여 로컬 이미지를 Amazon ECR 리포지토리에 최신 버전으로 태깅합니다. 이 명령에서:

docker tag docker-image:test <ECRrepositoryUri>:latest

예시

docker tag docker-image:test 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest

docker push 명령을 실행하여 Amazon ECR 리포지토리에 로컬 이미지를 배포합니다. 리포지토리 URI 끝에 :latest를 포함해야 합니다.

docker push 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest

함수에 대한 실행 역할이 아직 없는 경우 하나 생성합니다. 다음 단계에서는 역할의 Amazon 리소스 이름(ARN)이 필요합니다.

Lambda 함수를 생성합니다. ImageUri의 경우 이전의 리포지토리 URI를 지정합니다. URI 끝에 :latest를 포함해야 합니다.

aws lambda create-function \
  --function-name hello-world \
  --package-type Image \
  --code ImageUri=111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest \
  --role arn:aws:iam::111122223333:role/lambda-ex

함수를 호출합니다.

aws lambda invoke --function-name hello-world response.json

다음과 같은 응답이 표시되어야 합니다.

{
  "ExecutedVersion": "$LATEST", 
  "StatusCode": 200
}

함수의 출력을 보려면 response.json 파일을 확인합니다.

프로젝트에 대한 디렉터리를 생성하고 해당 디렉터리로 전환합니다.

mkdir hello
cd hello

새 Go 모듈을 초기화합니다.

go mod init example.com/hello-world

lambda 라이브러리를 새 모듈의 종속 구성 요소로 추가합니다.

go get github.com/aws/aws-lambda-go/lambda

이름이 main.go인 파일을 생성하여 텍스트 편집기에서 엽니다. Lambda 함수에 대한 코드입니다. 다음 샘플 코드를 테스트에 사용하거나 사용자 고유의 코드로 바꿀 수 있습니다.

package main

import (
	"context"
	"github.com/aws/aws-lambda-go/events"
	"github.com/aws/aws-lambda-go/lambda"
)

func handler(ctx context.Context, event events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {
	response := events.APIGatewayProxyResponse{
		StatusCode: 200,
		Body:       "\"Hello from Lambda!\"",
	}
	return response, nil
}

func main() {
	lambda.Start(handler)
}

텍스트 편집기를 사용하여 프로젝트 디렉터리에 Dockerfile을 생성합니다. 다음 예제 Dockerfile에서는 Alpine 기본 이미지를 사용합니다. 참고로 Dockerfile 예제에는 USER 지침이 포함되어 있지 않습니다. Lambda에 컨테이너 이미지를 배포하면 Lambda는 권한이 최소 권한인 기본 Linux 사용자를 자동으로 정의합니다. 이는 USER 지침이 제공되지 않을 때 root 사용자에게 기본 설정이 적용되는 표준 Docker 동작과는 다릅니다.

FROM golang:1.20.2-alpine3.16 as build
WORKDIR /helloworld
# Copy dependencies list
COPY go.mod go.sum ./
# Build
COPY main.go .
RUN go build -o main main.go
# Copy artifacts to a clean image
FROM alpine:3.16
COPY --from=build /helloworld/main /main
ENTRYPOINT [ "/main" ]

docker build 명령으로 도커 이미지를 빌드합니다. 다음 예제에서는 이미지 이름을 docker-image로 지정하고 test 태그를 지정합니다.

docker build --platform linux/amd64 -t docker-image:test .

프로젝트 디렉터리에서 다음 명령을 실행하여 GitHub에서 런타임 인터페이스 에뮬레이터(x86-64 아키텍처)를 다운로드하고 로컬 시스템에 설치합니다.

docker run 명령을 사용하여 Docker 이미지를 시작합니다. 유의할 사항:

이 명령은 이미지를 컨테이너로 실행하고 localhost:9000/2015-03-31/functions/function/invocations에 로컬 엔드포인트를 생성합니다.

로컬 엔드포인트에 이벤트를 게시합니다.

컨테이너 ID를 가져옵니다.

docker ps

docker kill 명령을 사용하여 컨테이너를 중지합니다. 이 명령에서 3766c4ab331c를 이전 단계의 컨테이너 ID로 바꿉니다.

docker kill 3766c4ab331c

get-login-password 명령을 실행하여 Amazon ECR 레지스트리에 대해 Docker CLI를 인증합니다.

aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-east-1.amazonaws.com

create-repository 명령을 사용하여 Amazon ECR에 리포지토리를 생성합니다.

aws ecr create-repository --repository-name hello-world --region us-east-1 --image-scanning-configuration scanOnPush=true --image-tag-mutability MUTABLE

성공하면 다음과 같은 응답이 표시됩니다.

{
    "repository": {
        "repositoryArn": "arn:aws:ecr:us-east-1:111122223333:repository/hello-world",
        "registryId": "111122223333",
        "repositoryName": "hello-world",
        "repositoryUri": "111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world",
        "createdAt": "2023-03-09T10:39:01+00:00",
        "imageTagMutability": "MUTABLE",
        "imageScanningConfiguration": {
            "scanOnPush": true
        },
        "encryptionConfiguration": {
            "encryptionType": "AES256"
        }
    }
}

이전 단계의 출력에서 repositoryUri를 복사합니다.

docker tag 명령을 실행하여 로컬 이미지를 Amazon ECR 리포지토리에 최신 버전으로 태깅합니다. 이 명령에서:

docker tag docker-image:test <ECRrepositoryUri>:latest

예시

docker tag docker-image:test 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest

docker push 명령을 실행하여 Amazon ECR 리포지토리에 로컬 이미지를 배포합니다. 리포지토리 URI 끝에 :latest를 포함해야 합니다.

docker push 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest

함수에 대한 실행 역할이 아직 없는 경우 하나 생성합니다. 다음 단계에서는 역할의 Amazon 리소스 이름(ARN)이 필요합니다.

Lambda 함수를 생성합니다. ImageUri의 경우 이전의 리포지토리 URI를 지정합니다. URI 끝에 :latest를 포함해야 합니다.

aws lambda create-function \
  --function-name hello-world \
  --package-type Image \
  --code ImageUri=111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest \
  --role arn:aws:iam::111122223333:role/lambda-ex

함수를 호출합니다.

aws lambda invoke --function-name hello-world response.json

다음과 같은 응답이 표시되어야 합니다.

{
  "ExecutedVersion": "$LATEST", 
  "StatusCode": 200
}

함수의 출력을 보려면 response.json 파일을 확인합니다.