엔터프라이즈 관리 설정으로 플러그인 마켓플레이스 및 플러그인 관리

managed-settings.json 파일을 사용하여 플러그인 마켓플레이스를 사용할 수 있도록 하고 특정 플러그인을 요구하거나 차단합니다. 엔터프라이즈 관리 설정에 대한 개요는 엔터프라이즈 관리 설정 시작을 참조하세요.

관리되는 설정은 항상 리포지토리 기본값 및 멤버 환경설정보다 우선합니다.

엔터프라이즈 구성원용 마켓플레이스 추가

extraKnownMarketplaces 키를 사용하여 추가 마켓플레이스를 사용할 수 있습니다 각 항목에는 마켓플레이스 이름과 source 개체가 있습니다. 다음은 그 예입니다.

{
  "extraKnownMarketplaces": {
    "engineering-tools": {
      "source": {
        "source": "github",
        "repo": "ORG/REPOSITORY"
      }
    }
  }
}

{
  "extraKnownMarketplaces": {
    "engineering-tools": {
      "source": {
        "source": "github",
        "repo": "ORG/REPOSITORY"
      }
    }
  }
}

ORG/REPOSITORY를 마켓플레이스를 포함하는 리포지토리로 바꿉니다. 이 설정의 마켓플레이스 이름은 해당 marketplace.json 파일의 name와 일치해야 합니다.

구성원은 각 마켓플레이스 리포지토리에 대해 GitHub에 대한 읽기 권한이 필요합니다. 프라이빗 마켓플레이스의 경우 사용자가 속한 조직에서 호스팅하세요.

필요에 따라 추가 속성을 구성합니다.

• 클라이언트가 마켓플레이스를 새로 고치고 설치된 플러그 인을 업데이트할지 여부를 제어하려면 선택적 autoUpdate 속성을 구성합니다.
• 마켓플레이스 설치를 나열된 소스로 제한하려면 strictKnownMarketplaces도 사용하세요. 또한 기본 제공 마켓플레이스를 사용하지 않도록 설정합니다.

지원되는 원본 동작, 구성 세부 정보 및 클라이언트 지원은 엔터프라이즈 관리 설정을 참조하세요.

특정 플러그인을 요구하거나 차단

특정 플러그 인을 요구하거나 차단하는 데 사용합니다 enabledPlugins . 각 키는 형식 PLUGIN-NAME@MARKETPLACE-NAME을 사용합니다.

• 플러그 인을 사용하도록 설정해야 하도록 값을 true로 설정합니다.
• 플러그 인을 사용하지 않도록 하려면 값을 false로 설정합니다.

다음은 그 예입니다.

{
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true,
    "ANOTHER-PLUGIN@MARKETPLACE-NAME": false
  }
}

{
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true,
    "ANOTHER-PLUGIN@MARKETPLACE-NAME": false
  }
}

마켓플레이스 이름은 마켓플레이스의 marketplace.json 파일에 있는 name입니다. 플러그인 식별자에서 이를 사용하므로 안정적인 케밥 케이스 이름을 사용합니다.

team-mappings.json을 통해 엔터프라이즈 팀에 대한 추가 플러그인을 요구하거나 차단할 수 있습니다. 엔터프라이즈 팀에 대한 엔터프라이즈 관리 설정 재정의을(를) 참조하세요.

플러그인을 선택 사항으로 만들기

엔터프라이즈 관리 설정은 플러그인을 필수로 지정하거나 차단할 수 있습니다. 프로젝트별 기본값의 경우 리포지토리의 .github/copilot/settings.json 파일을 사용합니다. 참가자는 관리되는 정책에 따라 지원되는 경우 로컬에서 이러한 기본값을 재정의할 수 있습니다. GITHUB COPILOT CLI 구성 디렉터리을(를) 참조하세요.

플러그인 사용 모니터링

사용 메트릭 API는 엔터프라이즈 및 조직 보고서에서 Copilot CLI 사용자 지정 활동을 제공합니다. totals_by_plugin 배열에는 플러그인과 관련된 스킬 호출 수가 집계되며, 모든 플러그인 활동이나 이를 설치한 사용자 수를 나타내는 것은 아닙니다.

각 totals_by_* 배열에는 활동이 가장 많은 최대 5개의 항목이 포함됩니다. 고객 정의 식별자는 custom 또는 other 아래에 그룹화할 수 있습니다. 이러한 이벤트 수는 정확한 도입을 측정하지 않으며, 항목이 없다고 해서 사용량이 0이라는 의미는 아닙니다. 플러그 인 상호 작용이 스킬 합계에 이미 포함되어 있으므로 플러그 인과 스킬 수를 함께 추가하지 마십시오.

필드 정의 및 액세스 요구 사항은 Copilot CLI사용자 지정 필드를 참조하세요.