배포·운영

적용 대상

지원 리전과 Kiro 프로필 설정은 엔터프라이즈 구독(AWS IAM Identity Center 또는 외부 IdP로 로그인, 관리자가 Kiro 프로필로 관리) 전용입니다. 개인 구독(GitHub·Google 소셜 로그인 또는 AWS Builder ID)에는 Kiro 프로필이 없습니다. Managed updates는 관리 기기에 정책(MDM, 레지스트리, 정책 파일)으로 배포하는 방식이라 구독 종류와 무관하게 동작하지만, 기기 관리 권한이 필요합니다.

목표

Kiro를 조직에 배포할 때 정할 리전, Kiro 프로필의 관리자 설정, 클라이언트 버전을 통제하는 managed updates를 파악합니다.

지원 리전

관리자에게 관련된 리전은 두 가지입니다.

리전	의미
IAM Identity Center 리전	사용자 ID를 관리하는 IAM Identity Center 인스턴스가 활성화된 리전
Kiro 프로필 리전	데이터가 저장되고 추론이 이뤄지는 리전. Identity Center 리전과 다를 수 있음

Kiro 콘솔·Kiro 프로필: 미국 동부(버지니아 북부), 유럽(프랑크푸르트), AWS GovCloud(US-East), AWS GovCloud(US-West)

IAM Identity Center: 아시아 태평양(서울)을 포함해 30곳이 넘는 리전에 있는 인스턴스(또는 연결된 IdP)의 사용자를 구독시킬 수 있습니다. 전체 목록은 Supported regions를 보세요.

즉 서울 리전 Identity Center의 사용자도 Kiro를 쓸 수 있지만, Kiro 프로필(데이터 저장·추론)은 위 네 리전 중 하나에 만듭니다. 사용자 활동 리포트·프롬프트 로그용 S3 버킷도 이 프로필 리전에 있어야 합니다(사용량 모니터링).

Kiro 프로필 설정

관리자가 Kiro 프로필에서 바꿀 수 있는 설정입니다.

설정	내용
Encryption key	기본은 AWS 관리형 키로 저장 데이터를 암호화. 일부 기능은 고객 관리형 키(CMK)로 바꿀 수 있음 (Encryption at rest)
Include suggestions with code references	공개 코드와 비슷한 제안에 출처 정보를 함께 표시
Kiro usage dashboard	콘솔 대시보드 표시
Kiro user activity report	사용자별 활동 텔레메트리 수집과 리포트
Prompt logging	IDE·CLI의 인라인 제안과 채팅 기록
Member account subscriptions	AWS Organizations 관리 계정에서 멤버 계정 구독까지 Amazon Q 콘솔(Kiro 콘솔 아님)의 Subscriptions 목록 하나에 표시. 관리 계정 관리자로 로그인했을 때만 보임
Model Context Protocol (MCP)	MCP 서버 사용 허용
Web Tools	web_search, web_fetch 사용 허용
Overages	플랜 한도를 넘어도 계속 쓰게 허용 (Enabling overages)

MCP, Web Tools 등의 세부 동작은 거버넌스에 있습니다.

Managed updates

Kiro IDE와 Kiro CLI를 자체 업데이트 서버로 돌려, 어떤 버전이 조직 기기에 배포될지 통제합니다. 두 제품은 별개 방식이므로 쓰는 제품마다 따로 설정합니다.

	Kiro IDE	Kiro CLI
정책	UpdateUrl (dev.kiro.desktop 도메인)	update.baseUrl (dev.kiro.cli 도메인)
메타데이터	플랫폼별 JSON manifest	macOS index.json, Windows latest/manifest.json
Linux	/etc/kiro/policy.json	지원하지 않음

Kiro IDE

URL 설정

OS	방법
macOS	sudo defaults write dev.kiro.desktop UpdateUrl -string "https://updates.example.com" 또는 dev.kiro.desktop 도메인 MDM 프로필
Windows	HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Kiro의 UpdateUrl (REG_SZ). 그룹 정책·MDM으로 배포 가능
Linux	/etc/kiro/policy.json에 { "UpdateUrl": "https://updates.example.com" }

• https://만 허용합니다. HTTPS가 아니거나 형식이 틀리면 로그를 남기고 기본 서버로 돌아갑니다.
• 시작할 때 읽으므로 바꾼 뒤 Kiro를 다시 시작합니다.
• Help > About에서 업데이트 URL이 적용됐는지 확인합니다. URL이나 앱 커밋 해시가 없으면 업데이트가 MissingConfiguration 상태로 비활성 표시됩니다.
• UpdateMode=none(UpdateUrl과 같은 관리 정책 경로로 설정)이면 UpdateUrl과 관계없이 업데이트 확인을 모두 끕니다.

manifest 경로: <base>/<channel>/metadata-<os>-<arch>-<channel>.json 형식이며 채널은 자체 서버에서 항상 stable입니다.

