AWS Lambda LocalStack 지원 - AWS VS Code용 도구 키트
사전 조건 LocalStack 설치 LocalStack 설정 VS Code에서 LocalStack 시작 샘플 서버리스 애플리케이션 빌드LocalStack을 사용하여 Lambda 함수 테스트 및 디버깅

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

AWS Lambda LocalStack 지원

에서 LocalStack 지원을 통해 서버리스 애플리케이션을 빌드, 테스트 및 디버깅합니다 AWS Toolkit for Visual Studio Code. LocalStack은 서버리스 애플리케이션의 로컬 테스트를 허용하는 AWS 클라우드 에뮬레이터입니다.

에 대한 자세한 내용은 AWS Lambda 개발자 안내서를 AWS Lambda참조하세요. LocalStack에 대해 자세히 알아보려면 해당 웹 사이트 LocalStack을 방문하세요.

사전 조건

다음은 VS Code에서 LocalStack을 사용하기 위한 사전 조건입니다.

참고

LocalStack CLI는 설정 프로세스 중에 설치되지만 다른 버전의 LocalStack CLI를 선호하는 경우 필요한 최소 버전은 4.8.0입니다.

  • 무료 및 유료 LocalStack 계층에서 사용할 수 있는 모든 기능에 액세스하려면 LocalStack 웹 애플리케이션 계정이 필요합니다. LocalStack 커뮤니티 에디션은 계정 없이 사용할 수 있습니다.

  • VS Code에서 LocalStack을 사용하려면 Docker가 필요합니다. Docker의 LocalStack 요구 사항에 대한 자세한 내용은 LocalStack 설명서의 LocalStack Docker 이미지 주제를 참조하세요.

  • 권장 사항: AWS Command Line Interface (AWS CLI)는 시뮬레이션된 클라우드 환경에서 서비스를 사용하는 데 도움이 됩니다.

LocalStack 설치

LocalStack 무료 및 유료 계층형 버전을 설치하려면 다음 단계를 완료하세요.

참고

LocalStack Community 에디션을 설정하는 방법에 대한 지침은이 주제의 LocalStack 설정 섹션에서 LocalStack Community 콘텐츠를 참조하세요. LocalStack

  1. AWS 도구 키트에서 애플리케이션 BUILDER 탐색기를 확장합니다.

  2. 연습 열기 버튼을 선택하여 VS Code 편집기에서 애플리케이션 빌드 시작하기 연습 탭을 엽니다.

  3. 연습에서 LocalStack 설치를 선택하여 VS Code에서 LocalStack 설치 프로세스를 시작합니다.

LocalStack 설정

VS Code용 LocalStack 확장을 설치한 후 설정이 필요할 때 다음 표시기 중 하나가 표시될 수 있습니다.

  • 기본적으로 IDE의 왼쪽 하단에 있는 VS 코드 상태 표시줄에서 LocalStack 상태는 빨간색입니다.

  • VS Code는 LocalStack을 설정하라는 메시지를 표시합니다.

사용 중인 LocalStack 버전에 따라 LocalStack에 대한 두 가지 유형의 설정 및 구성이 있습니다. 다음 탭 섹션은 각 LocalStack 설정 프로세스를 설명합니다.

참고

LocalStack 인증 토큰은 LocalStack의 무료 및 유료 티어 버전에 필요합니다. LocalStack 요금에 대한 자세한 내용은 플랜 요금 선택 가이드를 참조하세요.

LocalStack을 설정하는 방법에는 두 가지가 있습니다.

  • 시작하려면 VS Code Setup LocalStack 프롬프트에서 Setup 버튼을 선택합니다.

  • VS Code 상태 표시줄에서 LocalStack 상태 아이콘을 선택하여 시작할 LocalStack 설정 프롬프트를 연 다음 설정 버튼을 선택합니다.

설정 중에 시스템은 다음 단계를 거칩니다.

  1. LocalStack CLI를 설치합니다.

  2. LocalStack 계정이 있는지 확인합니다.

  3. LocalStack 계정이 있는 경우 기본 웹 브라우저의 인증 프로세스를 안내합니다. 마찬가지로 LocalStack 계정이 없는 경우 인증 프로세스 전에 계정 설정을 안내합니다.

LocalStack이 설정되면 VS Code 상태 표시줄에서 LocalStack 상태가 업데이트됩니다.

참고

LocalStack에 대한 AWS 프로필을 생성하지 않은 경우 LocalStack 설정 프로세스의 일부로 새 프로필이 자동으로 생성됩니다.

LocalStack의 커뮤니티 에디션은 무료로 사용할 수 있으며 계정에 가입할 필요가 없습니다. 라이선스가 필요하지 않은 도커 이미지에서 실행됩니다. LocalStack Community Edition에 대한 자세한 내용은 LocalStack Community 이미지 설명서를 참조하세요. 다음 섹션에서는 VS Code에서 LocalStack 커뮤니티 에디션을 사용하는 데 필요한 사전 조건과 기본 설정에 대해 설명합니다.

새 인스턴스 시작

LocalStack Community의 새 인스턴스를 시작하려면 다음 절차를 완료하세요.

참고

