기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 문제 해결 AWS Toolkit for Visual Studio
다음 섹션에는 도구 키트의 AWS Toolkit for Visual Studio 및 AWS 서비스 작업에 대한 일반적인 문제 해결 정보가 포함되어 있습니다.
**참고**
설치 및 설정별 문제 해결 정보는 이 사용 설명서에 있는 [설치 문제 해결](https://docs.aws.amazon.com//toolkit-for-visual-studio/latest/user-guide/setup-troubleshoot.html) 주제에서 확인할 수 있습니다.
**Topics**
+ [문제 해결 모범 사례](#general-troubleshoot-best-practice)
+ [Amazon Q 보안 스캔 보기 및 필터링](#general-troubleshoot-Q-securityscan)
+ [AWS 도구 키트가 제대로 설치되지 않았습니다.](#general-troubleshoot-component-initilization)
+ [방화벽 및 프록시 설정](#general-troubleshoot-firewall)
## 문제 해결 모범 사례
다음은 AWS Toolkit for Visual Studio 문제 해결 시 권장되는 모범 사례입니다.
+ Visual Studio 복구 및 시스템 다시 시작
+ 보고서를 보내기 전에 문제나 오류를 재생성해 봅니다.
+ 재생성 프로세스 중에 각 단계, 설정 및 오류 메시지를 자세히 기록해 둡니다.
+ AWS 도구 키트 로그를 수집합니다. 도구 키트 로그를 찾는 AWS 방법에 대한 자세한 설명은이 가이드 주제에 있는 [AWS 로그를 찾는 방법](#general-troubleshoot-procedure-logs) 절차를 참조하세요.
+ AWS Toolkit for Visual Studio GitHub 리포지토리의 문제 섹션에서 미해결 요청, 알려진 솔루션을 확인하거나 해결되지 않은 [AWS Toolkit for Visual Studio 문제를](https://github.com/aws/aws-toolkit-visual-studio/issues) 보고합니다.
**Visual Studio 복구 및 시스템 다시 시작**
1. 실행 중인 모든 Visual Studio 인스턴스를 닫습니다.
1. Windows 시작 메뉴에서 **Visual Studio 설치 프로그램**을 시작합니다.
1. Visual Studio의 영향을 받는 설치에서 복구를 실행합니다. 이를 통해 Visual Studio는 설치된 확장의 인덱스를 다시 빌드할 수 있습니다.
1. Visual Studio를 다시 시작하기 전에 Windows를 다시 시작합니다.
**AWS 도구 키트 로그를 찾는 방법**
1. Visual Studio 기본 메뉴에서 **확장**을 확장하세요.
1. **AWS 도구 키트를** 선택하여 AWS 도구 키트 메뉴를 확장한 다음 **도구 키트 로그 보기를** 선택합니다.
1. 운영 체제에서 AWS 도구 키트 로그 폴더가 열리면 파일을 날짜별로 정렬하고 현재 문제와 관련된 정보가 포함된 로그 파일을 찾습니다.
## Amazon Q 보안 스캔 보기 및 필터링
Visual Studio에서 Amazon Q 보안 스캔을 보려면 Visual Studio 기본 메뉴에서 **보기** 제목을 확장하고 **오류 목록**을 선택하여 Visual Studio **오류 목록**을 엽니다.
기본적으로 Visual Studio **오류 목록**에는 코드 기반에 대한 모든 경고 및 오류가 표시됩니다. Visual Studio **오류 목록**에서 Amazon Q 보안 스캔 조사 결과를 필터링하려면 다음 절차를 완료하여 필터를 생성합니다.
**참고**
Amazon Q 보안 스캔 조사 결과는 보안 스캔을 실행하여 문제가 감지된 후에만 표시됩니다.
Amazon Q 보안 스캔 조사 결과는 Visual Studio에 경고로 표시됩니다. Amazon Q 보안 스캔 조사 결과를 보려면 **오류 목록**에서 **오류 목록** 제목의 **경고** 옵션을 선택해야 합니다.
1. Visual Studio 기본 메뉴에서 **보기** 제목을 확장한 다음 **오류 목록**을 선택하여 **오류 목록** 창을 엽니다.
1. **오류 목록** 창에서 헤더 행을 마우스 오른쪽 버튼으로 클릭하여 컨텍스트 메뉴를 엽니다.
1. 컨텍스트 메뉴에서 **열 표시**를 확장한 다음 확장된 메뉴에서 **도구**를 선택합니다.
1. **도구** 열이 **오류 목록**에 추가됩니다.
1. **도구** 열 헤더에서 **필터** 아이콘을 선택하고 Amazon Q를 선택하여 Amazon Q 보안 스캔 조사 결과를 필터링합니다.
## AWS 도구 키트가 제대로 설치되지 않았습니다.
**문제:**
Visual Studio를 시작한 후 AWS Toolkit for Visual Studio 1분 이내에 출력 창과 정보 표시줄에 각각 다음 메시지가 표시됩니다.
`Some Toolkit components could not be initialized. Some functionality may not work during this IDE session.`
`The AWS Toolkit is not properly installed.`
**해결 방법**:
확장을 업데이트하거나 설치하면 Visual Studio의 일부 내부 캐시 파일이 동기화되지 않을 수 있습니다. 다음 절차에서는 다음에 Visual Studio를 시작할 때 이러한 파일을 다시 빌드하는 방법을 설명합니다.
**참고**
이 솔루션은 Visual Studio 사용자 지정에 영향을 미칠 수 있습니다. 이 절차를 완료한 후에는 AWS 도구 키트 확장이 설치된 것으로 나열되고 더 이상 오류 메시지를 보고하지 않아야 합니다. 다음 단계를 완료한 후에도이 문제가 계속 발생하면 AWS Toolkit for Visual Studio GitHub 리포지토리의 [문제 \$1452](https://github.com/aws/aws-toolkit-visual-studio/issues/452)를 참조하세요.
1. 최신 버전의 Visual Studio 2022를 설치합니다.
**참고**
최소 필수 버전은 17.11.5입니다.
1. 실행 중인 모든 Visual Studio 인스턴스를 닫습니다.
1. Windows에서 **개발자 명령 프롬프트**를 관리자 권한으로 엽니다.
1. **개발자 명령 프롬프트**에서 `devenv /updateconfiguration /resetExtensions` 명령을 실행한 다음 명령이 완료될 때까지 기다립니다.
1. 명령이 완료되면 Visual Studio를 다시 시작합니다.
1. Visual Studio에서 AWS 확장은 이제 설치된 것으로 나열되며 더 이상이 문제의 맨 위에 나열된 오류 메시지를 보고하지 않습니다.
## 방화벽 및 프록시 설정
### 방화벽 및 프록시 설정 문제 해결
보안 스캔 소프트웨어는 다운로드에서 파일을 제거하거나 다운로드를 완전히 방지하여 AWS 툴킷 언어 서버에서 파일을 다운로드하는 기능을 방해할 수 있습니다.
방화벽 및 프록시 설정을 확인하려면 Visual Studio 인스턴스와 동일한 시스템에 설치된 인터넷 브라우저에서 [https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json](https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json)으로 이동합니다. 오류가 발생하거나 페이지를 로드할 수 없는 경우 방화벽 또는 프록시 필터로 인해 `aws-toolkit-language-servers.amazonaws.com`에 도달하지 못할 수 있습니다.
### 사용자 지정 인증서
는 Node.js 런타임에서 실행되는 언어 서버를 AWS Toolkit for Visual Studio 활용합니다. 네트워크에서 사용자 지정 인증서를 사용하는지 확인하는 방법에 대한 자세한 내용은 *AWS Command Line Interface* 버전 1 사용 설명서에서[AWS CLI의 구성 및 자격 증명 파일 설정](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-ca_bundle) 주제를 참조하세요.
프록시 설정을 구성하고 인증서를 정의하려면 `HTTPS_PROXY` env 변수를 구성하고 `NODE_OPTIONS` 및 `NODE_EXTRA_CA_CERTS` 키에 대한 Windows 환경 변수를 생성해야 합니다.
`HTTPS_PROXY` env 변수를 구성하려면 다음 단계를 완료합니다.
1. Visual Studio 기본 메뉴에서 **도구**를 선택한 다음 **옵션**을 선택합니다.
1. **옵션** 메뉴에서 **AWS 툴킷**을 확장한 다음 **프록시**를 선택합니다.
1. **프록시** 메뉴에서 **호스트** 및 **포트**를 정의합니다.
**참고**
`HTTPS_PROXY`에서를 구성하는 방법에 대한 자세한 내용은 *AWS Command Line Interface* 사용 설명서의 주제에 [HTTP 프록시 사용을 AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-proxy.html) AWS CLI참조하세요.
다음 키에 대한 Windows 환경 변수를 생성합니다.
+ `NODE_OPTIONS = --use-openssl-ca`
+ `NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs`
**참고**
기업 루트 인증서 추출에 대한 자세한 내용은 *learn.microsoft.com*의 [프라이빗 키로 인증서 내보내기](https://learn.microsoft.com/en-us/windows-server/identity/ad-cs/export-certificate-private-key) 문서를 참조하세요. Windows 환경 변수 키에 대한 자세한 내용은 *nodejs.org*에서 [Node.js v23.3.0 설명서](https://nodejs.org/api/cli.html#cli_node_extra_ca_certs_file)를 참조하세요.
### 목록 및 추가 단계 허용
방화벽 설정은 AWS Toolkit 언어 서버를 방해하는 것 외에도 Amazon Q가 Amazon S3에 업로드되어 서비스 API를 호출하지 못하게 할 수 있습니다. 이러한 오류의 가능성을 최소화하려면 다음 엔드포인트에 대해 **포트 443(HTTPS)**에서 아웃바운드 인터넷 액세스를 허용하는 것이 좋습니다.
+ `https://codewhisperer.us-east-1.amazonaws.com/`
+ `https://amazonq-code-transformation-us-east-1-c6160f047e0.s3.amazonaws.com/`
+ `https://aws-toolkit-language-servers.amazonaws.com/`
+ `https://q.us-east-1.amazonaws.com`
+ `https://client-telemetry.us-east-1.amazonaws.com`
+ `https://cognito-identity.us-east-1.amazonaws.com`
+ `https://oidc.us-east-1.amazonaws.com`
엔드포인트의 자세한 목록은 이 사용 설명서의 [액세스를 허용하도록 방화벽 및 게이트웨이 업데이트](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/endpoints.html) 주제를 참조하세요. Amazon Q용 회사 프록시 구성에 대한 자세한 내용은 *Amazon Q Developer 사용 설명서*의 [Amazon Q에서 회사 프록시 구성](https://docs.aws.amazon.com//amazonq/latest/qdeveloper-ug/firewall.html#corp-proxy) 주제를 참조하세요. 방화벽 및 프록시 문제가 계속 발생하면 AWS 도구 키트 로그를 수집하고 AWS Toolkit for Visual Studio GitHub 리포지토리의 [AWS Toolkit for Visual Studio 문제](https://github.com/aws/aws-toolkit-visual-studio/issues) 섹션을 통해 AWS Toolkit for Visual Studio 팀에 문의하세요. AWS 도구 키트 로그 수집에 대한 자세한 내용은이 사용 설명서 주제의 **문제 해결 모범 사례** 섹션에 있는 정보를 참조하세요.