시작하기

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설치 명령어를 복사하세요.

진보적인 롤아웃은 채널의 안정적인 기본값 을 유지하면서 별도의 배포 목표 특정 장치의 제어된 하위 집합으로 배포합니다. 대부분의 운영 환경에서는 안정적인 버전을 유지합니다. 배포 대상만이 후보 버전을 받을 때까지 배포 완료 또는 배포 완료.

Progressive rollout controls in a Capgo channel — 배포 **Progressive 배포 제어** __CAPGO_KEEP_0__ 채널의 **Progressive 배포** 채널의 정보 탭의 **Progressive 배포 제어 섹션에 표시됩니다. 배포 목표와 안정적인 기본값**progressive rollouts

progressive rollouts

progressive rollouts	API / CLI	progressive rollouts
progressive rollouts	progressive rollouts`version` on progressive rollouts)	progressive rollouts 업데이트 롤아웃 그룹에 속하지 않습니다.
롤아웃 대상	롤아웃 대상 (`rolloutVersion` / `rollout_version`)	롤아웃이 활성화된 동안 Capgo는 랜덤으로 롤아웃 그룹에 속한 장치만 선택합니다. 활성화 및 중단되지 않은 상태에서

업데이트 확인 시 각 단계

장치가 Capgo에서 업데이트를 요청합니다.
롤아웃이 비활성화또는 목표가 없다면, Capgo은 안정적인 기본값.
롤아웃이 활성화되어 있으며 중단되어 , 이미 코호트에 속한 기기들은 롤아웃 목표를 유지하고; 나머지 모든 기기는 안정적인 기본값.
롤아웃이 활성화되어 Live Update가 진행되고 중단되지 않은 경우, Capgo 이 이 기기의 롤아웃 그룹에 포함되어 있는지 확인합니다.
- Cloudflare Capacitor
- GitHub Capgo

Capgo makes a random decision for each eligible device, then caches it using a hash of the device ID and the rollout ID. That makes the cohort API SDK

bun

Live Update를 사용하려면 먼저 안정적인 fallback을 설정해야 합니다. 대시보드에서 안정적인 버전을 할당한 후 롤아웃 대상으로 선택하세요. Public Channels APIan existing channel can supply version and rolloutVersion context

Page/area: Capgo marketing website. Role: Short UI label or navigation item. Seen in: page trust.astro. Message key `and` (And).

Set the To start delivery: Set the Rollout target).
Choose a 퍼센티지 그리고 클릭 적용 퍼센티지.
클릭 롤아웃 활성화.

롤아웃을 활성화하지 않는 한, 목표와 퍼센티지를 구성하는 것은 받는 장치가 변경되지 않습니다.

퍼센티지 변경

콘솔에서 퍼센티지를 편집하고 클릭 적용 퍼센티지 이를 저장하기 위해 클릭합니다. Capgo 기존 결정을 보존할 수 있는 경우:

퍼센티지 증가 — 이미 선택된 기기는 선택된 상태 유지; 이전에 선택되지 않은 기기 중 랜덤한 부분만 추가됩니다.
퍼센티지 감소 — 선택된 그룹 중 랜덤한 부분이 stable fallback으로 돌아갑니다.
퍼센티지 0%로 설정 — 새로운 기기가 선택되지 않습니다. enabled rollout target를 실행 중인 기기는 disable, rollback, 또는 target를 변경할 때까지 계속 받습니다.
롤아웃 중단 — 새로운 기기가 rollout target를 받지 않습니다. 이미 enabled target를 받고 있는 기기는 그대로 유지됩니다.
롤아웃 비활성화 — rollout target를 해결하지 않습니다. update 체크는 stable fallback을 사용합니다.

배포 패키지 업로드 및 할당

채널 Live Update Cloudflare Capacitor GitHub Capgo code

SDK API CLI

npm

배포 대상 위치를 선택하세요:

