Progressive rollouts

설치

A progressive rollout keeps a channel’s __CAPGO_KEEP_0__ in place while delivering a separate rollout target to a controlled subset of devices. It is useful when you want real production validation without switching the whole channel at once. Progressive rollout controls in a __CAPGO_KEEP_0__ channel Configure the rollout target, percentage, cache duration, and auto-pause policy from a channel’s Information tab. How progressive rollouts work Section titled “How progressive rollouts work”

Progressive rollout controls in a Capgo channel — Stable bundle

— the normal bundle assigned to the channel.

__CAPGO_KEEP_0__ 채널에서 롤아웃 목표, 퍼센티지, 캐시 유효 기간 및 자동 중단 정책을 구성할 수 있습니다.

Progressive rollout은 __CAPGO_KEEP_0__ 채널에서 작동하는 방식 __CAPGO_KEEP_0__ 채널당 두 개의 번들 링크가 있습니다:
배포 대상 — 점진적으로 출시되는 후보 패키지.

롤아웃은 안정적인 패키지를 필요로 합니다. 대시보드에서 안정적인 패키지를 할당한 후에 대상으로 선택하세요; Public API 에서는 기존 채널이 제공할 수 있습니다 version 그리고 rolloutVersion Capgo은 POST 요청에서 동일한 기존 채널을 사용할 수 있습니다. Capgo은 각 기기에 대한 무작위 결정을 내리고, 기기 ID와 롤아웃 ID의 해시를 사용하여 캐시합니다. 이는 캐시 지속 기간 동안 계열을 고정시키는 대신 업데이트를 확인할 때마다 계열이 변경되지 않도록 합니다.

퍼센트 변화

Capgo은 기존의 결정을 보존할 수 있습니다:

퍼센트를 증가시킵니다 — 이미 선택된 기기는 선택된 상태 유지; 이전에 선택되지 않은 기기 중 랜덤한 부분만 추가됩니다.
__CAPGO_KEEP_0__ — 선택된 그룹의 랜덤한 부분이 안정 버전으로 돌아갑니다.
__CAPGO_KEEP_0__ — 새로운 기기가 선택되지 않습니다. 이미 활성화된 롤아웃 대상으로 실행 중인 기기는 활성화, 롤백, 또는 대상 변경을 통해 계속 받습니다.
__CAPGO_KEEP_0__ — 새로운 기기가 롤아웃 대상에 들어오지 않습니다. 이미 활성화된 대상으로 실행 중인 기기는 계속 받습니다.
__CAPGO_KEEP_0__ — 롤아웃 대상 해결이 중단됩니다. 업데이트 확인은 안정 버전을 사용합니다.

__CAPGO_KEEP_0__

롤아웃 실행 섹션입니다. "롤아웃 실행"이라고 표시됩니다. (이 섹션의 번역은 필요하지 않습니다.)
__CAPGO_KEEP_0__ 예시
__CAPGO_KEEP_0__ 정보 대상 ,조사
관찰 로그, 조사조사
정상화

CLI example

배포 시작 1.3.0 5%:

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

이미 선택된 장치가 있는 경우 다시 장치에 연결하지 않고 증가시킬 수 있습니다:

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

채널이 이미 안정적인 버전의 배포를 가지고 있는 경우, 업로드 명령어는 한 번의 단계로 업로드를 배포 목표로 설정할 수 있습니다:

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

자세한 내용 보기 CLI 채널 참조 그리고 CLI 번들 참조 모든 롤아웃 옵션에 대해

중단, 롤백, 또는 승격

액션	이것이 무엇을 하는가
중단	새로운 기기들이 롤아웃에 들어가지 못하게 한다. 이미 활성화된 대상 기기들은 그 상태로 유지된다.
재개	새로운 자격이 있는 기기들이 다시 들어가게 한다.
비활성화	.rollout 대상이 안정 버전으로 설정되며 rollout 상태가 초기화됩니다.
되돌리기	rollout 상태를 초기화하고 안정 버전으로 되돌리며 0%로 리셋합니다.
업그레이드	context

Page/area: Capgo marketing website. Role: Section or page heading. Seen in: page affiliate.astro. Message key `affiliate_step2_title` (Affiliate Step2 Title).

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

# Make the candidate stable for everyone
npx @capgo/cli@latest channel set production com.example.app --rollout-promote

# Discard the candidate and return to stable
npx @capgo/cli@latest channel set production com.example.app --rollout-rollback

터미널 창

클립보드에 복사

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

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

실패율 임계값 에서 구성할 수 있습니다. (5% = 5%). 임계값은 정책을 트리거하기 위해 필요합니다.500 시간 창
분 (기본값: 60). 신뢰도
및 분 0 context 1 기본값: 0.95).
선택적 최소 시도 및 실패 횟수, 작은 샘플을 피하기 위해 작동하지 않도록 막습니다.
Cooldown 분 단위 (기본값: 60), 반복적인 동작을 막습니다.
액션: pause, rollback, 또는 notify.

pause 새로운 롤아웃 노출을 중단하고, rollback 목표를 초기화하고 안정 상태로 돌아가며, notify 롤아웃 알림을 보내고 롤아웃 전달을 변경하지 않습니다.

npx @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 및 대시보드 제어

같은 기능을 다음으로 관리할 수 있습니다. 공개 채널 API 또는 대시보드:

앱을 열고 __CAPGO_KEEP_1__.
채널을 선택하세요.
__CAPGO_KEEP_2__ 정보.
__CAPGO_KEEP_3__ 진행형 배포 선택한 대상, 백분율, 캐시 기간 및 자동 중단 정책을 설정하세요.

일반 채널 라우팅과 장치 우선 순위에 대해 참조하십시오. 채널비상 사태 시 라이브 업데이트에서 롤백하는 방법 수정.