了解 Code Quality 的成本以及你可以采取哪些调控手段,可以让你在部署它之前为这项支出提供合理依据,并在之后使其保持可预测。 本文介绍费用来自何处、查看使用情况的位置以及如何降低成本。
Code Quality 的收费方式
Code Quality 使用量由整个组织中的三种成本类型累积而成:
- 许可证使用情况,基于已启用 Code Quality 的仓库中唯一的活跃提交者人数。
- ** 每次运行扫描消耗的 GitHub Actions 分钟数**(除非您使用自托管运行器)。
- GitHub AI Credits,由 Code Quality 的 AI 功能使用:它为发现的问题生成的修复,以及在 AI 发现 页面上的扫描(如果启用该功能)。
有关每个成本的测量方式,请参阅 GitHub Code Quality 计费。
在扩展规模之前,务必先了解 GitHub Code Quality 如何使用 AI credits:
- Code Quality 从共享的 AI credits 池中进行提取,每个 AI 产品(如 Copilot)都会从该池中进行提取。 这不是单独的 Code Quality 津贴。
- 此池在您的计费实体层级共享。 如果您的组织通过企业进行计费,则 Code Quality 从企业范围的池中进行提取,而不是从纯组织池中进行提取。
- 共享池耗尽后,接下来会发生什么取决于如何配置策略以供其他使用。 为避免意外收费,请设置带有硬性上限的预算。
- 按提交者计费的许可证费用是单独计算的,不受AI credits使用情况的影响。
在哪里查看使用情况
Code Quality 使用情况会显示在与您的其他产品相同的计费和使用情况视图中,而不是显示在单独的 Code Quality 计量项中。 你查看哪里,取决于你需要多细的细分:
- 如需查看存储库或组织级别的明细,请从“计费和许可”选项卡下载计费使用报告。这是唯一可以将 Code Quality 支出(包括 GitHub Actions 分钟)归属于特定存储库或组织的地方。 UI 中没有等效视图。 请参阅“查看按流量计费的产品和许可证的使用情况”。
- 对于 Code Quality随时间推移的 AI credits 使用情况,请使用 AI 使用情况页 ,并使用右上角的下拉列表按 产品 对其进行分组。 这会将Code Quality与你的其他 AI 产品(如Copilot)区分开来,以便你跟踪它在该池中的份额。 若要改为监视整个池,请参阅 组织和企业的基于使用情况的计费。
监控您的支出
运行一次 Code Quality 后,请观察一段时间内的实际使用情况,使成本保持可预测性。 跟踪两项内容:
- 您的 GitHub Actions 分钟数会随着运行扫描的代码库数量增加而增长。
- 你的共享 AI credits 池,Code Quality 会与您的其他 AI 产品一同消耗它。 请从整体上监控资源池以避免超额使用;如果想专门查看 **** 的占比,请按 Code Quality 对 AI 使用情况页面进行分组。
控制成本
你有几种方法可以控制支出。 影响顺序粗略:
- 有选择地启用。 在能发挥价值的地方启用 Code Quality,而不是一次性在所有存储库中启用。 请参阅“启用 GitHub Code Quality”。
- 禁用低值存储库。 在存储库上禁用 Code Quality 可释放其独有的提交者的许可证,并停止其扫描和 AI 使用。 请参阅“禁用 GitHub Code Quality”。
- 设置预算。 用于 Code Quality 的预算会在你达到限额后自动停止你的支出,因为硬性停止是强制性的(见下文)。
- 使 AI 发现 页面保持关闭。 此页面默认处于关闭状态,并处于 公开预览 阶段,因此只有在您开启后才会消耗 AI credits。 在预览期间启用该功能的存储库将继续保持启用状态。 若要为某个存储库关闭此功能,请在该存储库的 AI 发现 设置页面上禁用 代码质量。
设置预算
对于 AI credits 的 Code Quality 端,预算是你的主要控制方式,因为 Code Quality 会从共享的 AI credits 池中进行提取。
对于 Code Quality 来说,预算始终是一个硬性上限。 创建预算时,达到预算上限时停止使用 选项默认处于启用状态,且无法关闭,因此一旦预算用尽,系统就会自动停止使用。
创建预算时,请选择 “预算”类型。 以下两项适用于 Code Quality:
- 一个 AI credits 预算,它涵盖使用 AI credits的每个 SKU,包括 Code Quality。 使用此策略可限制产品之间的 AI 总支出。
- SKU 级预算仅适用于Code Quality,因此你可以控制其支出,而不影响你的其他 AI 产品。 这让您能够进行细粒度的产品级控制,例如在发布过程中控制支出,而无需动用您的 Copilot 预算。
若要开始操作,请参阅 设置预算以控制按流量计费的产品的支出。
你无法控制的内容
请注意以下两项限制,以免出现意外情况:
- 您无法预估支出,在启用Code Quality之前。 使用情况取决于您的提交者、扫描频率和调查结果,因此,请计划在打开它后观察实际情况,而不是精确预测它们。
- 无法关闭拉取请求中的 AI 功能。 Code Quality 会为每个检测到的问题生成修复方案,因此运行它本身就离不开 AI credits 的使用。 若要完全停止该用法,请在存储库上禁用 Code Quality 。
后续步骤
- 在整个组织内推广。 请参阅“大规模推出 GitHub Code Quality”。
- 评估整个组织的健康状况。 请参阅“探索组织中的 GitHub 代码质量结果”。