View a markdown version of this page

Nextflow バージョン保持ポリシー - AWS HealthOmics

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Nextflow バージョン保持ポリシー

サポートされている Nextflow エンジンバージョン

HealthOmics は、Nextflow エンジンの複数の安定したリリースをサポートしています。各リリースでは、1 つ以上のドメイン固有の言語 (DSL) バージョンがサポートされています。次の表は、現在サポートされているバージョンを示しています。

バージョン DSL サポート HealthOmics リリース日 ステータス
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 は各バージョンでリリースされた機能をサポートしていますが、プレビュー機能はサポートしていません。

バージョンは、サポートを停止した後もワークフローを実行できる状態を維持できます。サポートされているバージョン (現在の暦年と過去 2 年間) には、新機能と互換性の改善が加えられています。Deprecated-but-availableバージョンは、セキュリティパッチのみを受け取ります。

Nextflow エンジンバージョンが使用可能な期間

HealthOmics は、現在の暦年にリリースされた Nextflow バージョンと、過去 2 年以内にリリースされたバージョンをサポートしています。これらのサポートされているバージョンのみが、機能リリースと下位互換性の改善を受けます。実際には:

  • 2026 年: サポートされている年ファミリーは 26.x、25.x、24.x です。

  • 2027 年: 27.04 がリリースされると、サポートされている年ファミリーは 27.x、26.x、25.x に移行します。

新しい暦年の最初の安定リリースが HealthOmics で一般公開されると、最も古い年のファミリーは非推奨の対象となります。

バージョンが廃止通知を受け取った後 (T–12 から T–0 の通知期間に入る)、メンテナンスはセキュリティパッチのみに制限されます。新機能は廃止されたバージョンに追加されません。

非推奨ライフサイクル

Nextflow バージョンが HealthOmics で非推奨に予定されている場合、12 か月以上の通知期間があります。その後、3 つの異なるフェーズで、最大 24 か月間の延長バージョンの可用性が続きます。

フェーズ タイムライン バージョンの可用性 メンテナンス 料金 ワークフローの作成 実行の開始 アクション
フェーズ 1: 通知期間 T–12 から T–0 標準料金で既存のワークフローに対して完全に機能する セキュリティパッチのみ 標準レート (変更なし) 廃止されたバージョンでは使用できません 既存のワークフローで完全に機能する 移行して、拡張バージョンの可用性の料金を回避する
フェーズ 2: 拡張バージョンの可用性 T–0~T+24 か月 拡張バージョンの可用性料金で既存のワークフローに対して完全に機能する セキュリティパッチのみ 2 倍 (0~12 か月)、4 倍 (12~24 か月) 廃止されたバージョンでは使用できません 既存のワークフローでは完全に機能しますが、拡張バージョンの可用性の料金が適用されます。 サポートされているバージョンで新しい実行を開始するか、ワークフローのデフォルトバージョンをアップグレードして拡張バージョンの可用性の料金を終了する
フェーズ 3: サポート終了 T+24 か月後 サービスから削除 なし 該当なし – 実行が失敗する 廃止されたバージョンでは使用できません サポートされていない (または廃止された) バージョンで実行が失敗する サポートされているバージョンで実行を再開するか、新しい実行を開始するには、アップグレードする必要があります

フェーズ 1: 通知期間 (T–12 から T–0)

通知期間中:

  • 非推奨バージョンを使用している場合は、E メール、 AWS ヘルスダッシュボード、コンソール内のバナーを通じて、タイムラインと影響を受けるワークフローに関する通知を受け取ります。

  • バージョンは、既存のワークフローでは標準料金で機能し続けます。

  • 廃止されたバージョンで新しいワークフローを作成することはできませんが、既存のワークフローで新しい実行を標準料金で開始できます。

  • セキュリティパッチのみが適用されます。廃止されたバージョンでは、新機能やバグ修正は提供されません。

  • サポートされている新しいバージョンをテストして移行することをお勧めします。

  • 廃止されたバージョンを使用するワークフローを移行するためのリマインダーが送信されます。

フェーズ 2: 拡張バージョンの可用性 (T–0 から T+24 か月)

廃止日 (T) の後:

  • 廃止されたバージョンで開始された新しい実行には、拡張バージョンの可用性料金が発生します。この料金を回避するには、サポートされているバージョンで新しい実行を開始するか、サポートされているバージョンを使用するようにワークフローをアップグレードします。

  • 廃止されたバージョンで新しいワークフローを作成することはできません。

  • セキュリティパッチのみが適用されます。廃止されたバージョンでは、新機能やバグ修正は提供されません。

  • ワークフローが非推奨バージョンを引き続き使用する場合、拡張バージョンの可用性の料金に関する通知を受け取ります。拡張バージョンの可用性の料金は、このフェーズで新しい実行が非推奨バージョンで開始された場合にのみ適用されます。

  • サポートされているバージョンで実行を開始するには、 の「Nextflow エンジンバージョンピン留め」を参照してくださいNextflow エンジン設定の指定。

