Extension Registry

Kiro IDE의 확장 마켓플레이스를 사내에서 검증한 전용 레지스트리로 교체하기 위한 OS별 정책 설정 가이드입니다.

개요

Kiro IDE는 기본적으로 https://open-vsx.org를 확장 마켓플레이스로 사용합니다. 보안·컴플라이언스 요구사항에 따라 외부 마켓플레이스 접근을 제한해야 하는 조직이라면, OS별 정책 메커니즘을 통해 자체 호스팅하는 프라이빗 레지스트리로 전환할 수 있습니다. 이 페이지에서는 Windows, macOS, Linux 환경별로 ExtensionGalleryServiceUrl 값을 적용하는 절차를 다룹니다.

지원 버전: 본 정책은 Kiro 0.11.133 이상에서 동작합니다. 적용 후에는 반드시 Kiro를 재시작해 변경 사항이 반영되었는지 확인하세요.

Windows

Windows에서는 .admx / .adml 템플릿을 사용해 그룹 정책으로 ExtensionGalleryServiceUrl 레지스트리 항목을 배포합니다.

  1. 테스트 PC에서 관리자 권한이 있는지 확인합니다.
  2. .admx 내용을 C:\Windows\PolicyDefinitions\Kiro.admx에 저장합니다.
  3. .adml 내용을 C:\Windows\PolicyDefinitions\en-US\Kiro.adml에 저장합니다.
  4. Windows+R로 실행 창을 열고 gpedit.msc를 입력해 그룹 정책 편집기를 실행합니다.
  5. Computer Configuration > Administrative Templates > Kiro > Extensions 경로로 이동합니다.
  6. ExtensionGalleryServiceUrl 항목을 더블 클릭한 뒤 Enabled를 선택합니다.
  7. Options에서 ExtensionGalleryServiceUrl 값을 사내 레지스트리 URL로 지정하고 OK로 저장합니다.
  8. Kiro를 재시작해 정상적으로 적용되었는지 확인합니다.
  9. 대규모 배포는 MDM 또는 Active Directory 그룹 정책 프로파일을 통해 동일한 설정을 푸시합니다.

Kiro.admx 예시

<?xml version="1.0" encoding="utf-8"?>
<policyDefinitions revision="1.1" schemaVersion="1.0">
  <policyNamespaces>
    <target prefix="Kiro" namespace="AWS.Policies.Kiro" />
  </policyNamespaces>
  <resources minRequiredRevision="1.0" />
  <supportedOn>
    <definitions>
      <definition name="Supported_0_11_133" displayName="$(string.Supported_0_11_133)" />
    </definitions>
  </supportedOn>
  <categories>
    <category displayName="$(string.Application)" name="Application" />
    <category displayName="$(string.Category_extensionsConfigurationTitle)" name="extensionsConfigurationTitle">
      <parentCategory ref="Application" />
    </category>
  </categories>
  <policies>
    <policy name="ExtensionGalleryServiceUrl" class="Both"
            displayName="$(string.ExtensionGalleryServiceUrl)"
            explainText="$(string.ExtensionGalleryServiceUrl_extensions_gallery_serviceUrl)"
            key="Software\Policies\Microsoft\Kiro"
            presentation="$(presentation.ExtensionGalleryServiceUrl)">
      <parentCategory ref="extensionsConfigurationTitle" />
      <supportedOn ref="Supported_0_11_133" />
      <elements>
        <text id="ExtensionGalleryServiceUrl" valueName="ExtensionGalleryServiceUrl" required="true" />
      </elements>
    </policy>
  </policies>
</policyDefinitions>

Kiro.adml 문자열 항목

macOS

macOS에서는 .mobileconfig 구성 프로파일을 만들어 MDM으로 배포합니다.

  1. kiro.mobileconfig 파일을 생성하고 아래 키 구조에 맞춰 내용을 작성합니다.
  2. 두 곳의 PayloadUUID와 두 번째 PayloadIdentifier의 placeholder를 새로 발급한 고유 UUID로 교체합니다.
  3. ExtensionGalleryServiceUrl 값에 사내 레지스트리 URL을 지정합니다.
  4. System Settings를 열고 General > Device Management로 이동합니다.
  5. kiro.mobileconfig 파일을 끌어다 놓아 설치합니다.
  6. Kiro를 재시작해 적용 여부를 확인합니다.
  7. 대규모 배포는 사내 MDM 솔루션을 통해 일괄 적용합니다.

kiro.mobileconfig 주요 키

Linux

Linux에서는 시스템 전역 설정 파일에 정책을 기록합니다.

  1. 아래 JSON 내용을 /etc/kiro/policy.json 경로에 저장합니다.
  2. placeholder URL을 사내 레지스트리 주소로 교체합니다.
  3. Kiro를 재시작해 적용 여부를 확인합니다.
  4. 여러 워크스테이션에는 MDM 또는 구성 관리 도구로 동일한 파일을 배포합니다.
{
  "ExtensionGalleryServiceUrl": "https://registry.example.com/extensions"
}
잘못된 URL이나 응답하지 않는 레지스트리를 지정하면 확장 검색·설치가 모두 실패할 수 있습니다. 운영 배포 전에 반드시 테스트 머신에서 정책 적용과 확장 설치 흐름을 검증하세요.

참고 문서