콘솔 선택	사용할 때
자동 (권장)	기본. 롤아웃 대상 진행 중인 롤아웃이 구성되면 동일하며, 구성되지 않으면 안정 버전 대체 Live Update가 아닐 때. API과 일치합니다. `target: "auto"` Live Update와 CLI 업로드 없이 `--stable` 또는 `--rollout`.
롤아웃 대상	candidate를 배포하고 안정적인 기본값은 그대로 유지합니다.
안정적인 기본값을 교체합니다.	생산 안정적인 기본값을 의도적으로 교체합니다 (안전망).

힌트 자동으로 롤아웃을 사용할 때 프로그레시브가 구성되면 이 API에 적용됩니다. target: "auto" 그리고 CLI 업로드가 통과하지 못하는 경우 --stable 또는 --rollout.

HTML 텍스트 조각

기본 업로드 경로	채널 상태	안정적인 기본값	배포 대상
아니오 진행형 배포 구성	채널에 도착	업로드 설정	실시간 업데이트
진행형 배포 구성	채널에 도착	변경되지 않음	업로드 설정

CLI 및 API 경로

배포하는 방법	안정적인 기본값	배포 대상	주의사항
`bundle upload --channel <name>` (추가 플래그 없음)	롤아웃 채널에서 변경되지 않음; 설정 롤아웃이 없을 때	설정 컨텍스트: Capgo 마케팅 웹사이트의 HTML 텍스트 프래그먼트 (부모 키 `compare_capawesome_step2_text`). 페이지/영역: Capgo 마케팅 웹사이트. 역할: 긴 마케팅 또는 법적 문단. 보이는 곳: 페이지 대체/ capawesome.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지하십시오.	롤아웃 채널에서 설정됨
`bundle upload --channel <name> --rollout <percent>`	Live Update	Set; rollout ; rollout enabled	해당 백분율에서
`bundle upload --channel <name> --stable`	Replaced	Live Update	Replaced
`bundle upload` with with no `--channel`	Live Update	변경되지 않음	등록만; 링크하기 `channel set` 또는 API.
콘솔 링크 대화 → 자동 (권장)	롤아웃 채널에서 변경되지 않음	설정 롤아웃 채널에서	기본 선택.
콘솔 링크 대화 → 롤아웃 대상	변경되지 않음	설정	명시적 롤아웃 대상
콘솔 링크 대화 → 안정 버전 대체	대체	변경되지 않음	안전망.
PUT `/bundle/` 대신 `target: "auto"`	롤아웃 채널에서 변경되지 않음	설정 롤아웃 채널에서	API 기본값.
PUT `/bundle/` 와 함께 `target: "rollout"`	변경되지 않음	설정	명시적 롤아웃 대상.
PUT `/bundle/` 와 함께 `target: "stable"`	대체	변경되지 않음	탈출구.
`channel set --bundle <version>`	대체	변경되지 않음	명시적 안정성 우선.
`channel set --rollout-bundle <version>` (+ `--rollout-percentage`, `--rollout-enable`)	변경되지 않음	설정 또는 변경	설정 목표를 업로드하지 않고 구성
채널 POST `version`	대체 설정되었을 때	변경되지 않음	명시적 안정성 우선.
채널 POST `rolloutVersion`	변경되지 않음	__CAPGO_KEEP_0__ 설정 또는 변경 설정 시	프로그래밍적 목표 할당.

CLI 예시

기본 업로드 (롤아웃 구성된 채널; 안정적 변경 없음):

bunx @capgo/cli@latest bundle upload com.example.app \
  --path ./dist \
  --channel production

5%에서 업로드, 롤아웃 목표 설정 및 활성화:

bunx @capgo/cli@latest bundle upload com.example.app \
  --path ./dist \
  --channel production \
  --rollout 5

안정적 변경을 명시적으로 대체:

bunx @capgo/cli@latest bundle upload com.example.app \
  --path ./dist \
  --channel production \
  --stable

링크 없이 업로드 후 롤아웃 설정:

bunx @capgo/cli@latest bundle upload com.example.app --path ./dist -b 1.3.0

bunx @capgo/cli@latest channel set production com.example.app \
  --rollout-bundle 1.3.0 \
  --rollout-percentage 5 \
  --rollout-enable

API 명시적 목표 (auto | stable | rollout):

