를 사용하여 서버리스 애플리케이션 디버깅AWSSAM L - AWS Toolkit for Eclipse

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용하여 서버리스 애플리케이션 디버깅AWSSAM L

이 자습서에서는 다음을 사용하여 Toolkit for Eclipse Toolkit으로 서버리스 애플리케이션 프로젝트를 디버깅하는 과정을 안내합니다.AWSsam Local 기능 SAM Local 기능AWS다음과 같이 작성된 서버리스 애플리케이션을 관리하기 위한 CLI 툴AWS서버리스 애플리케이션 모델 (AWSSAM). 자세한 내용은 SAM Local README를 참조하십시오.

Prerequisites

이 자습서를 사용하려면 Eclipse, Docker 및 Toolkit이 있어야 합니다.AWSSAM Local 설치 단원을 참조하십시오.AWSSAM LREADMEDocker 및 SAM Local 설치 지침은 단원을 참조하십시오.시작하기Eclipse용 툴킷 설치 및 설정에 대한 지침은 주제를 참조하십시오.

참고

이AWSToolkit for Eclipse SAM Local 기능을 사용하려면 프로젝트가 유효한 pom.xml 파일이 포함된 유효한 Maven 프로젝트여야 합니다.

필요한 도구를 설치한 후 Eclipse를 엽니 다.환경설정에서 대화 상자일식메뉴. 아래와 같이 SAM Local 실행 파일 경로를 구성합니다. 이렇게 하면 Toolkit for Eclipse 모음에서 SAM Local 설치 위치를 알 수 있습니다.


            SAM Local 대화 상자

AWS CodeStar 에서 SAM 애플리케이션 가져오기

이 자습서에서는 AWS CodeStar 의 샘플 프로젝트가 필요합니다. 단원을 참조하십시오.에서 서버리스 프로젝트 생성AWSCodeStar자습서에서는AWS CodeStar 사용 설명서를 사용하여 샘플 프로젝트를 생성합니다.

AWS CodeStar 에서 SAM 애플리케이션을 가져오려면

  1. Eclipse 도구 모음에서 Amazon Web Services 메뉴 (로 식별) 를 엽니다.AWS홈페이지 아이콘) 을 선택한 다음가져오기AWSCodeStar 프로젝트. 또는 Eclipse 메뉴 모음에서 를 선택합니다.File,가져오기,AWS,AWSCodeStar 프로젝트.

  2. 샘플 애플리케이션이 생성된 리전을 선택합니다.

  3. 프로젝트 이름 목록에서 샘플 프로젝트를 선택합니다.

  4. Git 자격 증명에 추가합니다. 단원을 참조하십시오.AWSCodeCommit 사용 설명서CodeCommit에 대한 Git 자격 증명을 얻는 방법을 알아봅니다.

    
                  SAM Local 가져오기AWSCodeStar 프로젝트 선택 대화 상자
  5. Next(다음)를 선택합니다.

  6. 선택다음브랜치 선택페이지.

  7. 선택Finish로컬 대상페이지.

이제 Eclipse 내에서 SAM Local을 사용하여 이 서버리스 애플리케이션을 로컬로 디버깅할 수 있습니다.

Lambda 함수 디버깅

서버리스 애플리케이션에 대한 디버그 구성을 생성하고 SAM Local을 사용하여 애플리케이션을 로컬로 실행합니다.

Lambda 함수를 로컬로 디버깅하려면

  1. Eclipse 프로젝트 탐색기에서 HelloWorldHandler.java를 엽니다.

  2. Eclipse 코드 창에서 마우스 오른쪽 버튼을 클릭하고디버그를 선택한 다음 를 선택한 다음AWSSAM L.

    
                  SAM Local 디버그 대화 상자
  3. 이 예제에서는 프로젝트템플릿의 값을 그대로 사용합니다.

  4. 선택Lambda 함수실행 방식필드.

  5. 선택겟엘로월드함수 식별자필드.

  6. 이 예제에서는 Amazon S3 이벤트를 입력합니다. 선택생성다음이벤트입력 상자.

    
                  SAM Local 디버그 대화 상자
  7. Amazon S3 버킷을 가진 리전을 선택합니다.

  8. 유효한 Amazon S3 버킷 이름을 입력합니다.

  9. 유효한 Amazon S3 객체 키를 입력한 후 를 선택한 다음 를 선택합니다.확인.

  10. 다른 이름으로 저장 페이지에서 현재 프로젝트를 선택하고 이벤트 파일의 이름을 입력합니다. 이 예제에서는 s3-event.json을 사용했습니다.

    
                  SAM Local 디버그 대화 상자
  11. 확인을 선택하여 이벤트 파일을 저장하고 메인 대화 상자로 돌아갑니다.

  12. 고급 설정은 현재 값 그대로 둡니다. 이들 필드에 대한 자세한 내용은 고급 설정을 참조하십시오.

  13. [Apply]를 선택한 다음 [Debug]를 선택합니다.

