기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # AWS Toolkit for Visual Studio Code 시작하기 AWS Toolkit for Visual Studio Code를 통해 VS Code 통합 개발 환경(IDE)에서 AWS 서비스와 리소스를 사용할 수 있습니다. 다음 항목에서는 AWS Toolkit for Visual Studio Code 설정, 설치 및 구성 방법을 설명합니다. **Topics** + [ # 설치AWS Toolkit for Visual Studio Code ](setup-toolkit.md) + [ # 에 연결 AWS ](connect.md) + [ # AWS 리전 변경 ](setup-region.md) + [ # 툴체인 구성 ](setup-toolchain.md) # 설치AWS Toolkit for Visual Studio Code ## 사전 조건 VS Code에서 AWS Toolkit for Visual Studio Code로 작업하려면 다음 전제 조건을 충족해야 합니다. AWS Toolkit for Visual Studio Code에서 사용할 수 있는 모든 AWS 서비스와 리소스에 액세스하는 방법에 대한 자세한 내용은 본 설명서에서 [추가 필수 조건](#setup-prereq-opt) 섹션을 참조하세요. + Windows, macOS, Linux 운영 체제에서 VS Code를 사용할 수 있습니다. + VS Code 1.73.0 이상 버전에서 AWS Toolkit for Visual Studio Code를 사용할 수 있습니다. VS Code에 대한 자세한 정보를 확인하거나 VS Code 최신 버전을 다운로드하려면 [VS Code downloads](https://code.visualstudio.com/downloads) 웹 사이트를 참조하십시오. ## AWS Toolkit for Visual Studio Code 다운로드 및 설치 IDE의 VS Code Marketplace에서 AWS Toolkit for Visual Studio Code를 다운로드, 설치 및 설정할 수 있습니다. 또는 웹 브라우저에서 [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.aws-toolkit-vscode)로 이동하여 AWS Toolkit for Visual Studio Code 설치 파일을 다운로드할 수 있습니다. **VS Code IDE Marketplace에서 AWS Toolkit for Visual Studio Code 설치** 1. [VS Code 마켓플레이스](vscode:extension/amazonwebservices.aws-toolkit-vscode) 링크를 클릭하여 VS Code IDE에서 AWS Toolkit for Visual Studio Code 확장 프로그램을 여세요. **참고** VS Code가 컴퓨터에서 실행되지 않다면 VS Code가 로드되는 데 잠시 시간이 걸릴 수 있습니다. 1. VS Code Marketplace의 AWS Toolkit for Visual Studio Code 확장 프로그램에서 **설치**를 선택하여 설치를 시작하세요. 1. 메시지가 표시된 후, VS Code를 재시작하면 설치 프로세스가 완료됩니다. ## 추가 필수 조건 AWS Toolkit for Visual Studio Code의 특정 기능을 사용하려면 다음이 있어야 합니다. + **Amazon Web Services(AWS) 계정**: AWS 계정이 있어야 AWS Toolkit for Visual Studio Code를 사용할 수 있는 것은 아니지만 계정이 없으면 사용할 수 있는 기능이 크게 제한됩니다. AWS 계정을 생성하려면 [AWS 홈페이지](https://aws.amazon.com/)로 이동하세요. (이전에 사이트를 방문한 적이 있는 경우) **AWS Account 만들기** 또는 **가입 완료**를 선택합니다. + **Code Development** - 사용할 언어 관련 SDK입니다. 다음 링크에서 다운로드하거나 선호하는 패키지 관리자를 사용하세요. + .NET SDK: [https://dotnet.microsoft.com/download](https://dotnet.microsoft.com/download) + Node.js SDK: [https://nodejs.org/en/download](https://nodejs.org/en/download) + Python SDK: [https://www.python.org/downloads](https://www.python.org/downloads) + Java SDK: [https://aws.amazon.com/corretto/](https://aws.amazon.com/corretto/) + Go SDK: [https://golang.org/doc/install](https://golang.org/doc/install) + **AWS SAM CLI** – AWS CLI 도구로 로컬 서버리스 애플리케이션 개발, 테스트 및 분석을 할 수 있습니다. 이는 도구 키트를 설치하는 데 필요하지 않습니다. 그러나 [새 서버리스 애플리케이션 생성 (로컬)](sam-get-started.md#serverless-apps-create)과 같은 AWS Serverless Application Model(AWS SAM) 기능에 필요하므로 CLI(및 도커, 다음에 설명)를 설치하는 것이 좋습니다. 자세한 내용은 [AWS Serverless Application Model 개발자 가이드](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html)에서 AWS SAM CLI 설치를 참조하세요. + **Docker** – AWS SAM CLI는 이 오픈 소스 소프트웨어 컨테이너 플랫폼에서 실행합니다. 자세한 정보를 참조하거나 지침을 다운로드하려면 [Docker](https://www.docker.com/)를 참조하세요. + **Package Manager** - 애플리케이션 코드를 다운로드하고 공유할 수 있는 패키지 관리자입니다. + .NET: [NuGet](https://www.nuget.org/downloads) + Node.js: [npm](https://www.npmjs.com/package/npm) + Python: [pip](https://pypi.org/project/pip/) + Java: [Gradle](https://gradle.org/install/) 또는 [Maven](https://maven.apache.org/download.cgi) # 에 연결 AWS 대부분의 Amazon Web Services(AWS) 리소스는 AWS 계정을 통해 관리됩니다. 계정 AWS 은를 사용할 필요가 AWS Toolkit for Visual Studio Code없지만 도구 키트 함수는 연결 없이 제한됩니다. 이전에 다른 AWS 서비스(예: AWS Command Line Interface)를 통해 AWS 계정 및 인증을 설정한 경우는 자격 증명을 AWS Toolkit for Visual Studio Code 자동으로 감지합니다. ## 사전 조건 를 처음 AWS 사용하거나 계정을 생성하지 않은 경우를 AWS 계정 AWS Toolkit for Visual Studio Code 과 연결하는 세 가지 주요 단계가 있습니다. 1. ** AWS 계정 가입**: 가입 AWS [AWS 포털]( https://portal.aws.amazon.com/billing/signup)에서 계정에 가입할 수 있습니다. 새 AWS 계정 설정에 대한 자세한 내용은 *AWS 설정 사용 설명서*의 [ 개요 ](https://docs.aws.amazon.com//SetUp/latest/UserGuide/setup-overview.html)주제를 참조하세요. 1. **인증 설정**:에서 AWS 계정으로 인증하는 세 가지 기본 방법이 있습니다 AWS Toolkit for Visual Studio Code. 3가지 방법에 대해 자세히 알아보려면 사용 설명서의 [Authentication and Access](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/establish-credentials.html)(인증 및 액세스)를 참조하세요. 1. **도구 키트 AWS 에서 로 인증**:이 사용 설명서의 다음 섹션에 있는 절차를 완료하여 도구 키트에서 AWS 계정에 연결할 수 있습니다. ## 로그인 패널 열기 **AWS Toolkit 로그인** 패널을 열려면 다음 절차 중 하나를 완료하세요. **AWS 탐색기에서 **AWS 도구 키트 로그인** 패널을 열려면:** 1. 에서 **EXPLORER**를 AWS Toolkit for Visual Studio Code확장합니다. 1. **…** 아이콘을 선택하여 **추가 작업…** 메뉴를 확장합니다. 1. **추가 작업…** 메뉴에서 ** AWS에 연결**을 선택하여 **AWS Toolkit 로그인** 패널을 엽니다. **VS Code 명령 팔레트를 사용하여 **AWS Toolkit 로그인** 패널을 여는 방법** 1. **Shift\$1Command\$1P** (**Ctrl\$1Shift\$1P** Windows)를 눌러 명령 팔레트를 엽니다. 1. 검색 필드에 **AWS: Add a New Connection**을 입력합니다. 1. **AWS: Add a New Connection**을 선택하여 **AWS Toolkit 로그인** 패널을 엽니다. ## 도구 키트 AWS 에서에 연결 ### SSO로 인증 및 연결 를 AWS 사용하여를 인증하고 연결하려면 다음 절차를 AWS IAM Identity Center완료하세요. **참고** AWS Builder ID 또는 IAM Identity Center를 사용한 인증은 기본 웹 브라우저에서 AWS 권한 부여 포털을 시작합니다. 자격 증명이 만료될 때마다이 프로세스를 반복하여 AWS 계정과 간의 연결을 갱신해야 합니다 AWS Toolkit for Visual Studio Code. **AWS IAM Identity Center 인증 및 연결** 1. **AWS Toolkit 로그인** 패널에서 **작업 인력** 탭을 선택하고, **계속** 버튼을 선택하여 계속 진행합니다. 1. **IAM Identity Center로 로그인** 패널에서 조직의 **시작 URL**을 입력합니다. 해당 URL은 회사의 관리자 또는 헬프데스크가 제공합니다. 1. 드롭다운 메뉴에서 AWS **리전**을 선택합니다. ID 디렉터리를 호스팅하는 AWS 리전입니다. 1. **계속** 버튼을 선택하고 기본 웹 브라우저에서 **AWS 인증 요청** 웹 사이트를 열 것인지 확인합니다. 1. 기본 웹 브라우저의 메시지에 따라 인증 프로세스가 완료되면 알림을 받게 되며, 브라우저를 닫고 VS Code로 돌아가도 안전합니다. ### IAM 보안 인증으로 인증 및 연결 IAM 자격 증명을 AWS 사용하여를 인증하고 연결하려면 다음 절차를 완료하세요. **IAM 보안 인증으로 인증 및 연결** 1. **AWS Toolkit 로그인** 패널에서 **IAM 자격 증명을** 선택한 다음 **계속** 버튼을 선택하여 계속 진행합니다. 1. 제공된 필드에 AWS 계정**Secret Key**의 **Access Key**, 및 **Profile Name**를 입력한 다음 **계속** 버튼을 선택하여 프로필을 구성 파일에 추가하고 도구 키트를 AWS 계정에 연결합니다. 1. 인증이 완료되고 연결이 설정되면 Toolkit **AWS 탐색기**가 업데이트되어 AWS 서비스 및 리소스를 표시합니다. ## Amazon CodeCatalyst 인증 도구 키트에서 CodeCatalyst 작업을 시작하려면 AWS Builder ID 또는 IAM Identity Center 자격 증명으로 인증하고 연결합니다. 다음 절차에서는 Toolkit를 인증하고 AWS 계정과 연결하는 방법을 설명합니다. **AWS Builder ID로 인증 및 연결** 1. **AWS Toolkit 로그인** 패널에서 **작업 인력** 탭을 선택하고, **계속** 버튼을 선택하여 계속 진행합니다. 1. **SSO로 로그인** 패널 상단에서 **로그인으로 건너뛰기** 링크를 선택합니다. 1. 기본 웹 브라우저의 메시지에 따라 인증 프로세스가 완료되면 알림을 받게 되며, 브라우저를 닫고 VS Code로 돌아가도 안전합니다. **IAM Identity Center로 인증 및 연결** 1. **AWS Toolkit 로그인** 패널에서 **작업 인력** 탭을 선택하고, **계속** 버튼을 선택하여 계속 진행합니다. 1. **IAM Identity Center로 로그인** 패널에서 조직의 **시작 URL**을 입력합니다. 해당 URL은 회사의 관리자 또는 헬프데스크가 제공합니다. 1. 드롭다운 메뉴에서 AWS **리전**을 선택합니다. ID 디렉터리를 호스팅하는 AWS 리전입니다. 1. **계속** 버튼을 선택하고 기본 웹 브라우저에서 **AWS 인증 요청** 웹 사이트를 열 것인지 확인합니다. 1. 기본 웹 브라우저의 메시지에 따라 인증 프로세스가 완료되면 알림을 받게 되며, 브라우저를 닫고 VS Code로 돌아가도 안전합니다. # AWS 리전 변경 AWS 리전에 따라 AWS 리소스가 관리되는 위치가 지정됩니다. AWS Toolkit for Visual Studio Code에서 AWS 계정에 연결하면 기본 AWS 리전이 감지되어 **AWS Explorer**에 자동으로 표시됩니다. 다음 섹션에서는 **AWS Explorer**에서 리전을 추가하고 숨기는 방법을 설명합니다. ## AWS Explorer에 리전 추가 다음 절차를 완료하여 AWS Explorer에 리전을 추가하세요. 1. VS Code 기본 메뉴에서 **보기**를 확장한 다음 **명령 팔레트**를 선택하여 **명령 팔레트**를 여세요. 또는 아래의 바로 가기 키를 사용하세요. + Windows 및 Linux - **Ctrl\$1Shift\$1P** 키를 누릅니다. + macOS - **Shift\$1Command\$1P** 키를 누릅니다. 1. **명령 팔레트**에서 **AWS: Show or Hide Regions**를 검색한 다음 **AWS: 리전 표시 또는 숨기기**를 선택하면 사용 가능한 리전 목록이 표시됩니다. 1. 목록에서 **AWS Explorer**에 추가할 AWS 리전을 선택하세요. 1. **확인** 버튼을 선택하여 선택 사항을 확인하고 **AWS Explorer**를 업데이트합니다. ## AWS Explorer에서 리전 숨기기 다음 절차를 완료하여 AWS Explorer 보기에서 리전을 숨기세요. 1. **AWS Explorer**에서 숨기려는 AWS 리전을 찾으세요. 1. 숨기려는 리전에 대한 컨텍스트(마우스 우클릭) 메뉴를 엽니다. 1. **리전 표시 또는 숨기기를** 선택하여 VS Code에서 **AWS: 리전 표시 또는 숨기기** 옵션을 엽니다. 1. AWS Explorer 보기에서 숨기려는 리전을 선택 취소합니다. # 툴체인 구성 AWS Toolkit for Visual Studio Code은 모든 AWS 서비스에 다양한 언어를 지원합니다. 다음 섹션은 언어에 맞게 툴체인을 구성하는 방법을 설명합니다. ## .NET Core 툴체인 구성 1. AWS VS Code용 도구 키트가 [설치](setup-toolkit.md#setup-install)되어 있는지 확인하세요. 1. [C\$1 확장 프로그램](https://marketplace.visualstudio.com/items?itemName=ms-vscode.csharp)을 설치합니다. 확장 프로그램을 설치하면 VS Code로 .NET Core 애플리케이션을 디버깅할 수 있습니다. 1. AWS Serverless Application Model(AWS SAM) 애플리케이션을 열거나 [새로 생성하세요](sam-get-started.md#serverless-apps-create). 1. `template.yaml`가 포함된 폴더를 엽니다. ## Node.js 툴체인 구성 1. AWS Toolkit for VS Code가 [설치](setup-toolkit.md#setup-install)되어 있는지 확인하세요. 1. AWS SAM 애플리케이션을 열거나 [새로 생성하세요](sam-get-started.md#serverless-apps-create). 1. `template.yaml`이 포함된 폴더를 엽니다. **참고** 소스 코드(`"target": "code"`가 포함된 시작 구성)에서 TypeScript Lambda 함수를 디버깅하려면 TypeScript 컴파일러를 전역적으로 또는 `package.json` 프로젝트에 설치하세요. ## Python 툴체인 구성 1. AWS VS Code용 도구 키트가 [설치](setup-toolkit.md#setup-install)되어 있는지 확인하세요. 1. [Python extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-python.python)을 설치합니다. 확장 프로그램을 설치하면 VS Code로 Python 애플리케이션을 디버깅할 수 있습니다. 1. AWS SAM 애플리케이션을 열거나 [새로 생성하세요](sam-get-started.md#serverless-apps-create). 1. `template.yaml`이 포함된 폴더를 엽니다. 1. 애플리케이션 루트에서 터미널을 열고 `python -m venv ./.venv`를 실행하여 `virtualenv`를 구성하세요. **참고** `virtualenv` 시스템당 한 번만 구성하면 됩니다. 1. 다음 중 하나를 실행하여 `virtualenv`를 활성화합니다. + Bash shell: `./.venv/Scripts/activate` + PowerShell: `./.venv/Scripts/Activate.ps1` ## Java 툴체인 구성 1. AWS Toolkit for VS Code가 [설치](setup-toolkit.md#setup-install)되어 있는지 확인하세요. 1. [Java 확장 프로그램과 Java 11](https://marketplace.visualstudio.com/items?itemName=redhat.java)을 설치합니다. 확장 프로그램을 설치하면 VS Code로 Java 함수를 인식할 수 있습니다. 1. [Java 디버거 확장 프로그램](https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-debug)을 설치합니다. 확장 프로그램을 설치하면 VS Code로 Java 애플리케이션을 디버깅할 수 있습니다. 1. AWS SAM 애플리케이션을 열거나 [새로 생성하세요](sam-get-started.md#serverless-apps-create). 1. `template.yaml`이 포함된 폴더를 엽니다. ## Go 툴체인 구성하기 1. AWS VS Code용 도구 키트가 [설치](setup-toolkit.md#setup-install)되어 있는지 확인하세요. 1. Go Lambda 함수를 디버깅하려면 Go 1.14 이상이어야 합니다. 1. [Go extension](https://marketplace.visualstudio.com/items?itemName=golang.Go)을 설치합니다. **참고** Go1.15\$1 런타임을 디버깅하려면 버전 0.25.0 이상이어야 합니다. 1. [command palette](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/toolkit-navigation.html#command-locations)로 Go 도구를 설치하세요. 1. command palette에서 `Go: Install/Update Tools`을 선택합니다. 1. 체크 박스에서 `dlv` 및 `gopls`를 선택합니다. 1. AWS SAM 애플리케이션을 열거나 [새로 생성하세요](sam-get-started.md#serverless-apps-create). 1. `template.yaml`이 포함된 폴더를 엽니다. ## 툴체인 사용 툴체인을 설정하면 AWS SAM 애플리케이션을 [실행하거나 디버깅](sam-get-started.md#serverless-apps-debug)할 수 있습니다.