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

# 문제 해결 AWS Toolkit for Visual Studio Code
<a name="general-troubleshoot"></a>

다음 섹션에는 도구 키트의 AWS Toolkit for Visual Studio Code 및 AWS 서비스 작업에 대한 일반적인 문제 해결 정보가 포함되어 있습니다. 특히 AWS 도구 키트의 SAM 문제 해결과 관련된 문제는이 사용 설명서의 [서버리스 애플리케이션 문제 해결을 참조하세요](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/serverless-apps-troubleshooting.html).

**Topics**
+ [문제 해결 모범 사례](#general-troubleshoot-best-practice)
+ [프로파일 …을 구성 파일에서 찾을 수 없음](#general-troubleshoot-profile-not-found)
+ [SAM json 스키마: template.yaml 파일에서 스키마를 변경할 수 없음](#general-troubleshoot-sam-json-template-yaml)

## 문제 해결 모범 사례
<a name="general-troubleshoot-best-practice"></a>

다음은 AWS Toolkit for Visual Studio Code 문제 해결 시 권장되는 모범 사례입니다. 에 기여하는 방법에 대한 자세한 내용은 AWS Toolkit for Visual Studio Code GitHub 리포지토리의 [Contributing to AWS Toolkit for Visual Studio Code](https://github.com/aws/aws-toolkit-vscode/blob/master/CONTRIBUTING.md) 주제를 AWS Toolkit for Visual Studio Code참조하세요.
+ 보고서를 보내기 전에 문제나 오류를 재생성해 봅니다.
+ 재생성 프로세스 중에 각 단계, 설정 및 오류 메시지를 자세히 기록해 둡니다.
+  AWS 도구 키트 디버그 로그를 수집합니다. AWS 도구 키트 디버그 로그를 찾는 방법에 대한 자세한 설명은이 사용 설명서 주제에 있는 * AWS 로그를 찾는 방법* 절차를 참조하세요.
+ 미해결 요청, 알려진 솔루션을 확인하거나 AWS Toolkit for Visual Studio Code GitHub 리포지토리의 문제 섹션에서 해결되지 않은 [AWS Toolkit for Visual Studio Code 문제를](https://github.com/aws/aws-toolkit-vscode/issues) 보고합니다.

**참고**  
다음 절차에서는 AWS 도구 키트 디버그 로그를 보는 방법을 설명합니다. Amazon Q Debug 로그를 확인하는 프로세스는 동일하며, VS Code 명령 팔레트에서 **Amazon Q: 로그 보기를** 선택한다는 점에만 차이가 있습니다.

**AWS Toolkit for Visual Studio Code 디버그 로그를 찾는 방법**

1. VS Code에서 **Cmd \+ Shift \+ P** 또는 **Ctrl \+ Shift \+ P** (Windows)를 눌러 명령 팔레트를 열고 검색 필드에 **AWS View Logs**를 입력합니다.

1. **AWS 로그 보기를** 선택하여 **VS Code 터미널 출력** 창에서 AWS 도구 키트 로그를 엽니다.

1. **VS Code 터미널 출력** 창에서 **기어** 아이콘 메뉴를 확장하고 **디버그**를 선택합니다.

1. **기어** 아이콘 메뉴를 다시 확장하고 **기본값으로 설정**을 선택합니다.

1. **Cmd \+ Shift \+ P** 또는 **Ctrl \+ Shift \+ P** (Windows)를 눌러 명령 팔레트를 다시 열고를 **Reload Window**를 검색한 다음 **개발자: 창 다시 로드**를 선택합니다.

1. VS Code 다시 로드 및 **VS Code 터미널 출력** 창에 업데이트된 AWS 도구 키트 디버그 로그가 표시됩니다.

## 프로파일 …을 구성 파일에서 찾을 수 없음
<a name="general-troubleshoot-profile-not-found"></a>

**문제**

**참고**  
해당 문제는 `~/.aws/config` 파일에만 적용되며, `~/.aws/credentials` 파일에는 적용되지 않습니다. AWS 구성 및 AWS 자격 증명 파일에 대한 자세한 내용은 *AWS SDK 및 도구* 참조 가이드의 [공유 구성 및 자격 증명 파일](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) 주제를 참조하세요.

자격 증명을 선택하면 AWS 도구 키트 로그에 구조가 인 메시지가 표시됩니다`Profile name could not be found in shared credentials file`.

다음은 AWS 도구 키트 로그에서이 오류의 예입니다.

```
         2023-08-08 18:20:45 [ERROR]: _aws.auth.reauthenticate: Error: Unable to authenticate connection
         -> CredentialsProviderError: Profile vscode-prod-readonly could not be found in shared credentials file.
```

**솔루션**

프로파일이 이미 `~/.aws/config`에 있는 경우, `[profile `로 시작하는지 확인합니다. 다음은 **올바르게** 구성된 사용자 프로파일의 예입니다.

```
         [profile example]
         region=us-west-2
         credential_process=...
```

다음은 **잘못** 구성된 사용자 프로파일의 예입니다.

```
         [example]
         region=us-west-2
         credential_process=...
```

## SAM json 스키마: template.yaml 파일에서 스키마를 변경할 수 없음
<a name="general-troubleshoot-sam-json-template-yaml"></a>

**문제**

SAM template.yaml에서 다른 json 스키마를 수동으로 선택할 수 없습니다.

**솔루션**

vscode-yaml 버전 1.11 이상으로 업데이트한 후 YAML 파일 상단에 **yaml-language-server** 모드라인을 추가하여 URI에서 스키마를 강제로 사용할 수 있습니다. *Redhat 개발자* GitHub 리포지토리의 [yaml 언어 서버](https://github.com/redhat-developer/yaml-language-server#using-inlined-schema) 주제에서 *인라인 스키마 사용* 섹션에 대한 추가적인 내용을 참조하세요. 다음은 **yaml-language-server** 모드라인 예시입니다.

```
         # yaml-language-server: $schema=https://raw.githubusercontent.com/aws/serverless-application-model/main/samtranslator/schema/schema.json
```