이렇게 하면 Lambda 함수가 로컬로 실행됩니다. 다른 애플리케이션에서와 마찬가지로 중단점을 설정하여 코드를 디버깅할 수 있습니다.

로컬에서 API Gateway 테스트

SAM Local을 통해 HTTP 요청/응답 기능을 테스트할 수도 있습니다.

API Gateway를 로컬로 테스트하려면

  1. Eclipse 코드 창에서 마우스 오른쪽 버튼을 클릭하고 Debug As(디버그)를 선택한 후 디버그 구성을 선택합니다.

    
                  SAM Local 디버그 대화 상자
  2. 이 실행에 대해 새로운 디버그 구성을 생성하고 다른 이름을 지정합니다.

  3. 선택API 게이트웨이실행 방식필드.

  4. 다른 모든 필드는 현재 값 그대로 둔 상태에서 구성은 다음과 비슷해야 합니다.

    
                  SAM Local 디버그 대화 상자
  5. [Apply]를 선택한 다음 [Debug]를 선택합니다.

이렇게 하면 애플리케이션을 테스트하는 데 사용할 수 있는 로컬 API 게이트웨이가 생성됩니다. 디버그 출력에는 코드의 요청/응답 기능을 확인하는 데 사용할 수 있는 HTTP 링크가 포함됩니다.


            API 게이트웨이에 대한 SAM Local 디버그 출력 예제

고급 설정

이 단원에서는 SAM Local 디버그 구성 페이지에서 사용 가능한 고급 옵션들을 설명합니다.


            SAM Local 디버깅 대화 상자 고급 옵션

AWS 구성

프로파일 선택

(필수) 사용할 프로필입니다.AWS자격 증명.

(기본값) 기본 프로필입니다.

지역 선택

(필수 항목) 애플리케이션이 배포되는 리전입니다.

(기본값) 미국 동부(버지니아)

SAM Local 구성

Maven 목표

(필수 항목) 애플리케이션을 빌드할 때 수행할 Maven 목표입니다. 기본 설정에 따라 모든 종속 프로그램이 포함된 Jar 파일(fat Jar)이 생성되지 않는 경우에는 이러한 목표들을 사용자가 지정해야 합니다. fat Jar를 생성하기 위해 플러그인을 사용하는 방법은 Maven 프로젝트의 Maven Shade 플러그인을 참조하십시오.

(기본값) 클린 패키지

SAM 실행 시간

(필수 항목) SAM 실행 파일에 대한 경로입니다.

(기본값) /usr/local/bin/sam

디버깅 포트

(필수 항목) Eclipse 디버거가 SAM Local을 연결하는 데 사용하는 포트입니다.

(기본값) 5858

Env 변수

(선택 사항) Lambda 함수에서 사용되는 환경 변수에 대한 값이 포함된 JSON 파일의 경로입니다. 이 파일에 필요한 구문에 대한 내용은 SAM Local 사용 설명서의 환경 변수 파일을 참조하십시오.

(기본값) 비어 있음

Lambda 함수 구성

코드 URI

(선택 사항) 코드 아카이브 파일에 대한 경로. 이 페이지의 예제에서는 .jar 파일에 대한 경로가 여기에 해당됩니다.

(기본값) template.yml 파일의 경로

제한 시간

(필수) Lambda 함수 실행 제한 시간입니다.

(기본값) 300

추가 정보

에 대한 자세한 내용AWSSAM 로컬,AWSSAM LGitHub의 사용자 안내서. 에 대한 자세한 내용은AWS서버리스 애플리케이션 모델 (SAM) 은 다음을 참조하십시오.AWSSAMGitHub의 프로젝트.