• macOS: https://updates.example.com/stable/metadata-darwin-arm64-stable.json
• Windows(사용자 설치): https://updates.example.com/stable/metadata-win32-x64-user-stable.json (Windows 접미사: 시스템 설치 -system(기본), 사용자 설치 -user, 포터블 -archive)
• Linux: https://updates.example.com/stable/metadata-linux-x64-stable.json

{
  "currentRelease": "1.2.0",
  "releases": [
    {
      "version": "1.2.0",
      "updateTo": {
        "version": "1.2.0",
        "pub_date": "2026-07-10",
        "notes": "Kiro-darwin-arm64-1.2.0",
        "name": "Kiro-darwin-arm64-1.2.0",
        "url": "https://updates.example.com/releases/stable/darwin-arm64/signed/1.2.0/kiro-ide-1.2.0-stable-darwin-arm64.zip"
      }
    }
  ]
}

Kiro는 releases의 첫 항목만 읽고, releases[0].version이 설치된 버전보다 높을 때만 업데이트를 제안합니다. updateTo.url은 HTTPS여야 하지만 manifest와 다른 호스트여도 됩니다. macOS는 서명된 .zip(자동 설치·재시작, 코드 서명 필수), Windows는 .exe 설치 파일을 바로 실행, Linux는 아카이브 URL을 브라우저로 엽니다.

단계적 배포: 새 버전이 나오면 prod.download.desktop.kiro.dev에서 설치 파일을 받아 미러에 올리고, 파일럿 그룹의 UpdateUrl만 새 버전을 알리는 manifest로 향하게 합니다. 검증 기간(보통 3~7일)을 거친 뒤 운영 manifest를 갱신합니다.

버전 고정: releases[0].version을 지금 쓰는 버전으로 두면 자동 업데이트 제안이 나오지 않습니다. 사용자가 다른 버전을 직접 설치하는 것까지 막으려면 방화벽에서 prod.download.desktop.kiro.dev를 막고 내부 서버만 허용합니다(네트워크·PrivateLink).

Kiro CLI

URL 설정

OS	방법
macOS	MDM 구성 프로필로 dev.kiro.cli 도메인에 강제(forced) 값으로 배포. 사용자 수준 값은 무시되므로 로컬 defaults write는 관리 기기에서 효과가 없음
Windows	HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Kiro\CLI의 update.baseUrl (REG_SZ)
Linux	지원하지 않음

base URL에는 경로 접두사를 넣을 수 있습니다(예: https://artifacts.example.com/mirrors/kiro-cli).

우선순위: 강제 정책이 있으면 정책 → KIRO_DESKTOP_RELEASE_URL 환경 변수 → 기본 서버 순입니다. 강제 정책이 없으면 환경 변수가 정책보다 앞섭니다.

메타데이터

• macOS는 <base>/index.json을 읽습니다. 채널에 낸 모든 버전을 누적해 담는 레지스트리이며, 최상위 supported 배열, 버전별 packages(download, sha256, size 등), rollout(epoch 초 단위 시작·끝), updateConditions(allowedAutoUpdateProductNames: ["Kiro CLI"], 대소문자 구분)를 씁니다.
• Windows는 <base>/latest/manifest.json을 읽습니다. 현재 최신 버전 하나만 담습니다.
• packages[].download는 base URL 기준 상대 경로라, 미러가 파일 배치를 직접 정합니다.

전체 예시는 Managed updates 원문을 보세요.

고정과 단계적 배포: 기본적으로 설치된 버전보다 새 버전으로만 업데이트합니다.

• macOS: 고정하려면 지금 쓰는 버전보다 높은 versions[] 항목을 올리지 않습니다. rollout.start 전에는 그 버전을 고르지 않습니다. 자동 업데이트는 rollout 시점과 updateConditions를 따릅니다. rollout.start 이후 수동 kiro-cli update는 단계적 비율을 건너뛰고, --rollout을 주면 따릅니다. 두 수동 방식 모두 updateConditions는 무시합니다.
• Windows: manifest.json의 version을 지금 버전으로 둡니다. 사용자는 --force로 재설치·다운그레이드할 수 있습니다. 단계적 배포는 그룹마다 다른 버전을 알리는 미러로 update.baseUrl을 나눠 합니다.

자동 업데이트 끄기: kiro-cli settings app.disableAutoupdates true. Windows는 환경 변수 KIRO_NO_AUTO_UPDATE를 아무 값으로나 정의해도 꺼집니다.

수동 확인: macOS는 --non-interactive, --relaunch-dashboard, --rollout을 지원하고 --check·--force는 받지 않습니다. Windows는 kiro-cli update --check로 설치 없이 새 버전이 있는지 확인합니다.

네트워크와 함께 쓰기: prod.download.cli.kiro.dev와 desktop-release.q.us-east-1.amazonaws.com을 막고 미러 호스트만 허용하면 내장 업데이트·설치가 기본 서버로 돌아가지 않습니다. 다른 경로로 설치하는 것까지 막으려면 별도의 소프트웨어 배포 통제가 필요합니다.

더 알아보기

• IAM Identity Center 인증
• 거버넌스
• Settings, Supported regions, Managed updates

---

출처: 위 kiro.dev Enterprise 문서 (2026-10-26 확인)