curl -X PUT \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "com.example.app",
    "version_id": 456,
    "channel_id": 789,
    "target": "rollout"
  }' \
  https://api.capgo.app/bundle/

이미 선택된 장치 재배치 없이 노출 증가:

bunx @capgo/cli@latest channel set production com.example.app \
  --rollout-percentage 25

사용 --rollout-percentage-bps Live Update 50 = 0.5%).

See the channel CLI reference and for every rollout option. Console UX ships in CLI.app#3313 Progressive rollout section (dashboard) capgo.app#3313.

Open an app →

→ 채널을 선택하세요 → Channels → 정보 → 진보적 배포.

이 섹션은 배포 대상 및 안정적인 기본값 두 배포 링크에 사용 배포 대상 변경 다른 후보 배포를 선택하기 위해 사용합니다. 편집 후 백분율을 클릭 적용 백분율

Control	무엇을 하는가	코호트에 이미 있는 기기	새로 합류할 수 있는 기기
롤아웃 목표를 변경한다	세트 `rolloutVersion`변경을 시작하면 새로운 롤아웃 ID와 새로운 코호트가 생성된다. 기본 채널에 업로드하거나 할당하는 것도 롤아웃 목표를 설정한다.	이전 목표를 유지할 때까지 다시 체크인하고 새로운 결정 규칙과 일치할 때까지.	새로운 목표에 대한 백분율에 따라 선택된다.
백분율을 적용한다	입력한 백분율을 저장한다.	증가할 때 보존되며, 감소할 때는 랜덤한 부분이 제외될 수 있다.	위의 백분율 규칙에 따라 추가되거나 제외된다.
활성화	설정된 대상과 백분율에 대한 배포를 활성화합니다.	다음 업데이트 확인 시 즉시 변경되지 않습니다.	다음 확인 시 선택할 수 있습니다.
배포 중지	새로운 기기들이 더 이상 들어오지 않습니다.	배포 대상에 머물러 있습니다.	다음 확인 시 안정적인 대체 배포 중지 해제
중단이 해제됩니다.	변경되지 않습니다.	배포 중지 해제	다음 확인 시 다시 선택할 수 있습니다.
.rollout 비활성화	rollout 목표를 해결하지 않으며 Capgo는 모든 사용자에게 안정적인 대체를 사용합니다.	안정적인 대체로 이동 다음 확인 시.	안정적인 대체를 받습니다.
rollout 완료 (API: `promoteToStable`; CLI: `--rollout-promote`)	rollout 목표를 새로운 안정적인 대체로 만든 후 rollout 상태를 삭제합니다. 확인된 progressive rollout 완료? — 목표는 모든 사용자에게 안정적이 되며 이전의 안정적인 대체는 대체되고 퍼센티지도 초기화됩니다.	안정된 기본값으로 되돌아가기 모든 사용자에게 적용됩니다.	완료된 패키지를 받으세요. 안정된 상태로 받으세요.
롤아웃 취소 (API: `rollback`; CLI: `--rollout-rollback`)	목표를 지우고, 롤아웃을 비활성화하고, 백분율을 0%로 초기화하고, 안정된 기본값으로 장치에 되돌립니다.	다음 체크 후 안정된 기본값으로 되돌아가기 안정된 기본값으로 되돌아가세요.	안정된 기본값을 받으세요.

한 번에 하나의 터미널 명령어만 사용하세요 (완전한 배포 그리고 롤백 배포 Live Update를 단일 API 호출에서 결합할 수 없습니다):

# Stop adding devices while you investigate
bunx @capgo/cli@latest channel set production com.example.app --rollout-pause

# Allow new devices to enter again
bunx @capgo/cli@latest channel set production com.example.app --rollout-resume

# Complete rollout — candidate becomes stable for everyone
bunx @capgo/cli@latest channel set production com.example.app --rollout-promote

# Rollback rollout — discard candidate and return to stable
bunx @capgo/cli@latest channel set production com.example.app --rollout-rollback

또는 완전한 배포 or 롤백 배포안전한 워크플로우

배포된 패키지에 대한 보호가 제공됩니다.