다음 예시에서는 포트 4566에서 LocalStack의 컨테이너 인스턴스를 시작합니다. 다른 포트 값을 지정하는 경우 AWS CLI 및 AWS 도구 키트 구성 섹션에 있는 절차에 지정된 포트 값을 업데이트해야 합니다.

  1. VS Code에서를 눌러 VS Code 터미널을 엽니다ctrl + `(backtick).

  2. 터미널에 다음을 입력합니다.

    Mac:

    docker run -d --name localstack_main \
>> -p 4566:4566 \
>> -v /var/run/docker.sock:/var/run/docker.sock \
>> localstack/localstack

    Windows:

    docker run -d --name localstack_main `
>> -p 4566:4566 `
>> -v /var/run/docker.sock:/var/run/docker.sock `
>> localstack/localstack

  3. 프로세스가 완료되면 터미널이 Docker 인스턴스의 상태로 업데이트됩니다.

이 컨테이너화된 LocalStack 인스턴스를 사용하면 다운로드 프로세스 중에 지정한 AWS 서비스에 액세스할 수 있습니다.

LocalStack 및 Docker용 CLI 구성.

Docker에서 LocalStack으로 작업하도록 AWS CLI 및 AWS 도구 키트를 구성하려면 다음 단계를 완료하여 새 프로파일을 설정합니다.

  1. VS Code에서를 눌러 VS Code 터미널을 엽니다ctrl + `(backtick).

  2. 터미널에 다음을 입력합니다.

    ~/.aws/credentials
[localstack]
aws_access_key_id = test
aws_secret_access_key = test
~/.aws/config
[profile localstack]
region = us-east-1
output = json
endpoint_url = http://localhost:4566 [default localstack endpoint]

  3. AWS 도구 키트는 LocalStack 프로필을 감지하고 연결 상태 메뉴를 업데이트합니다.

설정 후 상태 표시줄의 프로필 섹션에서 LocalStack AWS 프로필을 선택하면 AWS 탐색기에 LocalStack 리소스가 표시됩니다. 또한 VS Code 터미널의 출력 탭에서 LocalStack 로그를 볼 수 있습니다.

VS Code에서 LocalStack 시작

다음 방법 중 하나를 사용하여 LocalStack을 시작할 수 있습니다.

VS 코드 상태 표시줄에서 LocalStack 시작

  1. VS Code에서 상태 표시줄로 이동한 다음 LocalStack 시작 버튼을 선택하여 LocalStack을 시작합니다.

  2. LocalStack이 성공적으로 시작되면 VS 코드 상태 표시줄이 업데이트됩니다.

VS 코드 명령 팔레트에서 LocalStack 시작

  1. VS Code에서 Cmd + Shift + P (Mac) 또는 Control + Shift + P (Windows)를 눌러 Command Palette를 엽니다.

  2. Command Palette의 검색 창에 Start LocalStack를 입력하고 결과에 채워지면 목록에서 선택합니다.

  3. LocalStack이 성공적으로 시작되면 VS 코드 상태 표시줄이 업데이트됩니다.

VS Code 터미널에서 LocalStack 시작

  1. VS Code에서를 눌러 VS Code 터미널을 엽니다ctrl + `(backtick).

  2. VS Code 터미널에서 localstack start CLI 명령을 입력합니다.

  3. LocalStack이 성공적으로 시작되면 VS 코드 상태 표시줄이 업데이트됩니다.

샘플 서버리스 애플리케이션 빌드

VS Code에서 LocalStack 작업을 시작하려면 샘플 서버리스 애플리케이션이 필요합니다. AWS 계정에 기존 애플리케이션이 이미 있는 경우 LocalStack을 사용하여 로컬로 배포하거나 AWS Serverless Land를 사용하여 새 애플리케이션을 생성할 수 있습니다.

도구 키트에서 서버리스 랜드를 사용하여 애플리케이션을 생성하는 방법에 AWS 대한 자세한 내용은이 사용 설명서의 AWS 서버리스 랜드 작업 주제를 참조하세요. Serverless Land에 대한 자세한 내용은 Serverless Land 웹 애플리케이션 기본 랜딩 페이지를 참조하세요.

LocalStack을 사용하여 Lambda 함수 테스트 및 디버깅

LocalStack VS Code 확장에서 Lambda 함수를 테스트하고 디버깅하는 것은 AWS 클라우드에 배포된 함수로 작업하는 것과 유사합니다. 주요 차이점은 LocalStack을 사용하여 함수를 배포하고 디버깅하려면 AWS Toolkit 인스턴스를 LocalStack 계정으로 인증해야 한다는 것입니다.

참고

이 섹션에 설명된 테스트 및 디버깅 기능은 LocalStack Community 에디션에서 사용할 수 없습니다.

VS Code에서 LocalStack을 사용하려면 도구 키트의 LocalStack 프로파일에 AWS 연결합니다. LocalStack 프로파일이 활성화되면 VS Code 상태 표시줄에 확인 표시가 있는 AWS: profile:localstack(사용자 지정 엔드포인트)이 표시됩니다.

AWS 도구 키트에서 Lambda 함수 작업에 대한 자세한 내용은이 사용 설명서의 AWS Lambda 함수 작업 주제를 참조하세요.