빠른 시작: 애플리케이션 게시

애플리케이션을 초기화하려면

1. AWS SAM CLI 명령 프롬프트에서 다음 명령을 실행합니다.

   sam init --runtime python3.6 

2. 명령을 통해 생성된 디렉터리(sam-app/)의 내용을 검토합니다.

   • template.yaml— Hello World 애플리케이션에 필요한 두 가지AWS 리소스, 즉 GET 작업을 지원하는 Lambda 함수와 API Gateway 엔드포인트를 정의합니다. 또한 템플릿은 두 리소스 간의 매핑을 정의합니다.

   • Hello World 애플리케이션 코드와 관련된 내용:

     • hello_world/디렉토리 — 실행hello world 시 반환되는 애플리케이션 코드를 포함합니다.

   참고

   이 연습에서는 애플리케이션 코드가 Python으로 작성되었으며 init 명령으로 런타임을 지정합니다. AWS Lambda에서는 이 밖의 언어로도 애플리케이션 코드를 작성할 수 있습니다. 지원되는 다른 런타임을 지정할 경우 init 명령이 지정된 언어로 작성된 Hello World 코드와 해당 언어에 따라 참조할 수 있는 README.md 파일을 제공합니다. 지원되는 런타임에 대한 자세한 내용은 Lambda 실행 환경 및 사용 가능한 라이브러리를 참조하십시오.

로컬로 애플리케이션을 테스트하려면

1. API Gateway 엔드포인트를 로컬로 시작합니다. template.yaml 파일이 들어 있는 디렉터리에서 다음 명령을 실행해야 합니다.

   sam-app> sam local start-api --region us-east-1

   이 명령은 로컬 테스트를 위해 요청을 보낼 수 있는 API Gateway 엔드포인트를 반환합니다.

2. 애플리케이션을 테스트합니다. API Gateway 엔드포인트 URL을 복사하여 브라우저에 붙여넣고 Enter를 선택합니다. API Gateway 엔드포인트 URL의 예는 다음과 같습니다http://127.0.0.1:3000/hello.

   API Gateway 엔드포인트가 매핑되는 Lambda 함수를 로컬로 호출합니다. Lambda 함수는 로컬 Docker 컨테이너에서 실행되고hello world 반환됩니다. API Gateway는 텍스트가 포함된 브라우저에 응답을 반환합니다.

1. /hello_world/app.py 파일을 편집하여 메시지 문자열을 'hello world'에서 'Hello World!'로 변경합니다.

2. 브라우저에서 테스트 URL을 다시 로드하여 새 문자열을 확인합니다.

Lambda 배포 패키지 만들려면

1. AWS SAM 템플릿 파일에 필요한 애플리케이션 정보를 제공하는 Metadata 섹션을 추가합니다. AWS SAM템플릿Metadata 섹션에 대한 자세한 내용은 AWS Serverless Application Model개발자 안내서의AWS SAM 템플릿 메타데이터 섹션 속성을 참조하십시오.

   다음은 예제 Metadata 섹션입니다.

   Metadata:
     AWS::ServerlessRepo::Application:
       Name: my-app
       Description: hello world
       Author: user1
       SpdxLicenseId: Apache-2.0
       LicenseUrl: LICENSE.txt
       ReadmeUrl: README.md
       Labels: ['tests']
       HomePageUrl: https://github.com/user1/my-app-project
       SemanticVersion: 0.0.1
       SourceCodeUrl: https://github.com/user1/my-app-project

   LicenseUrl및ReadmeUrl 속성은 로컬 파일에 대한 참조 (위 예제 참조) 이거나 이미 이러한 아티팩트를 호스팅하는 Amazon S3 버킷에 대한 링크일 수 있습니다.

2. 패키징된 코드를 저장할 위치에 S3 버킷을 생성합니다. 기존 S3 버킷을 사용하려면 이 단계를 건너뜁니다.

   sam-app> aws s3 mb s3://bucketname

3. 다음packageAWS SAM CLI 명령을 실행하여 Lambda 함수 배포 패키지를 생성합니다.

   sam-app> sam package \
       --template-file template.yaml \
       --output-template-file packaged.yaml \
       --s3-bucket bucketname

   명령은 다음 작업을 수행합니다.

   • aws-sam/hello_world/디렉터리의 콘텐츠를 압축하여 Amazon S3에 업로드합니다.

   • 배포 패키지, README 파일 및 라이선스 파일을--s3-bucket 옵션에서 지정한 Amazon S3 버킷에 업로드합니다.

   • 새로운 템플릿 파일 packaged.yaml을 출력합니다. 이 파일은 다음 단계에서 애플리케이션을 AWS Serverless Application Repository에 게시하는 데 사용됩니다. packaged.yaml템플릿 파일은 원본 템플릿 파일 (template.yaml) 과 유사하지만 주요 차이점이 있습니다. 즉CodeUriLicenseUrl, 및ReadmeUrl 속성은 Amazon S3 버킷 및 해당 아티팩트가 포함된 객체를 가리킵니다. 예제 packaged.yaml 템플릿 파일의 다음 코드 조각은 CodeUri 속성을 보여 줍니다.

     HelloWorldFunction:
         Type: AWS::Serverless::Function # For more information about function resources, see https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction
         Properties:
           CodeUri: s3://bucketname/fbd77a3647a4f47a352fcObjectGUID
     
     ...

서버리스 애플리케이션을 AWS Serverless Application Repository에 게시하려면

• 다음 명령을 실행하여 0.0.1이라는 최초 버전으로 새 애플리케이션을 AWS Serverless Application Repository에 게시합니다.

  sam-app> sam publish \
      --template packaged.yaml \
      --region us-east-1