View a markdown version of this page

Nextflow 版本保留政策 - AWS HealthOmics
支持的Nextflow 引擎版本Nextflow 引擎版本可用多长时间弃用生命周期加速引擎版本停用补丁引擎版本DSL 规范版本升级前先测试NextfLOW 插件版本

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Nextflow 版本保留政策

支持的Nextflow 引擎版本

HealthOmics 支持 Nextflow 引擎的多个稳定版本。每个版本都支持一个或多个域特定语言 (DSL) 版本。下表显示了当前支持的版本。

版本 DSL 支持 HealthOmics 发布日期 Status
v22.04 DSL 1 和 DSL 2 2022 年 11 月 计划于 2026 年 11 月 30 日弃用
v23.10 DSL 2 2024 年 10 月 计划于 2027 年 11 月 30 日弃用
v24.10 DSL 2 2025 年 8 月 至少在 2027 年 11 月之前提供支持
v25.10 DSL 2 2026 年 4 月 至少在 2028 年 10 月之前提供支持
v26.04 DSL 2 2026 年 6 月 最新，至少在 2029 年 4 月之前提供支持

HealthOmics 不支持每月的 “边缘” 版本。 HealthOmics 支持每个版本中已发布的功能，但不支持预览功能。

版本在停止支持后仍可运行工作流程。支持的版本（当前日历年加上前两年）获得了新功能和兼容性改进。 Deprecated-but-available 版本仅接收安全补丁。

Nextflow 引擎版本可用多长时间

HealthOmics 支持当前日历年内发布的 Nextflow 版本，以及前两年内发布的版本。只有这些支持的版本才能获得功能发布和向后兼容性改进。实际上：

  • 2026 年：受支持年家庭为 26.x、25.x 和 24.x。

  • 2027年：当27.04版本发布时，受抚养年家庭将转移到27.x、26.x和25.x。

当新日历年度的第一个稳定版本正式发布时 HealthOmics，最年长的系列有资格弃用。

版本收到弃用通知（进入 T—12 至 T—0 通知期）后，维护仅限于安全补丁。新功能不会添加到过时的版本中。

弃用生命周期

当 Nextflow 版本计划于当天弃用时 HealthOmics，您将收到至少 12 个月的通知期。随后是长达 24 个月的扩展版本可用性，分为三个不同的阶段。

阶段 时间轴 版本可用性 Maintenance 定价 工作流程创建 开始跑步 你的行动
第 1 阶段：通知期 T—12 到 T—0 以标准定价为现有工作流程提供全面功能 仅限安全补丁 标准费率（无变化） 不适用于已弃用的版本 功能齐全，适用于现有工作流程 迁移以避免扩展版本的可用性定价
第 2 阶段：扩展版本可用性 T—0 到 T+24 个月 功能齐全，适用于现有工作流程，价格为扩展版 仅限安全补丁 2x（0—12 个月）、4x（第 12—24 个月） 不适用于已弃用的版本 功能齐全，适用于现有工作流程，视扩展版本可用性定价而定 在支持的版本上开始新版本或升级工作流程默认版本以退出扩展版可用性定价
第 3 阶段：生命的终结 T+24 个月后 已从服务中移除 无 N/A — 运行失败 不适用于已弃用的版本 在不支持（或已停用）的版本上运行失败 必须升级才能恢复运行或在支持的版本上开始新的运行

第 1 阶段：通知期（T—12 至 T—0）

在通知期内：

  • 如果您使用的是过时的版本，您将通过电子邮件、 AWS 健康控制面板和主机内横幅收到有关时间表和受影响工作流程的通信。

  • 该版本在标准定价下仍适用于现有工作流程。

  • 您无法在过时的版本上创建新的工作流程，但可以按标准定价在现有工作流程上开始新的运行。

  • 仅应用安全补丁。弃用版本未提供任何新功能或错误修复。

  • 我们建议您测试并迁移到支持的更新版本。

  • 您会收到迁移使用过时版本的工作流程的提醒。

第 2 阶段：扩展版本可用性（T—0 到 T+24 个月）

弃用日期 (T) 之后：

  • 任何以过时版本开始的新版本都将收取扩展版本可用性定价。您可以通过在支持的版本上开始新运行或升级工作流程以使用支持的版本来避免这种定价。

  • 您无法在过时的版本上创建新的工作流程。

  • 仅应用安全补丁。弃用版本未提供任何新功能或错误修复。

  • 如果您的工作流程继续使用过时的版本，您将收到有关扩展版本可用性定价的通知。仅当在此阶段使用过时的版本开始运行新版本时，才适用扩展版本可用性定价。

  • 要在支持的版本上开始运行，请参阅 Nextflow 引擎版本固定。指定 NextfLOW 引擎设置

下表汇总了扩展版本的可用性定价。

周期 定价
T—0 到 T+12 个月 在不支持的版本上新运行的基准费率为 2 倍
T+12 到 T+24 个月 在不支持的版本上运行新版本的基准费率为 4 倍

第 3 阶段：生命终结（T+24 个月后）

扩展版本可用期结束后：

  • 如果任何工作流程仍在使用停用版本，您将收到版本停用的最终通知。

  • 该版本已从服务中完全删除。您无法在已停用的版本上创建新工作流程或开始新的运行。

  • 现有的工作流程定义仍然可以访问，但无法在停用的版本上运行。

  • 您必须升级工作流程才能使用支持的引擎版本或将支持的版本固定在中StartRun。有关运行开始时版本固定的更多信息，请参阅指定 NextfLOW 引擎设置。

对活跃运行进行版本锁定

