이 자습서에서는 개발자 프록시를 사용하여 사용자 고유의 애플리케이션에 대한 임의 오류를 시뮬레이션하는 방법을 알아봅니다.
필수 구성 요소
자습서의 이 부분에서는 컴퓨터에 개발 프록시를 설치하고 구성했다고 가정합니다. 그렇지 않은 경우 을 이제수행하세요.
이 자습서를 수행하려면 API를 호출하는 애플리케이션이 필요합니다. 또한 애플리케이션에서 호출하는 API의 URL도 알아야 합니다.
모든 유형의 애플리케이션 및 기술 스택에서 개발자 프록시를 사용할 수 있습니다. 다음은 몇 가지 인기 있는 기술로 개발 프록시를 설정하는 방법에 대한 지침입니다.
개발 프록시를 사용하려면 다음을 사용하십시오.
- Node.js 애플리케이션
- Docker에서의 애플리케이션 Node.js
- JavaScript Azure Functions
- SharePoint Framework(SPFx) 솔루션
URL 모니터링을 사용하여 개발 프록시 시작
개발 프록시를 시작하고 애플리케이션에서 호출하는 API의 URL을 모니터링합니다. 예를 들어 애플리케이션이 https://api.contoso.com/v1/customers
있는 API를 호출하는 경우 개발자 프록시를 시작하고 URL 패턴 https://api.contoso.com/*
모니터링합니다.
devproxy --urls-to-watch "https://api.contoso.com/*"
--urls-to-watch
매개 변수는 Dev Proxy에게 가로챌 요청을 알려줍니다. URL 끝에 *
와일드카드는 개발자 프록시에게 https://api.contoso.com/
시작하는 URL에 대한 모든 요청을 가로채도록 지시합니다.
평소처럼 애플리케이션 사용을 시작합니다. 개발자 프록시는 지정한 URL에 대한 모든 요청을 가로채는 것입니다. 명령 프롬프트에 개발자 프록시가 가로채는 요청에 대한 메시지가 표시됩니다.
```text
request GET https://api.contoso.com/v1/customers
api ╭ Passed through
╰ GET https://api.contoso.com/v1/customers
request GET https://api.contoso.com/v1/customers
chaos ╭ 403 Forbidden
╰ GET https://api.contoso.com/v1/customers
중요하다
명령 프롬프트에 메시지가 표시되지 않으면 개발자 프록시를 사용하도록 애플리케이션을 올바르게 구성했는지 확인합니다. 또한 개발자 프록시가 애플리케이션에서 사용하는 API URL에 대한 요청을 가로채고 있는지 확인합니다. 질문이 있는 경우 Dev Proxy 커뮤니티 디스코드에서 도움을 요청하세요.
사용자 고유의 구성 파일 만들기
기본적으로 개발자 프록시는 구성 설정에 대해 개발 프록시 설치 폴더의 devproxyrc.json
파일을 사용합니다. 파일은 JSON 자리 표시자 API에 대한 임의 오류를 시뮬레이션하도록 구성됩니다. 보다 현실적인 결과를 얻으려면 애플리케이션 및 사용하는 API와 관련된 오류가 있는 사용자 고유의 구성 파일을 만들고 개발자 프록시와 함께 사용합니다.
구성 설정을 다른 팀과 공유할 수 있도록 앱의 프로젝트 폴더에 구성 파일을 저장하려고 합니다.
- 개발자 프록시 설치 폴더에서
devproxyrc.json
및devproxy-errors.json
을 복사하십시오. - 프로젝트 폴더에 파일을 붙여넣습니다.
개발자 프록시 설치 파일 외부에 저장된 구성 파일을 사용하는 경우 pluginPath
참조가 올바른지 확인해야 합니다. 구성 파일에서 개발자 프록시 설치 폴더에 대한 경로를 하드 코딩하는 대신 경로의 시작 부분에 있는 ~appFolder
사용하여 개발자 프록시 설치 폴더에 대한 동적 참조를 다시 포함할 수 있습니다.
- 텍스트 편집기에서
devproxyrc.json
파일을 엽니다. -
GenericRandomErrorPlugin
배열에서plugins
플러그 인을 찾습니다. -
pluginPath
을(를)~appFolder/plugins/DevProxy.Plugins.dll
로 업데이트하세요. -
RetryAfterPlugin
배열에서plugins
플러그 인을 찾습니다. -
pluginPath
을(를)~appFolder/plugins/DevProxy.Plugins.dll
로 업데이트하세요. - 명령 프롬프트에서 작업 디렉터리를 프로젝트 폴더로 변경합니다.
-
devproxy --config-file devproxyrc.json
을(를) 입력하고, 을(를) 누른 후,을(를) 눌러 당신의 구성 파일을 사용하여 개발 프록시를 시작합니다. - 명령줄에서 JSON 자리 표시자 API에 요청을 보내고 출력을 봅니다.
- Ctrl + C 눌러 개발 프록시를 안전하게 중지합니다.
팁
Visual Studio Code용 개발 프록시 도구 키트 확장을 설치하여 구성 파일을 쉽게 만들고 업데이트할 수 있습니다.
다음 단계
개발자 프록시는 보다 강력한 애플리케이션을 빌드하는 데 도움이 되는 다양한 시나리오를 지원합니다. 다양한 개발 프록시 기능을 사용하고 애플리케이션을 개선하는 방법을 알아보려면 방법 가이드를 살펴보세요.
Dev Proxy