생산 환경에서 전체 채널을 한 번에 전환하지 않고도 유효성을 검증할 수 있도록 설계된 진행형 롤아웃입니다. 실제적인 순서:

안정적인 기본값이 건강한지 확인합니다. 대부분의 사용자에게 제공할 수 있는 버전이어야 합니다.
후보자 업로드 롤아웃 구성된 채널 (bundle upload --channel <name> 적재 롤아웃 대상 밖에 안정적인 기본값 단독) 또는 --rollout <small-percent> 사용하여 동일한 단계에서 노출을 활성화합니다.
작은 시작 — 1–5%는 첫 번째 신호로 충분합니다. 클릭 적용 퍼센트, 그런 다음 롤아웃 활성화. 실패율이 급증할 때 Capgo를 중단할 때 노출을 중지하려면 자동 중단을 켜세요.
확대하기 전에 모니터링하세요. 버전 건강을 위해 로깅 인사이트 오류 패턴을 위해 채널 관찰 역사 구성 변경에 대한 탭. 롤아웃 대상과 안정적인 대체를 비교; 건강한 계층이 보이기 전까지 퍼센티지를 높이지 마십시오.
조금씩 증가 — 퍼센티지를 편집하고 클릭 적용 퍼센티지, 그리고 단계를 높여 (예: 5% → 25% → 50% → 100%). Capgo은 퍼센티지를 증가할 때 이미 계층에 포함된 기기를 선택해 둡니다.
신뢰할 수 있을 때 완료 롤아웃 — 확인 진행적 롤아웃 완료? 이러면 후보가 모든 사용자에게 안정적인 대체가 됩니다.
문제가 있다면 롤아웃을 일시 중단하세요 — 새로운 노출을 중단하여 조사합니다. 이미 문제가 있는 빌드에 있는 기기는 조사할 때까지 그 상태로 유지됩니다. 롤백 배포 또는 배포 중단.

자동 중단 정책

Capgo은 활성화된 롤아웃을 매 5분마다 평가하고, 실패 신호가 임계값을 넘을 때 행동할 수 있습니다. 롤아웃 대상의 설치 및 실패를 채널과 시간 창에 따라 측정한 후, 윌슨 신뢰 하한을 사용하여 단순 실패율만 사용하는 것보다 더 정확한 결과를 얻습니다.

자동 중단은 기본적으로 비활성화되어 있습니다. 채널의 정보 tab 또는 channel set:

실패율 임계값 에서 설정할 수 있습니다. (5% = ). 임계값은 정책을 트리거하기 위해 필요합니다.500 시간 창
(기본값: 60분). 신뢰도
사이 between 0 및 1 (기본: 0.95).
작업을 피하기 위해 작은 샘플에 대한 행동을 피하기 위해 최소 시도 및 실패 횟수.
Cooldown 분 (기본: 60), 반복적인 동작을 방지하기 위해.
액션: pause, rollback또는 notify.

pause 새로운 롤아웃 노출을 중단하고 rollback 목표를 지우고 안정적인 기본값으로 돌아가며 notify 롤아웃 알림을 보내고 롤아웃 전달을 변경하지 않고.

bunx @capgo/cli@latest channel set production com.example.app \
  --auto-pause-enabled \
  --auto-pause-failure-rate-bps 500 \
  --auto-pause-window-minutes 60 \
  --auto-pause-confidence 0.95 \
  --auto-pause-min-attempts 100 \
  --auto-pause-min-failures 5 \
  --auto-pause-action pause \
  --auto-pause-cooldown-minutes 120

API와 대시보드 진입점

대시보드: 앱 → 채널 → channel → → 채널 → → 정보
채널 API: 채널 API: 공개 채널 __CAPGO_KEEP_0__
롤아웃 field, 프로모션, 롤백을위한 채널 API: PUT /bundle/ with target: auto, stable, 또는 rollout

일반 채널 라우팅 및 장치 우선 순위에 대한 자세한 내용은 채널Live Update를 사용하여 비정형 롤아웃 시 복구하는 방법은 여기서 확인할 수 있습니다. live update을 되돌리기.