다음을 통해 공유


개발 프록시 구성

개발 프록시는 매우 구성 가능합니다. 플러그 인 사용하여 기능을 구현합니다. 표준 플러그 인 결합하고 고유한 빌드할있습니다. 플러그 인 및 사용자 지정 구성을 사용하여 개발자 프록시를 특정 요구에 맞게 조정할 수 있습니다. 개발자 프록시에는 devproxyrc.json이라는 기본 구성 파일이 포함되어 있습니다. 이 파일은 Dev Proxy의 설치 폴더에 있습니다.

사용자 지정 구성 파일을 만드는 것이 좋습니다. 사용자 지정 구성 파일을 사용하면 다양한 구성 간에 쉽게 전환할 수 있으며 프로젝트 코드와 함께 소스 제어 시스템에 포함할 수 있습니다. 프로젝트와 구성을 저장하면 팀과 더 쉽게 공유할 수 있습니다.

구성 파일 이름을 devproxyrc.json 또는 devproxyrc.jsonc경우 개발자 프록시는 시작할 때 현재 디렉터리에서 자동으로 로드합니다. 다른 이름의 경우 개발 프록시를 시작할 때 --config-file 인수에 파일 경로를 지정합니다(예: devproxy --config-file ./my-devproxy-config.json).

구성 파일 구조

다음 코드 조각은 기본 Dev Proxy 구성 파일을 보여줍니다.

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v0.24.0/rc.schema.json",
  "plugins": [
    {
      "name": "RetryAfterPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll"
    },
    {
      "name": "GenericRandomErrorPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
      "configSection": "genericRandomErrorPlugin"
    }
  ],
  "urlsToWatch": [
    "https://jsonplaceholder.typicode.com/*"
  ],
  "genericRandomErrorPlugin": {
    "errorsFile": "devproxy-errors.json"
  },
  "rate": 50,
  "logLevel": "information",
  "newVersionNotification": "stable",
  "showSkipMessages": true,
  "showTimestamps": true
}

구성 파일은 다음 세 개의 섹션으로 구성됩니다.

  • $schema 속성에 정의된 스키마입니다. 구성 파일이 유효한지 확인하려면 사용 중인 개발자 프록시 버전과 동일한 스키마 버전을 사용해야 합니다.
  • plugins 배열에 정의된 개발자 프록시에서 사용하는 플러그 인 목록입니다.
  • 일반 구성 설정.

중요하다

개발자 프록시는 구성 파일에 나열된 순서대로 플러그 인을 적용합니다. 원하는 동작을 가져오는 순서를 염두에 두어야 합니다.

일부 플러그 인은 구성 가능하며 자체 설정을 노출합니다. 각 플러그 인에는 플러그 인 정의의 configSection 속성에서 참조하는 구성 파일에 자체 구성 섹션이 있습니다. 구성 옵션에 대한 자세한 내용은 각 플러그 인에 대한 참조 설명서를 참조하세요.

configSection 속성의 값은 모든 문자열일 수 있습니다. 서로 다른 이름을 사용하여 동일한 플러그 인의 여러 인스턴스를 각각 다른 구성으로 포함할 수 있습니다. 같은 플러그 인을 여러 번 참조해야 할 수 있습니다. 예를 들어 여러 API를 다른 오류 응답 및 동작으로 모의할 때 참조해야 할 수 있습니다.

개발자 프록시 도구 키트

개발자 프록시 도구 키트 개발 프록시 구성을 크게 간소화하는 Visual Studio Code 확장입니다. 여기에 포함된 몇 가지 기능은 다음과 같습니다.

  • 일반적인 구성 시나리오에 대한 코드 조각
  • 확장된 코드 점검과 개발자 프록시 구성 파일을 위한 IntelliSense
  • 개발자 프록시를 편리하게 시작하고 중지하는 사용자 지정 편집기 작업 및 명령
  • 새 버전의 개발자 프록시에 대한 알림

Visual Studio Code를 사용하는 경우 개발자 프록시 도구 키트 확장을 설치할 것이 좋습니다.

다음 단계

개발자 프록시 사용에 대해 계속 알아보려면 다음 자습서를 고려하세요.

그렇지 않으면, 특정 시나리오에서 Dev Proxy를 사용하는 방법에 대해 알아보려면 하우투 가이드를 확인해보세요.