📢 채널

📢 Capgo Cloud에서 앱 업데이트 배포 채널을 관리하여 기기에 업데이트가 전달되는 방식을 제어합니다.

➕ 추가

별칭: a

npx @capgo/cli@latest channel add

➕ 업데이트 배포를 관리하기 위해 Capgo Cloud에 새로운 앱 배포 채널을 생성합니다.

예시:

npx @capgo/cli@latest channel add production com.example.app --default

옵션:

파라미터	유형	설명
-d	boolean	채널을 기본값으로 설정
—self-assign	boolean	기기가 이 채널에 자체 할당되도록 허용
-a	string	계정에 연결할 API 키
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)

🗑️ 삭제

별칭: d

npx @capgo/cli@latest channel delete

🗑️ Capgo Cloud에서 채널을 삭제하고, 필요하면 연결된 bundle도 함께 삭제해 리소스를 확보할 수 있습니다.

예시:

npx @capgo/cli@latest channel delete production com.example.app

옵션:

파라미터	유형	설명
-a	string	계정에 연결할 API 키
—delete-bundle	boolean	채널에 연결된 bundle을 삭제합니다. App Preview 키는 자체 프리뷰 채널과 연결되어 있으면서 공유되지 않은 bundle만 원자적으로 삭제할 수 있습니다.
—success-if-not-found	boolean	채널을 찾을 수 없으면 성공
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)

주의

조직 및 앱에 종속된 앱 미리보기 API 키를 사용합니다. --delete-bundle 비공개 PR 프리뷰 채널 전용입니다. 이 명령은 제한적인 원자적 정리(atomic cleanup) 경로를 사용합니다. 즉, 해당 키가 생성한 채널과 연결된 공유되지 않은 번들에 대해서만 성공합니다. 이 키로는 기존의 기본/메인 채널, 다른 프리뷰 키의 채널, 또는 다른 키의 번들을 사용할 수 없으며, 일반적인 bundle.delete. 참조 API 키 설정 권한도 부여되지 않습니다.

📋 목록

별칭: l

npx @capgo/cli@latest channel list

📋 Capgo Cloud에 설정된 모든 앱 채널을 나열하여 배포 설정을 확인합니다.

예시:

npx @capgo/cli@latest channel list com.example.app

옵션:

파라미터	유형	설명
-a	string	계정에 연결할 API 키
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)

📦 CurrentBundle

npx @capgo/cli@latest channel currentBundle

📦 업데이트 추적을 위해 Capgo Cloud에서 특정 채널에 연결된 현재 bundle을 가져옵니다.

예시:

npx @capgo/cli@latest channel currentBundle production com.example.app

옵션:

파라미터	유형	설명
-c	string	현재 번들을 가져올 채널
-a	string	계정에 연결할 API 키
—quiet	boolean	번들 버전만 출력
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)

⚙️ 설정

별칭: s

npx @capgo/cli@latest channel set

⚙️ 번들 연결, 업데이트 전략(major, minor, metadata, patch, none) 설정, 또는 디바이스 타겟팅(iOS, Android, dev, prod, emulator, device)과 같은 채널 설정을 구성합니다. 하나의 채널은 반드시 default로 설정되어야 합니다.

예시:

npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --state default

옵션:

파라미터	유형	설명
-a	string	계정에 연결할 API 키
-b	string	설정할 파일의 Bundle 버전 번호
-s	string	채널 상태 설정 (default 또는 normal)
—latest-remote	boolean	capgo 클라우드에 업로드된 최신 번들을 가져와 채널에 설정합니다
—latest	boolean	package.json의 최신 버전 키를 가져와 채널에 설정합니다
—downgrade	boolean	네이티브 버전보다 낮은 버전으로 다운그레이드하도록 허용합니다
—no-downgrade	boolean	네이티브 버전보다 낮은 버전으로의 다운그레이드를 비활성화합니다
—ios	boolean	iOS 기기로 업데이트 전송을 허용합니다
—no-ios	boolean	iOS 기기로 업데이트 전송을 비활성화합니다
—android	boolean	Android 기기로 업데이트 전송 허용
—no-android	boolean	Android 기기로 업데이트 전송 비활성화
—self-assign	boolean	기기가 이 채널에 자체 할당되도록 허용
—no-self-assign	boolean	기기가 이 채널에 자체 할당되지 않도록 비활성화
—disable-auto-update	string	업데이트 유형별 차단: major, minor, metadata, patch 또는 none(모두 허용)
—update-package	string	zip, delta 또는 둘 다 제공: all, zip, delta, zip_from_builtin 또는 delta_from_builtin
—rollout-bundle	string	해당 채널에서 점진적으로 배포할 Bundle 버전
—rollout-percentage	string	0에서 100 사이의 배포 비율
—rollout-percentage-bps	string	0에서 10000 사이의 basis points 단위 배포 비율
—rollout-enable	boolean	설정된 rollout 활성화
—rollout-disable	boolean	설정된 rollout 비활성화
—rollout-pause	boolean	선택된 디바이스를 롤백하지 않고 rollout 노출 일시 중지
—rollout-resume	boolean	일시 중지된 롤아웃 재개
—rollout-rollback	boolean	롤아웃 상태를 초기화하고 기기를 stable 버전으로 복구
—rollout-promote	boolean	롤아웃 대상을 stable로 승격하고 롤아웃 상태 초기화
—rollout-cache-ttl-seconds	string	Cloudflare 롤아웃 결정 캐시 TTL (초 단위)
—auto-pause-enabled	boolean	롤아웃 자동 일시 중지 정책 활성화
—auto-pause-disabled	boolean	롤아웃 자동 일시 중지 정책 비활성화
—auto-pause-window-minutes	string	Rollout 자동 일시 중지를 위한 통계 창
—auto-pause-failure-rate-bps	string	Basis point 단위의 실패율 임계값
—auto-pause-confidence	string	0과 1 사이의 신뢰 수준
—auto-pause-min-attempts	string	자동 일시 중지 트리거를 위한 최소 설치 및 실패 시도 횟수
—auto-pause-min-failures	string	자동 일시 중지 트리거를 위한 최소 실패 횟수
—auto-pause-action	string	자동 일시 중지 동작: pause, rollback 또는 notify
—auto-pause-cooldown-minutes	string	자동 일시 중지 재발생 전 대기 시간
—dev	boolean	개발용 기기에 업데이트 전송 허용
—no-dev	boolean	개발용 기기에 업데이트 전송 비활성화
—prod	boolean	프로덕션 기기에 업데이트 전송 허용
—no-prod	boolean	프로덕션 기기에 업데이트 전송 비활성화
—emulator	boolean	에뮬레이터 기기에 업데이트 전송 허용
—no-emulator	boolean	에뮬레이터 기기로 업데이트 전송 비활성화
--device	boolean	실제 기기로 업데이트 전송 허용
--no-device	boolean	실제 기기로 업데이트 전송 비활성화
--qr-preview	boolean	채널 업데이트 후 이 채널 미리보기용 터미널 QR code 출력
--send-update-notification	boolean	연결된 채널 번들 업데이트 후 기기에 네이티브 업데이트 확인 알림 전송
--package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
--ignore-metadata-check	boolean	번들에 node_modules가 있으면 호환성 검사를 무시합니다
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)