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

# Nextflow バージョン保持ポリシー
<a name="nextflow-version-retention-policy"></a>

## サポートされている Nextflow エンジンバージョン
<a name="nf-retention-supported-versions"></a>

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 エンジンバージョンが使用可能な期間
<a name="nf-retention-availability-window"></a>

HealthOmics は、現在の暦年にリリースされた Nextflow バージョンと、過去 2 年以内にリリースされたバージョンをサポートしています。これらのサポートされているバージョンのみが、機能リリースと下位互換性の改善を受けます。実際には:
+ 2026 年: サポートされている年ファミリーは 26.x、25.x、24.x です。
+ 2027 年: 27.04 がリリースされると、サポートされている年ファミリーは 27.x、26.x、25.x に移行します。

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

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

## 非推奨ライフサイクル
<a name="nf-retention-deprecation-lifecycle"></a>

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)
<a name="nf-retention-phase1"></a>

通知期間中:
+ 非推奨バージョンを使用している場合は、E メール、 AWS ヘルスダッシュボード、コンソール内のバナーを通じて、タイムラインと影響を受けるワークフローに関する通知を受け取ります。
+ バージョンは、既存のワークフローでは標準料金で機能し続けます。
+ 廃止されたバージョンで新しいワークフローを作成することはできませんが、既存のワークフローで新しい実行を標準料金で開始できます。
+ セキュリティパッチのみが適用されます。廃止されたバージョンでは、新機能やバグ修正は提供されません。
+ サポートされている新しいバージョンをテストして移行することをお勧めします。
+ 廃止されたバージョンを使用するワークフローを移行するためのリマインダーが送信されます。

### フェーズ 2: 拡張バージョンの可用性 (T–0 から T\+24 か月)
<a name="nf-retention-phase2"></a>

