返回资讯中心
外部精选
软件工程
#开发者实时流

NuGet.org 推出分阶段发布功能,包可先私有验证再决定公开

来源标题:Staged Publishing on Nuget.org

NuGet.org 上线分阶段发布功能,所有包发布者均可使用,包完成验证后保持私有,直到授权维护者在网站上确认发布。该功能为可选,现有 dotnet nuget push 工作流不受影响,发布者可借此审核待发布内容并自主选择上线时机。

Hacker News 最新soheilpro2026/11/18 · 今天23 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

一次成功的构建只说明流水线跑完了,并不说明你打算发布。今天,我们在 NuGet.org 上推出暂存发布(staged publishing),面向所有包发布者开放,让你可以在做出明确的发布决定之前,私下准备并验证包。

在协同披露之前提前上传安全修复。为功能发布收集好各个包,而不暴露尚未完成的一组内容。让自动化准备一次大规模更新,然后在它到达依赖它的人手中之前,先在 NuGet.org 上审查。

你的流水线负责准备发布,你决定何时上线。

普通的包推送中,上传即启动公开发布流程。暂存发布增加了一个可以停下来的环节:包会经过 NuGet.org 的验证,但在获得授权的维护者通过网站提升它之前,始终保持私有。

这样你就有时间审查即将交付的内容、修复验证问题,并选择发布的时机。

暂存功能需要主动启用。现有的 dotnet nuget push 工作流继续照常工作。你可以针对某个安全敏感的包或某次协同发布采用暂存,而不必一次性改动所有发布工作流。

暂存也不同于取消列出(unlisting)。已取消列出的包仍可通过精确版本还原。而暂存的包对使用方完全不可用。

网站是你审查暂存内容并批准其发布的地方。你可以暂存单个包,也可以把相关的包组织成一个暂存组(staging group)。

在 NuGet.org 的上传页面,上传包时在 Publishing Mode 下选择暂存选项。你也可以用下面的 CLI 示例从流水线上传。

NuGet.org 会让包走完验证流水线,包括恶意软件扫描、签名检查和仓库签名。验证成功后,包就可以提升了。它不会出现在公开的包页面、搜索结果和还原操作中。

你可以在网站的包管理界面中查看暂存包及其验证状态。如果验证失败,请在发布日之前修复问题并暂存一个替代包。

暂存不提供私有还原源,即使对所有者也不提供。请先在本地或私有源上测试你的包及其依赖项,然后再把发布产物暂存到 NuGet.org。

暂存组把一次发布的各个包归集到一个暂存所有者名下,该所有者可以是用户或组织。例如,一个库、它的各个集成以及它的分析器可以为即将到来的功能发布共享一个组。

在 NuGet.org 的包管理中,创建一个组,把该次发布的暂存包添加进去,并审查每个包的验证状态。这个组给你一个发布级别的视图,而不必自己跟踪各个单独的上传。

权限跟随暂存所有者。作为某个包的共同所有者,并不自动获得代表另一个所有者暂存的内容的访问权限。

在提升之前,请检查组中包含的包 ID 和版本是否正是你打算发布的内容,以及每个包是否都已通过验证。把这组内容与你的发布计划对照,包括需要随之一起交付的任何依赖项。

准备好之后,在 NuGet.org 上为单个包选择 Promote,或为组选择 Promote group。提升需要由已获授权、且其账户已启用双因素认证的登录用户执行。你可以一次操作提升单个包或批准一个组。

对于组,仍在验证中或验证失败的包必须先处理,才能开始提升。提升开始后,在网站上查看其进度和结果。如果某个条目失败,请针对该条目跟进,而不要假定整个发布已经完成。

组提升不是原子发布。各个包独立地经过 NuGet.org 的公开分发流水线,因此它们可能在不同时间变得可还原。在协调依赖项和发布公告时,要把这个时间窗口考虑进去。

自动化擅长重复一个流程。但一次发布仍然值得有人问一句:“这真的是我们打算放进别人应用程序里的那个版本吗?”

暂存发布创建了这样一个检查点。构建可以无人值守地运行并上传其产物。然后由获得授权的维护者审查这次发布,并执行使其公开的操作。

对于一次大型的暂存更新,这一批准为发布集合提供了一个有人参与的检查点。它把最终的发布决定交给一个人,同时让准备工作可以规模化。

这里有一个重要的区别:启用双因素认证并通过已认证的网站会话进行批准,并不等同于每次提升都完成一次新的双因素挑战。我们并未声称每个包或每个组都会触发新的认证挑战。

当自动化只拥有仅暂存权限时,安全边界最为牢固。仅暂存 API key 可以上传暂存包,但不能使用普通推送路径直接发布它们。Trusted Publishing 策略也可以限制为仅暂存。

如果有人窃取了该流水线凭据,他们可以提交内容以供审查,但不能用它直接把包发布给使用方。这并不意味着上传的内容就可信。请审查产物、调查异常上传,并继续保护你的构建系统和维护者账户。

我们建议将暂存与 NuGet Trusted Publishing 配合使用。Trusted Publishing 通过与你的工作流绑定的短期凭据,减少对长期密钥的依赖。暂存则在发布之前增加了一道独立的批准边界。

只要准备和发布应当发生在不同时间,暂存就有用。

安全修复:在协同披露之前准备好包,并在发布窗口之前解决验证问题。在与受影响团队协调期间保持修复私有。在约定的时间,批准提升并监控公开可用情况。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →