Capgo __CAPGO_KEEP_0__ Capgo
Table of Contents
- 1. __CAPGO_KEEP_0__를 이해하라
- 2. Capgo에서 자동 중단 설정을 찾으라
- 3. 안전한 최소 시도 값을 선택하라
- 4. 채널 기반 롤아웃을 사용하여 자동 중단 테스트하라
- 5. 시도 횟수, 분석 및 자동 롤백을 모니터하라
- 6. CI/CD에서 설정을 자동화하라
- FAQ
- 결론
1단계: 최소 시도 횟수 제어를 이해하라
그것은 자동 일시 정지 최소 시도 횟수 최소 시도 횟수 값은 Capgo의 일시 정지 규칙이 작동하기 전에 필요한 최소 샘플 수를 설정한다. 그것은 실패 제한이 아니라 게이트이다. 설정은 Capgo에게 충분한 업데이트 시도가 존재할 때까지 rollout을 판단하지 말라고 말한다.
시도는 장치가 패키지를 설치하려고 시도하는 것을 포함할 수 있다. 시도는 성공하거나 실패할 수 있다. 정확한 결과는 업데이트 경로, 앱 상태 및 업데이터 구성에 따라 달라진다. 따라서 값은 rollout 크기에 따라 읽어야 한다.
Capgo의 채널 참조는auto-pause-min-attempts최소 설치 및 실패 시도 횟수인 최소 시도 횟수를 나타낸다. 필드는 CLI 참조에서 문자열로 표현되므로, 명령 또는 API을 사용할 때 예상되는 형식으로 값을 유지하라. CLI 채널 API 필드를 검토하기 전에 라이브 채널을 변경하지 마라. Capgo 채널 CLI 필드 사용자별로 시도를 분리하라
결론
1단계: 최소 시도 횟수 제어를 이해하라
시도 횟수는 사용자와 다릅니다. 하나의 기기는 업데이트를 다시 시도할 수 있습니다. 한 사용자는 여러 기기에서 앱을 실행할 수 있습니다. 또한 분석 시각화도 이벤트를 그룹화하는 방식이 제품 메트릭스와 다를 수 있습니다.
수치를 선택하기 전에, 보호하려는 임계값을 작성하세요. 목표가 JavaScript 번들을 빠르게 잡는 것이라면, 작은 제어 채널에서는 작은 값을 사용할 수 있습니다. 그러나 목표가 넓은 프로덕션 릴리스를 보호하는 것이라면, 하나의 기기나 짧은 장애로 인한 결정에 방지하기 위해 충분한 시도를 필요로 합니다.
- 개인 테스트 채널에 대해 작은 임계값을 사용하세요.
- 혼합 네트워크와 기기 유형이 있는 채널에 대해 더 큰 임계값을 사용하세요.
- 단기 장애로 인한 오류로 인해 자동 중단이 발생하지 않도록 임계값을 높이세요.
- 오류로 인한 자동 중단보다 늦게 감지하는 비용이 오류로 인한 자동 중단보다 더 높다면 임계값을 낮추세요.
자동 중단은 롤아웃을 중단해야 하지만 번들 검토, 기기 테스트, 명확한 롤백 계획 대신에는 사용되지 않아야 합니다. 임계값을 하나의 제어로만 사용하세요.
중요한 점: 최소 시도 횟수는 Capgo가 자동 중단 정책을 작동시키기 전에 롤아웃 증거를 얼마나 필요로 하는지 결정합니다.
2단계: Capgo의 자동 중단 설정을 찾으세요.
자동 중단 설정을 설정하려면 Capgo 자동 일시 정지 최소 시도 값, 먼저 배포하는 채널을 찾으십시오. 자동 일시 정지는 론아웃 제어와 함께 사용되므로 앱 전역 업데이터 구성 변경은 기대하는 채널 정책 변경이 아닙니다.
Capgo 대시보드에서 시작하거나 API 경로를 사용하여 팀이 이미 사용하는 채널 명령을 사용하십시오. 채널 이름을 확인하기 전에 편집을 시작하지 마십시오. 테스트 채널과 운영 채널은 유사한 이름을 가질 수 있으며, 올바른 값이 잘못된 채널에 설정되어 있으면 릴리스 사고를 기다리는 것입니다.
채널 설정에서 자동 일시 정지 필드를 찾으십시오. 관련 필드는 최소 시도 값과 신뢰도 설정을 포함할 수 있습니다. 변경 검토 시 이 필드를 함께 유지하십시오. 최소 샘플은 Capgo이 론아웃을 판단할 때 사용할 수 있습니다. 신뢰도 값은 일시 정지가 발생하기 전에 신호의 강도가 얼마나 강해야 하는지 영향을 줄 수 있습니다.
설정 값을 감사할 수 있는 경로를 통해 설정하십시오.
대시보드를 사용하여 빠른 제어된 변경이 필요하고 팀이 대시보드 변경을 기록할 때 사용하십시오. 설정이 릴리스 스크립트에 속하는 경우 CLI를 사용하십시오. 서비스가 채널 정책을 더 넓은 배포 시스템의 일부로 관리하는 경우 API를 사용하십시오.
어떤 경로를 선택하더라도 이전 값을 캡처하십시오. 변경 기록에 채널 이름, 배포 버전, 론아웃 상태, 새로운 값을 저장하십시오. 이로써 채널이 나중에 일시 정지하는지 여부에 대한 명확한 답을 얻을 수 있습니다.
API-기반 워크플로우에서 Capgo은 채널 리소스를 공개 API를 통해 노출합니다. Capgo 채널 API 문서 __CAPGO_KEEP_0__ 채널 __CAPGO_KEEP_1__ 문서가 올바른 곳입니다. 필드 이름과 요청 형태를 확인하기 위해 로컬 스크립트에서 추측하는 대신 확인하세요.
값을 편집할 때, 필드가 숫자를 기대하므로 전체 숫자를 입력하세요. 백분율 기호를 추가하지 마세요. 소수점을 사용하지 마세요. 툴링이 JSON 형식으로 구성 정보를 저장한다면, 현재 Capgo 참조에서 보여지는 문자열 형식을 정확하게 유지하고 키 스펠링을 변형하지 마세요.
변경을 확인하세요.
변경을 저장한 후 채널을 다시 읽어보세요. 성공적인 명령이 필드가 변경되었음을 의미한다고 가정하지 마세요. 반환된 채널 데이터 또는 대시보드 값을 확인하세요.
그 다음 세 가지 질문을 던져보세요:
- 설정 값이 의도한 채널에 변경되었나요?
- 채널이 의도한 번들에 아직指向하고 있나요?
- 배포가 활성화되어 있나요? 중단되나요? 완료되나요?
값이 나타나지 않으면 그만두세요. 권한, 필드 이름, 채널 식별자와 관련된 문제를 확인하세요. 성공을 보고하는 배포 스크립트가 저장된 상태를 확인하지 않으면 신뢰할 수 없습니다.
Step 3: 안전한 최소 시도 횟수 값을 선택하세요
Capgo 자동 중단 최소 시도 횟수 값을 rollout의 크기와 위험에 따라 선택하세요. 모든 앱에 안전한 숫자가 없으며 올바른 기준은 정책이 충분한 증거를 얻으면서도 나쁜 업데이트를 빠르게 감지할 수 있도록 합니다.
작은 그룹부터 시작하세요. 개인 채널에는 알려진 앱 버전을 가진 내부 장치가 포함될 수 있습니다. 프로덕션 채널에는 오래된 장치, 약한 연결 및 사용자가 앱을 몇 일마다 한 번만 열 때가 있습니다. 이 그룹은 기본적으로 동일한 임계값을 공유하지 않아야 합니다.
간단한 결정 규칙을 사용하세요.
실패 패턴이 의미를 갖기 전에 몇 번의 시도가 필요합니까? 테스트 채널에 장치가 몇 개뿐이라면 테스트 기간 동안 임계값이 달성되지 않을 수 있습니다. 프로덕션 채널이 분당 많은 시도가 들어오면 짧은 네트워크 문제로 인해 릴리즈가 중단되는 임계값이 너무 낮아질 수 있습니다.
임계값을 낮추세요:
- 채널이 개인입니다.
- 배포가 높은 위험을 가진 기능을 변경합니다.
- 스테이징 테스트 중에 빠른 피드백이 필요합니다.
- 릴리즈 직후 실패를 검사할 수 있는 팀이 있습니다.
임계값을 높으세요:
- 장치의 다양한 혼합을 제공하는 채널입니다.
- 불안정한 네트워크를 통해 연결합니다.
- 일일 열람 빈도가 낮은 앱입니다.
- 단기 장애는 많은 잘못된 실패를 발생시킬 수 있습니다.
알고 있는 문제를 숨기지 말고, 필수 네이티브 플러그인을 통해 배포가 실패하는 경우, 배포 자체를 일시정지하고 원인에 대한 수정을 하십시오. 최소 시도 설정은 불일치하는 배포를 안전하게 만들 수 없습니다.
threshold와 롤아웃 크기를 pair하세요
예를 들어, 작은 내부 채널에 배포를 먼저 하십시오. 팀이 여러 설치 결과를 볼 수 있도록 하기 위해 threshold를 설정할 수 있습니다. 배포가 그 단계를 통과하면, 더 큰 샘플을 반영하는 threshold와 함께 더 넓은 채널로 이동하십시오.
이 방법은 첫 번째 신호를 빠르게 유지하면서, 작은 샘플에 반응하지 않도록 프로덕션 정책을 요청하지 않습니다. 또한 설정을 조정할 수 있는 명확한 장소를 제공합니다. 배포가 이미 실패한 후에 threshold를 변경하지 말고, 채널과 함께 변경하십시오.
배포 기록 옆에 값을 추적하십시오. 그 이유를 적고, 변경할 때 무엇이 변경될지, 변경을 승인할 수 있는 사람을 적으십시오. 이건 인시던트 중에 일시정지된 채널을 보는 팀원이 빠르게 컨텍스트를 얻을 수 있도록 중요합니다.
프로 팁: 제어된 채널에서 시작하여, 시도 볼륨을 기록한 후, 관찰된 롤아웃 동작에 따라 프로덕션 threshold를 조정하는 것이 좋습니다.
4단계: 채널 기반 롤아웃을 통해 자동 일시정지 테스트
자동 일시정지를 테스트하기 전에, 프로덕션에 의존하지 말고 채널에서 테스트하십시오. 채널은 테스트의 경계를 제공합니다. 알려진 그룹에 배포를 보내고 시도가 증가하는 것을 관찰한 후, 정책이 threshold를 달성했을 때 발생하는 것을 확인할 수 있습니다.
첫 번째로, 테스트 버전을 구별할 수 있는 버전을 만들고, 실시간 배포와 혼동하지 않도록 하세요. code 변경 사항을 안전하게 유지하세요. 테스트는 배포 제어를 증명해야 하며, 두 번째 앱 문제를 발생시키지 않아야 합니다.
다음으로, 테스트 디바이스를 채널에 Assign하세요. 각 디바이스가 예상되는 네이티브 앱 버전을 확인하세요. OTA code는 모든 네이티브 불일치 문제를 해결할 수 없으므로, 잘못된 바이너리를 실행하는 디바이스가 테스트를 읽기 어려운 것으로 만들 수 있습니다.
채널에 버블을 배포하세요. 가능한 한 일반적인 Capgo 배포 흐름에서 하나의 명령어를 사용하세요, 그러나 버블과 채널 ID를 릴리즈 로그에 유지하세요. 재난 시에 터미널 스크롤백 버퍼에 의존하지 마세요.
중단 경로를 테스트하세요.
자동 중단이 작동하는지 확인하려면 안전한 실패 시도를 생성할 수 있는 방법이 필요합니다. 테스트 전용 버전 또는 팀에서 승인한 제어된 실패 조건을 사용하세요. 프로덕션 버전을 손상시키지 마세요.
다음 시퀀스를 감시하세요:
- 채널이 테스트 버전을指向합니다.
- 디바이스가 업데이트 명령을 수신합니다.
- 시도 목록이 분석 뷰에 나타납니다.
- 최소 시도 횟수가 도달합니다.
- 실패 신호가 채널을 중단시킵니다. 정책 조건이 충족되는 경우.
5 번째 단계는 중요합니다. 최소 시도 횟수가 도달하면 자동 중단이 가능해집니다. 그러나 정확한 시도 횟수가 중단이 발생하는지 여부는 다른 정책 field와 관찰 결과에 따라 달라집니다.
테스트 복구도 확인하세요
정지 후 사용자가 받는 것을 확인하세요. 실패한 패키지가 선택되어 있는지, 새로운 기기가 패키지를 받지 않는지, 이전에 안전한 패키지가 롤백 가능인지 확인하세요. 정답은 업데이터와 채널 설정에 따라 달라지므로 앱 로그를 확인하세요.
다시 시작하기 전에 잘못된 빌드에서 오류가 발생한 경우 새로운 패키지를 만듭니다. 동일한 아티팩트를 다시 푸시하지 마세요. 다음 시도에서 다른 결과를 기대하지 마세요.
테스트 결과를 문서화하세요. 임계값, 기기 수, 실패 조건, 정지 시간, 복구 동작을 포함하세요. 일회성 테스트를 반복 가능한 릴리스 체크로 만듭니다.
5단계: 시도 모니터링, 분석, 자동 롤백
모니터링을 통해 Capgo 자동 정지 최소 시도 규칙이 건강한 롤아웃인지 또는 깨진 롤아웃인지 확인하세요. 시도 횟수와 실패 동작을 함께 관찰하세요. 시도 횟수만으로는 너무 일찍 정지하거나 성장하는 문제를 놓치지 마세요.
Capgo Observe를 사용하여 업데이트 활동과 롤아웃 상태를 검사하세요. Capgo Observe 문서 업데이트 정보를 확인하고 자동 정지 동작을 구성하는 영역에 대한 설명입니다. 시작 code 또는 핵심 앱 흐름이 변경된 경우 패키지 변경 시 첫 번째 부분 동안 대시보드를 열어두세요.
신호를 함께 읽어보세요
__CAPGO_KEEP_0__를 먼저 살펴보세요. 그 다음 실패 횟수와 시간 패턴을 확인하세요. 성공적인 설치가 연속되면 다른 버전의 설치가 연속되지 않는 것과는 다릅니다.
장치 및 앱 버전 정보가 있을 때는 확인하세요. 실패가 한 개의 네이티브 버전에 집중되면 OTA 배포는 최신 바이너리가 필요할 수 있습니다. 실패가 모든 버전에 나타나면 배포 자체 또는 업데이트 서비스 경로를 검사하세요.
네트워크 실패는 잡음이 될 수 있습니다. 짧은 중단은 code 결함이 없는 실패 시도를 생성할 수 있습니다. 따라서 임계값은 신뢰 정책과 인간 검토 프로세스와 함께 작동해야 합니다. 자동 중단은 노출을 중단할 수 있지만 모든 실패를 설명할 수는 없습니다.
롤백이란 무엇인지 알아야 합니다.
롤백은 영향을 받은 사용자를 알려진 좋은 릴리스로 되돌려주거나 나쁜 릴리스가 더 많은 장치에 도달하지 않도록 중단합니다. 네이티브 바이너리가 필요한 기능이 없으면修復할 수 없습니다. 또한 이미 OTA 배포가 실행된 데이터 마이그레이션을 되돌릴 수 없습니다.
생산 사용 전에 테스트 채널에서 롤백 경로를 확인하세요. 안전한 배포를 처리하는 배포를 확인하세요. 장치가 중단된 경우에 어떤 일이 일어나는지 확인하세요. 그런 다음 롤백 엔지니어에게 찾을 수 있는 회복 단계를 작성하세요.
Capgo의 롤백 문서 는 채널 계획에 사용할 수 있는 롤백 제어를 매핑하는 데 도움이 됩니다. 문서화된 동작을 참조하여 결과가 업데이터 버전과 릴리스 설정에 따라 달라질 수 있음을 기억하세요.
사고 시점에서, 패턴이 명확한 경우 먼저 중단하고 로그 및 배포 변경 사항을 검사하세요. 몇 분 동안 노출을 중단하는 것이 일반적으로 알려진 잘못된 릴리스가 퍼지지 않도록 관리하는 것보다 더 쉽습니다.
6단계: CI/CD에서 설정을 자동화하세요.
릴리스 워크플로우에 Capgo 자동 중단 최소 시도 횟수 값을 설정하세요. 설정이 각 채널마다 변경될 때마다 자동화는 수동 드리프트를 제거하고 선택한 임계값을 code 리뷰에서 표시합니다.
채널 정책과 비밀을 분리하세요. 채널 이름, 롤아웃 단계 및 최소 시도 횟수는 버전화된 구성에서 공존할 수 있습니다. API 토큰은 CI/CD 비밀 저장소에 남아야 합니다. 채널 설정이 이미 저장되어 있기 때문에 레포지토리에 토큰을 커밋하지 마십시오.
릴리스 작업은 명확한 순서로 진행되어야 합니다:
- 웹 배포를 빌드하세요.
- 자연어 호환성을 확인한 후 테스트를 실행하세요.
- 배포를 업로드하세요.
- 목표 채널을 설정하거나 확인하세요.
- 최소 시도 횟수 값을 적용하세요.
- 저장된 채널 상태를 확인하세요.
- 릴리스를 게시하거나 롤아웃을 진행하세요.
배포 시스템이 지원하는 경우 dry-run 또는 리뷰 단계를 사용하세요. 리뷰 단계에서 배포 전 프로덕션 단계가 실행되기 전에 채널 식별자, 채널, 임계값, 롤아웃 액션을 표시해야 합니다.
인증을 작업에 포함하세요.
API 또는 CLI 명령이 완료된 후 채널 상태를 다시 가져옵니다. 반환된 값이 예상된 구성과 일치하지 않으면 작업을 실패하세요. 이 방법으로 잘못된 채널 ID, 거부된 필드, 부분 업데이트와 같은 오류를 잡을 수 있습니다.
환경 변수는 CI 작업에 릴리스 설정을 전달하는 일반적인 방법입니다. 작업은 채널 이름이나 임계값을 읽을 수 있습니다. 소스 파일에 비밀을 저장하지 않고도 변수 이름을 명확하게 유지하고 배포 전에 유효성을 검사하세요.
예를 들어, 워크플로우는 다음과 같은 요구 사항을 가질 수 있습니다:
CAPGO_CHANNEL__CAPGO_KEEP_0__의 대상 채널.CAPGO_MIN_ATTEMPTS__CAPGO_KEEP_1__의 승인된 임계값.CAPGO_BUNDLE_ID__CAPGO_KEEP_2__의 업로드된 배포.
이름은 워크플로우 규칙입니다. Capgo 필드 이름이 아닙니다. CLI 또는 API 필드와 정확히 매핑하세요. 미래의 변경을 리뷰하기 쉽게 만듭니다.
더 깊은 보안 검사를 위해 CI/CD pipeline에서 OTA 업데이트 보안에 대한 Capgo의 지침을 검토하세요. 중요한 습관은 단순합니다: 토큰 접근을 제한하고 릴리스 결정 로그를 남기고 결과를 각 변경 후 검증하세요.
변경 기록을 유지하세요.
임계값을 커밋 또는 릴리스 ID와 함께 저장하세요. 변경 이유를 추가하세요. 롤아웃이 예기치 않게 중단되면 정책과 배포 시간과 배포된 배포를 비교할 수 있습니다.
Capgo은 조직당 구독으로 청구되며 14일 무료 시범 기간이 아닌 단 한번의 소매 판매로 청구되지 않습니다. 그 모델은 테스트 릴리즈 워크플로를 팀이 정기적인 배포 프로세스에 포함하기 전에 테스트하고 싶은 팀에 적합합니다. 시범 기간 동안 작업을 집중하세요: 하나의 채널을 구성하고, 하나의 일시 중단 테스트를 실행하고, 하나의 롤백 경로를 확인하세요.
One 명령어로 업데이트를 배포할 수 있습니다. 더 안전한 워크플로우는 채널을 확인하고, 채널의 채택을 추적하고, 롤백 경로를 남기는 워크플로우입니다.
FAQ
Capgo의 '자동 일시 중단 최소 시도'는 무엇을 의미합니까?
Capgo의 '자동 일시 중단 최소 시도'는 최소 설치 및 실패 시도를 설정하여 자동 일시 중단 정책이 작동할 수 있는 최소 시도를 결정합니다. 이는 실패한 설치의 백분율이 아닌 샘플 크기 게이트입니다. 낮은 값은 sooner에 반응하지만 더 적은 증거에 의존할 수 있습니다. 높은 값은 채널이 결과를 수집하는 데 더 많은 시간을 주줍니다.
Capgo의 '자동 일시 중단 최소 시도'를 어디서 설정합니까?
Capgo의 '자동 일시 중단 최소 시도'를 설정하려면 OTA 배포 채널을 편집하세요. Capgo 대시보드, CLI, 또는 API를 사용하여 채널을 편집하고, 편집한 채널을 다시 읽어 확인하세요. 채널 이름을 먼저 확인하세요. 테스트 채널을 편집할 때 프로덕션 채널이 활성화되어 있으면 프로덕션 롤아웃을 변경할 수 없습니다.
__CAPGO_KEEP_0__의 '자동 일시 중단 최소 시도'의 안전한 최소 시도 값은 무엇입니까?
안전한 값은 채널 크기, 장치 혼합, 네트워크 품질, 릴리스 위험에 따라 달라집니다. 제어된 테스트 채널에 대해 작은阈치를 사용하고, 광범위한 프로덕션 롤아웃에 대해 큰阈치를 사용하세요. 알려진 그룹에서 시도량을 관찰하고, 관찰한 행동에 따라 조정하세요.
최소 시도 횟수에 도달하면 항상 릴리즈가 중단되는가?
아니요. 최소 시도 횟수 Capgo에 도달하면 롤아웃이 자동 중단이 될 수 있지만 다른 정책 조건도 여전히 중요합니다. 실패 신호, 신뢰도 설정, 채널 상태 및 업데이터 흐름은 결과에 영향을 줄 수 있습니다. 안전한 번들을 사용하여 전체 중단 경로를 테스트하고 나서 프로덕션에서 의존하지 마세요.
자동 중단은 롤백 계획을 대체할 수 있는가?
아니요. 자동 중단은 노출을 중단하거나 제한하지만 롤백은 사용자가 알려진 좋은 번들을 향해 이동할 수 있습니다. 두 가지 제어를 테스트하고 기억하세요. OTA 롤백은 설치된 앱이 가지고 있지 않은 네이티브 기능을 추가할 수 없습니다.
결론
최소 시도 횟수를 채널별로 설정하라. 작은 테스트 롤아웃부터 시작하여 중단 및 롤백 경로를 검증한 후 CI/CD에서 APPROVED 설정을 자동화하라. 워크플로우를 테스트하려면 Capgo를 하나의 채널과 하나의 제어된 번들과 함께 사용하고 롤아웃을 확장하기 전에 테스트하라.