廃止日 (T) の後:
+ 廃止されたバージョンで開始された新しい実行には、拡張バージョンの可用性料金が発生します。この料金を回避するには、サポートされているバージョンで新しい実行を開始するか、サポートされているバージョンを使用するようにワークフローをアップグレードします。
+ 廃止されたバージョンで新しいワークフローを作成することはできません。
+ セキュリティパッチのみが適用されます。廃止されたバージョンでは、新機能やバグ修正は提供されません。
+ ワークフローが非推奨バージョンを引き続き使用する場合、拡張バージョンの可用性の料金に関する通知を受け取ります。拡張バージョンの可用性の料金は、このフェーズで新しい実行が非推奨バージョンで開始された場合にのみ適用されます。
+ サポートされているバージョンで実行を開始するには、 の「Nextflow エンジンバージョンピン留め」を参照してください[Nextflow エンジン設定の指定](starting-a-run.md#start-run-api-engine-settings)。

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


| Period | 料金 | 
| --- | --- | 
| T–0～T\+12 か月 | サポートされていないバージョンでの新規実行の 2 倍のベースレート | 
| T\+12～T\+24 か月 | サポートされていないバージョンでの新規実行の 4 倍のベースレート | 

### フェーズ 3: サポート終了 (T\+24 か月後)
<a name="nf-retention-phase3"></a>

延長バージョンの可用性期間が終了した後:
+ ワークフローがまだリタイアしたバージョンを使用している場合、バージョンリタイアの最終通知を受け取ります。
+ バージョンはサービスから完全に削除されます。新しいワークフローを作成したり、廃止されたバージョンで新しい実行を開始したりすることはできません。
+ 既存のワークフロー定義は引き続きアクセスできますが、廃止されたバージョンでは実行できません。
+ サポートされているエンジンバージョンを使用するか、 でサポートされているバージョンを固定するには、ワークフローをアップグレードする必要があります`StartRun`。実行開始時のバージョンピン留めの詳細については、「」を参照してください[Nextflow エンジン設定の指定](starting-a-run.md#start-run-api-engine-settings)。

**アクティブな実行のバージョンロック**  
ワークフロー実行は、開始したエンジンバージョンとプラグインバージョンで常に完了します。これは、パッチ更新、バージョンリタイア、プラグイン更新など、すべてのバージョン移行に適用されます。バージョンの変更は、更新後に開始された新しい実行にのみ適用され、すでに進行中の実行には適用されません。

**実行開始時の Nextflow バージョンピン留めを推奨**  
実行時に正確な Nextflow バージョンを固定し、廃止日の前に新しいバージョンでテストすることを強くお勧めします。詳細については、「[Nextflow エンジン設定の指定](starting-a-run.md#start-run-api-engine-settings)」を参照してください。

## エンジンバージョンの迅速な廃止
<a name="nf-retention-expedited-retirement"></a>

AWS は、 AWS セキュリティおよび運用標準に従ってバージョンを維持できないまれに、Nextflow エンジンバージョンの迅速な廃止を開始する権利を留保します。

このような場合:
+ 影響を受けるバージョンを使用している場合は、早期廃止が決定された時点ですぐに通知されます。
+ 圧縮されたリタイアタイムラインが適用され、運用上可能な場合は最低 90 日間の通知期間が適用されます。
+ HealthOmics は、移行ガイダンスと、可能な場合は自動アップグレードツールを提供し、お客様をサポートします。

## パッチエンジンのバージョン
<a name="nf-retention-patch-versions"></a>

パッチバージョン (v24.10.0 から v24.10.8 など) は、定期的なサービスメンテナンスの一環として HealthOmics によって透過的にアップグレードされます。パッチリリースには、セキュリティ修正、バグ修正、依存関係の更新が含まれています。重大な変更は導入されません。

パッチのアップグレードには、お客様への通知やリタイアプロセスは適用されません。選択したバージョン内で常に最新のセキュアパッチを実行します。

## DSL 仕様バージョン
<a name="nf-retention-dsl-versions"></a>

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 およびそれ以降のすべてのバージョンのデフォルト。

## アップグレード前のテスト
<a name="nf-retention-testing"></a>

新しい Nextflow バージョンにアップグレードする前に、次のことをお勧めします。
+ HealthOmics MCP サーバーを使用して、重大な変更やバージョンの互換性の確認など、新しいバージョンに対してワークフローをアップグレードおよび検証できます。MCP サーバーは、[Kiro CLI](https://docs.aws.amazon.com/kiro/latest/userguide/what-is.html)、Claude Code、またはその他の MCP 互換エージェントエンドポイントから使用できます。
+ の `engineSettings.engineVersion`パラメータを使用して`StartRun`、ワークフロー定義を変更せずに、新しいバージョンに対してワークフローをテストします。詳細については、「[Nextflow エンジン設定の指定](starting-a-run.md#start-run-api-engine-settings)」を参照してください。
+ バージョン間の重大な変更については[、Nextflow 移行ガイド](https://www.nextflow.io/docs/latest/migrations/index.html)を参照してください。
+ v25.10 以前から v26.04 に移行するワークフローの場合、Strict Parser (V2) との互換性をテストするか、明示的に `syntaxVersion`に設定します`v1`。
+ DSL 1 (v22.04) のワークフローについては、アップグレードする前に [DSL 1 からの移行](https://nextflow.io/docs/latest/dsl1.html)ガイドに従ってください。

## Nextflow プラグインのバージョン
<a name="nf-retention-plugins"></a>

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 プラグインバージョンの管理方法
<a name="nf-retention-plugin-management"></a>

HealthOmics は、エンジンバージョンごとに 1 つのプラグインバージョンを維持します。
+ **エンジンごとのプラグインごとに 1 つのバージョン** – 前の表にリストされているプリインストールされたバージョンのみを使用できます。
+ **プリインストールされたプラグインのみがサポートされています** – HealthOmics は、エンジンバージョンごとに前の表に示すプラグインのみをサポートしています。エンジンバージョンにプリインストールされていないプラグインを参照`nextflow.config`する のプラグイン宣言はサポートされていません。
+ **自動更新** – HealthOmics がエンジンのプリインストールされたプラグインバージョンを更新すると、そのエンジンのすべてのワークフローは次回の実行時に更新されたバージョンを使用します。
+ オ**プトインまたはオプトアウトなし** – プラグインの更新は均一に適用されます。以前のプラグインバージョンにとどまるメカニズムや、プラグインの拡張バージョンの可用性オプションはありません。
+ **アクティブな実行のバージョンロック** – 特定のプラグインバージョンで開始されるワークフロー実行は、実行中にプラグインが更新された場合でも、そのバージョンで完了します。更新は、更新後に開始された新しい実行にのみ適用されます。

### プラグインバージョンが更新されるとどうなるか
<a name="nf-retention-plugin-updates"></a>

**メジャーバージョンの変更** (nf-schema 2.x から 3.x など）。
+ メジャーバージョンが適用される前に、30 日以上前に通知されます。
+ 30 日間の猶予期間中、以前のメジャーバージョンは引き続き使用されます。ワークフローは、猶予期間が終了するまで以前のバージョンを引き続き使用します。
+ 猶予期間が過ぎると、すべてのワークフローの以前のバージョンが新しいメジャーバージョンに置き換えられます。
+ 事前通知は、E メール、 AWS ヘルスダッシュボード、コンソール内のバナーを通じて通知されます。

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

#### プラグインの変更のテスト
<a name="nf-retention-testing-plugins"></a>

プラグインのメジャーバージョンの変更が発表された場合 (30 日間の猶予期間）、以下をお勧めします。
+ プラグインリリースノートで、重大な変更と移行ガイダンスを確認してください。
+ 猶予期間が終了する前に、新しいプラグインバージョンに対してワークフローをテストします。
+ nf-schema の主な変更点については、パイプラインのパラメータ検証定義が新しいバージョンのスキーマ形式と互換性があることを確認してください。