如何设置 Capgo 自动暂停尝试次数

一个低的尝试阈值可能会暂停一个健康的OTA发布。一个高的阈值可能会让一个坏的包达到太多设备。Capgo 自动暂停最小尝试次数设置Capgo自动暂停最小尝试次数的步骤

步骤 1: 理解最小尝试次数的控制

它自动暂停最小尝试次数最小尝试次数值设置了 Capgo 需要暂停规则生效之前的最小样本数量。它是一道门槛，而不是失败限制。该设置告诉 Capgo 等待足够的更新尝试存在之前，不要判断发布。

尝试可以包括设备尝试安装一个包。尝试可能成功或失败。具体结果取决于更新路径、应用状态和更新器配置。因此，值应该与发布规模一起阅读。

Capgo 的频道参考描述auto-pause-min-attempts最小安装次数加失败尝试次数为自动暂停生效的最小值。该字段在 CLI 参考中以字符串形式表示，因此请确保值符合命令或 API 期望的格式。您可以通过查看 Capgo频道CLI字段更改直播频道之前

设定值可以看作是最小证据规则。值为1可能在第一次记录的尝试后立即反应。这样可以在内部测试非常小的时候有所帮助，但也可能在一个坏的网络会话中反应。一个更大的值可以让滚动更多地时间来收集有用的样本。

用户与尝试分开

尝试与独特的人不一样。一个设备可能重试更新。一个用户可能在多个设备上运行应用程序。您的分析视图也可能以与您自己的产品指标不同的方式组合事件。

在选择一个数字之前，请写下您希望阈值保护什么。如果目标是早期捕获一个破碎的JavaScript包，一个小的控制频道可以使用一个较低的值。如果目标是保护一个广泛的生产发布，您需要足够的尝试来避免基于一个设备或一个短暂停机的情况下的决策。

在私有测试频道中使用一个小阈值。
当频道有混合网络和设备类型时，使用一个更大的阈值。
如果短暂停机导致了假停机，请提高阈值。
只有当假停机的成本高于延迟检测的成本时才降低它。

自动暂停应该停止滚动。它不应该取代包装评审、设备测试或清晰的回滚计划。将阈值视为您的发布过程中的一个控制项。

关键 takeaway: 控制最小尝试次数决定了Capgo需要多少个回滚证据才能触发其自动暂停策略。

步骤 2：在Capgo中找到自动暂停设置

设置自动暂停最小尝试次数 Capgo 在频道设置中查找自动暂停字段。相关字段可能包括最小尝试次数值和置信度设置。将这些字段放在一起进行更改审查。最小样本表明__CAPGO_KEEP_0__何时可以判断回滚。置信度值可以影响信号强度必须达到什么程度才能暂停。

Start in the Capgo dashboard or use the channel command and API path your team already uses. Check the channel name before you edit anything. A test channel and a production channel may have similar names, and a correct value on the wrong channel is still a release incident waiting to happen.

Look for the auto-pause fields in the channel settings. The related fields may include the minimum attempts value and a confidence setting. Keep those fields together in your change review. A minimum sample says when Capgo may judge the rollout. A confidence value can affect how strong the signal must be before a pause happens.

移动端OTA通道自动暂停设置和最小尝试次数控制

__CAPGO_KEEP_0__

Use the dashboard when you need a quick controlled change and your team records dashboard changes. Use the CLI when the setting belongs in a release script. Use the public API when a service manages channel policy as part of a wider deployment system.

无论您选择哪条路径，都先捕获旧值。保存频道名称、捆绑版本、发布状态和新值在同一变更记录中。这给您一个清晰的答案，如果频道稍后暂停。

对于API驱动的工作流程，Capgo通过其公共API公开频道资源。 Capgo频道API文档这是检查字段名称和请求形状的正确地方，而不是从本地脚本中猜测。

当您编辑值时，请输入整数，因为字段期望。不要添加百分比符号。不要使用小数。如果您的工具存储配置为JSON，请保持关键字拼写准确并保留当前Capgo参考中显示的字符串格式。

确认更改

保存频道后，请再次读取它。不要假设成功的命令意味着意图的字段已更改。验证返回的频道数据或仪表板值。

然后问三个问题：

设置是否在预期频道上更改？
频道是否仍指向预期捆绑？
发布是否处于活动状态、暂停状态或已完成状态？

如果值未出现，请停止检查。检查权限、字段拼写和频道标识符。报告成功但未验证保存状态的部署脚本难以信任。

步骤 3：选择一个安全的最小尝试次数值

从滚动的大小和风险中选择 Capgo 自动暂停最小尝试次数值。对于每个应用程序都没有安全的数字。正确的阈值既能为策略提供足够的证据，又能及早检测到坏的更新。

从可以提供有用信息的最小组开始。私有频道可能包含已知应用程序版本的内部设备。生产频道可能包括较旧的设备、弱连接和每隔几天才打开应用程序的用户。这些组不应默认使用相同的阈值。

