发布周期
稳定版本
Loki 版本(这包括 Promtail、Loki Canary 等)采用以下命名方案:MAJOR
.MINOR
.PATCH
。
MAJOR
(大约每年一次):这些版本包含大型新功能和可能的向后兼容性中断。MINOR
(大约每季度一次):这些版本包含通常不会破坏向后兼容性的新功能,但我们有时可能会引入*小的*破坏性更改,我们将在升级文档中详细说明这些更改。PATCH
(大约每月一到两次):这些版本包含不破坏向后兼容性的 bug 和安全修复。
注意
虽然我们的命名方案类似于 语义化版本控制 (Semantic Versioning),但目前我们并未严格遵循其具体指导方针。我们的目标是提供尽可能稳定的常规版本,并且我们非常重视向后兼容性。与任何软件一样,每当选择安装新版本的 Loki 时,务必阅读版本说明和升级指南。
新版本基于经过数周稳定性验证的每周发布。
我们强烈建议在新补丁发布时保持更新。我们会在Slack 社区的#loki
频道发布新版本的更新信息。
您可以在GitHub和Docker Hub上找到我们的所有版本。
我的合并 PR 将是哪个版本的一部分?
您的 PR 合并到main
分支后,预计将在下周的每周发布版本中可用。要查明提交包含在哪个稳定版本或每周发布版本中,请使用以下工具
weekly-k<week-number>
,其中 <week-number>
是自我们开始此过程(2020-07-06)以来的周数。这些周发布版本部署在我们 Grafana Cloud Logs 的实例集群中。我们通过将其部署到开发、预生产和生产实例中来测试这些版本的稳定性。
通常这些周发布版本被认为足够稳定以供运行,但我们不提供任何稳定性保证,并且这些版本不应在生产环境中使用,除非您愿意承担一定的风险。
您可以在 Docker Hub 上找到这些发布版本。
我合并的 PR 将包含在哪个发布版本中?
一旦您的 PR 合并到 main
分支,您可以预期它将包含在下周的 周发布版本中。要查找某个 commit 包含在哪个稳定版或周发布版本中,请使用以下工具:
tools/which-release.sh
例如,这个 PR 已合并到名为d434e80
的提交中。使用上面的工具,我们可以看到它包含在 2.8 版本和几个每周发布版本中
$ ./tools/which-release.sh d434e80
Commit was found in the following releases:
release-2.8.x
Commit was found in the following weekly builds:
k136
k137
k138
k139
k140
k141
k142