工作流程运行始终在其启动时使用的引擎版本和插件版本上完成。这适用于所有版本过渡，包括补丁更新、版本停用和插件更新。版本更改仅适用于更新后启动的新运行，不适用于已经在进行的运行。

建议在启动运行时固定 Nextflow 版本

我们强烈建议您在运行时固定精确的 Nextflow 版本，并在任何弃用日期之前尽早对新版本进行测试。有关更多信息，请参阅 指定 NextfLOW 引擎设置。

加速引擎版本停用

AWS 在极少数情况下，如果版本无法维护符合 AWS 安全和操作标准，则保留启动 Nextflow 引擎版本快速停用的权利。

在这种情况下：

  • 如果您使用的是受影响的版本，则在确定加急停用后会立即通知您。

  • 缩短的退休时间表适用，在运营上可行的情况下，最短通知期限为90天。

  • HealthOmics 提供迁移指导，并在可能的情况下提供自动升级工具来为您提供帮助。

补丁引擎版本

补丁版本（例如，v24.10.0 到 v24.10.8）是通过日常服务维护的一部分进行 HealthOmics透明升级的。补丁版本包含安全补丁、错误修复和依赖项更新。它们不会引入重大更改。

任何客户通知或停用流程都不适用于补丁升级。您始终在所选版本中运行最新的安全补丁。

DSL 规范版本

由于 Nextflow 将规范语言和引擎捆绑到一个应用程序中，因此 DSL 版本支持与引擎版本支持直接相关：

  • DSL 1 — 仅在 v22.04 版本中支持。当 v22.04 停用时，DSL 1 支持将结束。你必须迁移到 DSL 2。

  • DSL 2 — 旧版解析器（语法 V1）— 支持 v22.04 至 v26.04。在 v26.04 中，旧版解析器要求明确选择加入。engineSettings.syntaxVersion = v1

  • DSL 2 — 严格解析器（语法 V2）— 默认为 v26.04 和所有未来版本。

升级前先测试

在升级到较新的 Nextflow 版本之前，我们建议您：

  • 您可以使用 HealthOmics MCP 服务器针对新版本升级和验证工作流程，包括检查是否存在重大更改和版本兼容性。你可以通过 Kiro CLI 、Claude Code 或任何其他 MCP-compatible 代理端点使用 MCP 服务器。

  • 使用中的engineSettings.engineVersion参数在StartRun不更改工作流程定义的情况下针对新版本测试工作流程。有关更多信息，请参阅 指定 NextfLOW 引擎设置。

  • 查看 Nextflow 迁移指南，了解版本间的重大更改。

  • 对于从 v25.10 或更早版本迁移到 v26.04 的工作流程，请测试与严格解析器 (V2) 的兼容性或明确设置为。syntaxVersion v1

  • 对于 DSL 1 (v22.04) 上的工作流程，请在升级之前遵循从 DSL 1 https://nextflow.io/docs/latest/dsl1.html 迁移指南。

NextfLOW 插件版本

HealthOmics 为每个支持的引擎版本预安装一组精选的 Nextflow 插件。插件集特定于每个引擎版本，无法修改。

引擎版本 Pre-installed 插件
v22.04 不支持插件
v23.10 nf-schema @2 .3.0，nf 验证 @1 .1.1
v24.10 nf-schema @2 .3.0
v25.10 nf-schema @2 .6.1，nf-core-utils @0 .4.0，nf-prov @1 .7.0，nf-fgbio @1 .0.1
v26.04 nf-schema @2 .7.2，nf-core-utils @0 .4.0，nf-prov @1 .7.0，nf-fgbio @1 .0.1
注意

对于 Nextflow v24.10 及更高版本，nf-schema 取代了已弃用的 nf 验证插件。只能在 v23.10 上使用 nf 验证。

如何管理 Nextflow 插件版本

HealthOmics 每个引擎版本维护一个插件版本：

  • 每个引擎每个插件的单一版本 -只有上表中列出的预安装版本可用。

  • 仅支持预安装的插件 — 仅 HealthOmics 支持上表中列出的每个引擎版本的插件。不支持您的nextflow.config引擎版本中未预先安装的引用插件的插件声明。

  • 自动更新 -更新引擎的预安装插件版本时 HealthOmics ，该引擎上的所有工作流程在下次运行时都使用更新后的版本。

  • 没有选择加入或选择退出 ——插件更新是统一应用的。没有任何机制可以保留以前的插件版本，插件也没有扩展版本可用性选项。

  • 活跃运行的版本锁定 — 从给定插件版本开始的工作流程运行在该版本上完成，即使插件在运行期间进行了更新。更新仅适用于更新后启动的新运行。

插件版本更新时会发生什么

主要版本变更（例如，nf-schema 2.x 到 3.x）：

  • 在应用主要版本之前，应至少提前 30 天发出通知。

  • 在 30 天的宽限期内，先前的主要版本仍在使用中。您的工作流程将继续使用以前的版本，直到宽限期结束。

  • 宽限期过后，新的主要版本将取代所有工作流程的先前版本。

  • 提前通知通过电子邮件、 AWS 健康控制面板和控制台内横幅传达。

次要更新和补丁更新（例如，nf-schema 2.3.0 到 2.7.2）：自动应用，恕不另行通知。这些更新不会引入重大更改。

测试插件更改

当宣布重大插件版本变更时（30 天宽限期），我们提出以下建议：

  • 查看插件发行说明以了解重大更改和迁移指南。

  • 在宽限期结束之前，根据新的插件版本测试您的工作流程。

  • 对于 nf-schema 的重大更改，请验证您的管道的参数验证定义是否与新版本的架构格式兼容。