Skip to main content

金丝雀发布

Docusaurus 有一个金丝雀发布系统。

它允许你在拉取请求合并到 Docusaurus 的下一个版本后，立即测试新的未发布功能。

这是一个向维护者提供反馈的好方法，确保新实现的功能按预期工作。

note

在生产环境中使用金丝雀发布可能看起来有风险，但实际上并非如此。

金丝雀发布通过了所有自动化测试，并且 Docusaurus 站点本身也在生产环境中使用。

warning

下面显示的金丝雀版本可能不是最新的。请访问npm 页面以查找实际的版本名称。

Canary npm dist tag​

对于main分支上的任何代码相关提交，持续集成将在@canary npm dist 标签下发布一个金丝雀版本。通常需要最多 10 分钟。

你可以在npm上查看当前的 dist 标签：

  • latest: 稳定版本 (当前: 3.7.0)
  • canary: 金丝雀版本 (示例: 0.0.0-4922)
tip

确保使用最新的金丝雀版本并检查发布日期（有时发布过程会失败）。

note

金丝雀版本遵循命名约定0.0.0-commitNumber。

使用金丝雀版本​

获取在canary npm dist 标签下发布的最新版本 (示例: 0.0.0-4922)。

在你的package.json中为所有@docusaurus/*依赖项使用它：

-  "@docusaurus/core": "^3.7.0",
-  "@docusaurus/preset-classic": "^3.7.0",
+  "@docusaurus/core": "0.0.0-4922",
+  "@docusaurus/preset-classic": "0.0.0-4922",

然后，重新安装依赖项并启动你的站点：

npm install
npm start