次の表は、拡張バージョンの可用性の料金をまとめたものです。

Period 料金
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 は仕様言語とエンジンを 1 つのアプリケーションにバンドルするため、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 – Strict Parser (構文 V2) – v26.04 およびそれ以降のすべてのバージョンのデフォルト。

アップグレード前のテスト

新しい Nextflow バージョンにアップグレードする前に、次のことをお勧めします。

  • HealthOmics MCP サーバーを使用して、重大な変更やバージョンの互換性の確認など、新しいバージョンに対してワークフローをアップグレードおよび検証できます。MCP サーバーは、Kiro CLI、Claude Code、またはその他の MCP 互換エージェントエンドポイントから使用できます。

  • の engineSettings.engineVersionパラメータを使用してStartRun、ワークフロー定義を変更せずに、新しいバージョンに対してワークフローをテストします。詳細については、「Nextflow エンジン設定の指定」を参照してください。

  • バージョン間の重大な変更については、Nextflow 移行ガイドを参照してください。

  • v25.10 以前から v26.04 に移行するワークフローの場合、Strict Parser (V2) との互換性をテストするか、明示的に syntaxVersionに設定しますv1。

  • DSL 1 (v22.04) のワークフローについては、アップグレードする前に DSL 1 からの移行ガイドに従ってください。

Nextflow プラグインのバージョン

HealthOmics は、サポートされているエンジンバージョンごとに厳選された Nextflow プラグインのセットをプリインストールします。プラグインセットは各エンジンバージョンに固有であり、変更できません。

エンジンバージョン プリインストールされたプラグイン
v22.04 プラグインのサポートなし
v23.10 nf-schema@2.3.0、nf-validation@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-validation プラグインを置き換えます。nf-validation は v23.10 でのみ使用できます。

Nextflow プラグインバージョンの管理方法

HealthOmics は、エンジンバージョンごとに 1 つのプラグインバージョンを維持します。

  • エンジンごとのプラグインごとに 1 つのバージョン – 前の表にリストされているプリインストールされたバージョンのみを使用できます。

  • プリインストールされたプラグインのみがサポートされています – HealthOmics は、エンジンバージョンごとに前の表に示すプラグインのみをサポートしています。エンジンバージョンにプリインストールされていないプラグインを参照nextflow.configする のプラグイン宣言はサポートされていません。

  • 自動更新 – HealthOmics がエンジンのプリインストールされたプラグインバージョンを更新すると、そのエンジンのすべてのワークフローは次回の実行時に更新されたバージョンを使用します。

  • オプトインまたはオプトアウトなし – プラグインの更新は均一に適用されます。以前のプラグインバージョンにとどまるメカニズムや、プラグインの拡張バージョンの可用性オプションはありません。

  • アクティブな実行のバージョンロック – 特定のプラグインバージョンで開始されるワークフロー実行は、実行中にプラグインが更新された場合でも、そのバージョンで完了します。更新は、更新後に開始された新しい実行にのみ適用されます。

プラグインバージョンが更新されるとどうなるか

メジャーバージョンの変更 (nf-schema 2.x から 3.x など)。

  • メジャーバージョンが適用される前に、30 日以上前に通知されます。

  • 30 日間の猶予期間中、以前のメジャーバージョンは引き続き使用されます。ワークフローは、猶予期間が終了するまで以前のバージョンを引き続き使用します。

  • 猶予期間が過ぎると、すべてのワークフローの以前のバージョンが新しいメジャーバージョンに置き換えられます。

  • 事前通知は、E メール、 AWS ヘルスダッシュボード、コンソール内のバナーを通じて通知されます。

マイナーおよびパッチ更新 (nf-schema 2.3.0 から 2.7.2 など): 事前の通知なしに自動的に適用されます。これらの更新では、重大な変更はありません。

プラグインの変更のテスト

プラグインのメジャーバージョンの変更が発表された場合 (30 日間の猶予期間)、以下をお勧めします。

  • プラグインリリースノートで、重大な変更と移行ガイダンスを確認してください。

  • 猶予期間が終了する前に、新しいプラグインバージョンに対してワークフローをテストします。

  • nf-schema の主な変更点については、パイプラインのパラメータ検証定義が新しいバージョンのスキーマ形式と互換性があることを確認してください。