使用简单的决策规则

询问您需要多少次尝试才能让失败模式意味着什么。如果您的测试频道只有几台设备，一高阈值可能在测试窗口内永远不会被触发。如果您的生产频道在几分钟内接收了许多尝试，一很低阈值可能会在短暂的网络问题后暂停发布。

设置较低的值时：

频道是私有的。
包改变了一个高风险功能。
您需要在阶段测试期间快速获得反馈。
您的团队可以在发布后不久检查每个故障。

设置较高的值时：

频道服务的设备组合较广。
用户通过不稳定的网络连接。
应用程序的日常打开频率较低。
短暂停机可能会产生许多假失败。

不要使用阈值来隐藏已知问题。如果一个包在必需的原生插件上失败，自己暂停发布并修复原因。最小尝试次数设置无法使不兼容的包安全。

将阈值与发布大小配对

假设您首先将发布到一个小的内部频道。您可能会选择一个阈值，让团队在自动暂停可以采取行动之前看到几次安装结果。一次包通过该阶段后，将其移到一个更大的频道，阈值反映了更大的样本。

这种方法保持了第一个信号的快速响应，而不要求生产政策对一个小样本做出反应。它还为您提供了一个清晰的位置来调整设置。不要在发布已经失败后调整阈值。

跟踪发布记录旁边的值。写下您选择它的原因、什么会让您改变它以及谁可以批准该改变。这在团队成员在事故期间看到暂停频道时需要快速上下文时很重要。

Pro Tip： 从控制频道开始，记录尝试次数，然后根据观察到的发布行为调整生产阈值，而不是猜测。

步骤 4：使用基于频道的发布测试自动暂停

在生产环境之前，测试自动暂停功能。一个频道为测试提供了一个界限。您可以将一个包发送到一个已知的组，观察尝试次数的增加，并确认当策略达到阈值时会发生什么。

首先，创建一个可以识别而不会与生产发布混淆的测试包。保持code的改变安全。测试应该证明发布控制，而不是创建第二个应用程序问题。

接下来，将测试设备分配到频道中。检查每个设备是否具有预期的本机应用程序版本。OTA code无法修复每个本机不匹配，因此运行错误二进制的设备可能会使测试难以阅读。

发布包到频道中。尽可能使用正常Capgo部署流程中的一个命令，但在发布日志中保留包和频道 ID。不要依赖终端滚动缓冲区在事故期间。

测试暂停路径

您需要一种安全的方式来产生失败的尝试。使用测试仅包或由您的团队批准的受控故障条件。不要损坏生产包仅为了查看自动暂停是否有效。

观察以下序列:

频道指向测试包。
设备接收更新指令。
尝试出现在分析视图中。
达到最小尝试次数。
失败信号导致频道暂停，如果策略条件得到满足。

第五步很重要。达到最小尝试次数可能使自动暂停成为可能。它并不意味着每次发布都会在此确切次数暂停。其他政策字段和观察到的结果都可能影响结果。

也要测试恢复

暂停后，确认用户接收到的内容。检查失败的包是否仍然被选中，新设备是否停止接收它，是否可以回滚到之前的安全包。答案取决于您的更新器和频道设置，因此请在应用日志中验证，而不是假设。

然后在有人审查失败后，只有在使用已知良好的包时才恢复。如果失败来自于一个坏的构建，请创建一个新的包。不要简单地推送相同的 artifact 并希望下一次尝试会有所不同。

记录测试结果。包括阈值、设备数量、失败条件、暂停时间和恢复动作。这将一次性测试转化为可重复的发布检查。

步骤 5：监控尝试、分析和自动回滚

Monitoring tells you whether the Capgo auto pause minimum attempts rule is seeing a healthy rollout or a broken one. Watch the attempt count beside failure behavior. A count without context can lead you to pause too early or miss a growing issue.

监控会告诉您 Capgo 自动暂停最小尝试次数规则是否看到一个健康的发布还是一个破碎的发布。观察尝试次数和失败行为。仅凭尝试次数可能会导致过早暂停或错过一个正在增长的问题。使用 Capgo Observe 来检查更新活动和发布状态。 The describes the area used to view update information and configure auto-pause behavior. Keep the dashboard open during the first part of a release, especially when the bundle changes startup code or a core app flow.

OTA 部署分析，显示更新尝试和自动回滚监控

一起阅读信号

首先查看尝试总数。然后检查失败计数和时间模式。成功安装的连续流动与一次包变为活动后出现的失败爆发不同。

检查可用的设备和应用程序版本详细信息。如果失败集聚在一个本机版本上，OTA 包可能需要一个新二进制文件。如果失败出现在每个版本上，请检查包本身或更新服务路径。

网络故障可能会产生噪声。短暂的停机可能会产生失败尝试而没有code缺陷。因此，阈值应该与信心政策和人工审查过程一起工作。自动暂停可以停止暴露，但它不能解释每个失败。

了解回滚在您的流程中的含义

回滚会将受影响的用户推回一个已知的良好发布或停止坏发布到达更多设备。它不能修复缺乏必需能力的本机二进制文件，也不能撤销OTA包已经运行的数据迁移。

在生产环境使用之前，确认回滚路径与测试频道。验证哪个捆绑包被视为安全的。检查设备在暂停期间是否脱机。然后编写恢复步骤，以便被叫醒的工程师可以找到它们。

Capgo’s 回滚文档可以帮助您将可用的回滚控制映射到频道计划中。使用文档化的行为作为参考，因为结果可能取决于更新器版本和发布设置。

在事故发生时，首先暂停，如果失败模式清晰。然后检查日志和捆绑包变化。花费几分钟停止暴露通常比让已知的坏发布继续传播更容易管理。

步骤 6：在 CI/CD 中自动设置

将 Capgo 自动暂停最小尝试次数值放入您的发布工作流程中，当设置与每个频道一起更改时。自动化移除了手动漂移。它还使选择的阈值在 code 审核中可见。

将频道策略与机密信息分开。频道名称、发布阶段和最小尝试次数可以存储在版本化配置中。 API 令牌必须存储在 CI/CD 机密存储中。不要将令牌提交到仓库，只因为频道设置已经存在。

发布任务应该遵循清晰的顺序：

构建 Web 捆绑包。
运行测试并检查原生兼容性。
上传捆绑包。
设置或确认目标频道。
应用最小尝试次数。
验证保存的频道状态。
发布或推进发布。

如果您的部署系统支持，可以使用dry-run或review阶段。该review应该在生产步骤运行之前显示bundle标识符、频道、阈值和发布动作。

将验证作为工作的一部分。

API或CLI命令完成后，重新获取频道状态。如果返回的值与预期配置不符，则失败该工作。这可以捕获错误的频道ID、拒绝的字段和部分更新。

环境变量是将发布设置传递到CI工作的一个常见方式。工作可以读取频道名称或阈值而不将机密信息放在源文件中。请确保变量名清晰并在部署前验证它们。

例如，您的工作流程可能需要：

CAPGO_CHANNEL为目标频道设置或确认。
CAPGO_MIN_ATTEMPTS为已批准的阈值设置或确认。
CAPGO_BUNDLE_ID为已上传的包设置或确认。

这些名称是工作流程约定，而不是Capgo字段名称。将它们映射到一个地方的确切CLI或API字段。这样做使未来的更改更容易审查。

为了进行更深入的安全检查，请查看Capgo关于在CI/CD管道中安全OTA更新的指南。重要的习惯是简单的：限制令牌访问，记录发布决策，并在每次更改后验证结果。

保留更改记录

将阈值与提交或发布ID存储。添加更改原因。如果滚动暂停意外，您可以将策略与捆绑和部署时间进行比较。

Capgo以组织为单位按订阅计费，提供14天的免费试用期，而不是一次性零售购买。这种模式适合那些想在他们的正常交付过程中测试发布工作流程的团队。保持试验工作的焦点：配置一个通道，运行一个暂停测试，验证一个回滚路径。

一个命令可以发布更新。更安全的工作流程是同时检查通道、跟踪采用和留下回滚路径的工作流程。

FAQ

Capgo 自动暂停最小尝试次数意味着什么？

什么是Capgo自动暂停最小尝试次数的含义？

Where do I set auto pause minimum attempts in Capgo?

您在传递 OTA 包的频道中设置了值。使用 Capgo 面板、 CLI 或公共 API，然后读取频道以确认保存的字段。首先检查频道名称。编辑测试频道时，生产环境处于活动状态，则不会更改生产发布。

什么是安全的最小尝试次数值?

安全值取决于频道大小、设备混合、网络质量和发布风险。对于受控测试频道使用较小的阈值，对于广泛的生产发布使用较大的阈值。从已知组开始，观察尝试量并根据观察到的行为进行调整。

达到最小尝试次数值是否总是会暂停发布?

不。达到 Capgo 最小尝试次数值使发布资格暂停，但其他策略条件仍然重要。失败信号、信心设置、频道状态和更新流程都可能影响结果。测试安全包的完整暂停路径之前，请确保测试了它。

自动暂停是否可以替代回滚计划?

不。自动暂停停止或限制进一步暴露，而回滚则将用户推向已知的良好包。测试两种控制。另外，请记住，OTA 回滚不能添加已安装应用程序没有的本机能力。

结论

根据频道设置最小尝试次数，而不是习惯。首先进行小规模测试，验证暂停和回滚路径，然后在CI/CD中自动应用已批准的设置。如果您想测试工作流程，请尝试Capgo，在一个频道和一个受控包中进行测试，然后扩大测试范围。

如何设置Capgo自动暂停尝试次数

目录