View a markdown version of this page

Aufbewahrungsrichtlinie für Nextflow-Versionen - AWS HealthOmics
Unterstützte Versionen der Nextflow-EngineWie lange bleiben die Versionen der Nextflow-Engine verfügbarLebenszyklus veralteter VersionenBeschleunigte Außerbetriebnahme der Engine-VersionVersionen der Patch-EngineVersionen der DSL-SpezifikationVor dem Upgrade testenVersionen des Nextflow-Plugins

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aufbewahrungsrichtlinie für Nextflow-Versionen

Unterstützte Versionen der Nextflow-Engine

HealthOmics unterstützt mehrere stabile Versionen der Nextflow-Engine. Jede Version unterstützt eine oder mehrere domänenspezifische Sprachversionen (DSL). Die folgende Tabelle zeigt die derzeit unterstützten Versionen.

Version DSL-Unterstützung HealthOmics Datum der Veröffentlichung Status
v22.04 DSL 1 UND DSL 2 November 2022 Das Programm ist für den 30. November 2026 als veraltet geplant
v23.10 DSL 2 Oktober 2024 Das Programm wird voraussichtlich am 30. November 2027 außer Betrieb genommen
v24.10 DSL 2 August 2025 Wird mindestens bis November 2027 unterstützt
v25.10 DSL 2 April 2026 Wird mindestens bis Oktober 2028 unterstützt
v26.04 DSL 2 Juni 2026 Aktuell, wird mindestens bis April 2029 unterstützt

HealthOmics unterstützt die monatlichen „Edge“ -Veröffentlichungen nicht. HealthOmics unterstützt veröffentlichte Funktionen in jeder Version, jedoch keine Vorschaufunktionen.

Eine Version kann für die Ausführung von Workflows verfügbar bleiben, nachdem sie nicht mehr unterstützt wird. Unterstützte Versionen (das aktuelle Kalenderjahr plus die beiden Vorjahre) erhalten neue Funktionen und Kompatibilitätsverbesserungen. Deprecated-but-available Versionen erhalten nur Sicherheitspatches.

Wie lange bleiben die Versionen der Nextflow-Engine verfügbar

HealthOmics unterstützt Nextflow-Versionen, die im aktuellen Kalenderjahr veröffentlicht wurden, sowie Versionen, die in den beiden Vorjahren veröffentlicht wurden. Nur diese unterstützten Versionen erhalten Feature-Releases und Verbesserungen der Abwärtskompatibilität. In der Praxis:

  • Im Jahr 2026: Familien im Alter von 26.x, 25.x und 24.x werden unterstützt.

  • 2027: Wenn 27.04 veröffentlicht wird, werden Familien, für die ein Jahr unterstützt wird, auf 27.x, 26.x und 25.x umgestellt.

Wenn die erste stabile Version eines neuen Kalenderjahres allgemein verfügbar ist HealthOmics, ist die Familie mit dem ältesten Jahrgang als veraltet eingestuft.

Wenn eine Version eine Benachrichtigung über veraltete Versionen erhält (beginnt die Kündigungsfrist von T—12 bis T—0), beschränkt sich die Wartung ausschließlich auf Sicherheitspatches. Veralteten Versionen werden keine neuen Funktionen hinzugefügt.

Lebenszyklus veralteter Versionen

Wenn eine Nextflow-Version voraussichtlich als veraltet markiert ist HealthOmics, erhalten Sie eine Kündigungsfrist von mindestens 12 Monaten. Darauf folgt eine erweiterte Versionsverfügbarkeit von bis zu 24 Monaten in drei verschiedenen Phasen.

Phase Zeitplan Verfügbarkeit der Versionen Wartung Preisgestaltung Erstellung von Arbeitsabläufen Einen Lauf starten Deine Aktion
Phase 1: Kündigungsfrist T—12 bis T—0 Voll funktionsfähig für bestehende Workflows zum Standardpreis Nur Sicherheitspatches Standardtarif (keine Änderung) In veralteten Versionen nicht verfügbar Voll funktionsfähig für bestehende Workflows Migrieren Sie, um Preise für erweiterte Versionsverfügbarkeit zu vermeiden
Phase 2: Erweiterte Versionsverfügbarkeit T — 0 bis T+24 Monate Voll funktionsfähig für bestehende Workflows zum Preis der erweiterten Versionsverfügbarkeit Nur Sicherheitspatches 2x (Monate 0—12), 4x (Monate 12—24) In veralteten Versionen nicht verfügbar Voll funktionsfähig für bestehende Workflows, vorbehaltlich der Preise für erweiterte Versionsverfügbarkeit Starten Sie neue Läufe mit unterstützten Versionen oder aktualisieren Sie die Workflow-Standardversion, um die Preisgestaltung für erweiterte Versionsverfügbarkeit zu beenden
Phase 3: Ende des Lebens Nach T+24 Monaten Aus dem Dienst genommen Keine N/A — Läufe schlagen fehl In veralteten Versionen nicht verfügbar Die Ausführung schlägt auf nicht unterstützten (oder zurückgezogenen) Versionen fehl Sie müssen ein Upgrade durchführen, um die Ausführung fortzusetzen oder neue Läufe auf unterstützten Versionen zu starten

Phase 1: Kündigungsfrist (T—12 bis T—0)

Während der Kündigungsfrist:

  • Wenn Sie die veraltete Version verwenden, erhalten Sie per E-Mail, AWS Health Dashboard und Bannern in der Konsole Informationen über den Zeitplan und die betroffenen Workflows.

  • Die Version funktioniert weiterhin für bestehende Workflows zum Standardpreis.

  • Sie können keine neuen Workflows für veraltete Versionen erstellen, aber Sie können neue Läufe für bestehende Workflows zum Standardpreis starten.

  • Es werden nur Sicherheitspatches angewendet. Für die veraltete Version werden keine neuen Funktionen oder Bugfixes bereitgestellt.

  • Wir empfehlen, dass Sie testen und auf eine neuere unterstützte Version migrieren.

  • Sie werden daran erinnert, Workflows zu migrieren, die die veraltete Version verwenden.

Phase 2: Erweiterte Versionsverfügbarkeit (T—0 bis T+24 Monate)

Nach dem Verfallsdatum (T):

  • Für alle neuen Läufe, die mit veralteten Versionen gestartet wurden, fallen Preise für erweiterte Versionsverfügbarkeit an. Sie können diese Preisgestaltung vermeiden, indem Sie neue Läufe mit unterstützten Versionen starten oder Ihren Workflow aktualisieren, um eine unterstützte Version zu verwenden.

  • Sie können keine neuen Workflows für die veralteten Versionen erstellen.

  • Es werden nur Sicherheitspatches angewendet. Für die veraltete Version werden keine neuen Funktionen oder Bugfixes bereitgestellt.

  • Sie erhalten Benachrichtigungen über die Preise für erweiterte Versionsverfügbarkeit, wenn Ihre Workflows weiterhin veraltete Versionen verwenden. Preise für erweiterte Versionsverfügbarkeit gelten nur, wenn in dieser Phase neue Läufe mit veralteten Versionen gestartet werden.

  • Informationen zum Starten einer Ausführung auf unterstützten Versionen finden Sie unter Anheften der Nextflow-Engine-Version. Geben Sie die Nextflow-Engine-Einstellungen an

In der folgenden Tabelle sind die Preise für erweiterte Versionsverfügbarkeit zusammengefasst.

Zeitraum Preisgestaltung
T — 0 bis T+12 Monate Doppelter Basistarif für neue Läufe auf nicht unterstützten Versionen
T+12 bis T+24 Monate 4-facher Basistarif für neue Läufe auf nicht unterstützten Versionen

Phase 3: Ende der Nutzungsdauer (nach T+24 Monaten)

Nach Ablauf der Verfügbarkeitsdauer der erweiterten Version:

  • Sie erhalten eine endgültige Benachrichtigung über die Außerbetriebnahme der Version, falls ein Workflow die zurückgezogene Version noch verwendet.

  • Die Version wurde vollständig aus dem Dienst entfernt. In der veralteten Version können Sie keine neuen Workflows erstellen oder neue Läufe starten.

  • Auf bestehende Workflow-Definitionen kann weiterhin zugegriffen werden, sie können jedoch in der veralteten Version nicht ausgeführt werden.

  • Sie müssen Ihren Workflow aktualisieren, um eine unterstützte Engine-Version zu verwenden, oder eine unterstützte Version einbindenStartRun. Weitere Informationen zum Versions-Pinning beim Start der Ausführung finden Sie unterGeben Sie die Nextflow-Engine-Einstellungen an.

Versionssperre für aktive Läufe

Ein Workflow-Lauf wird immer mit der Engine-Version und den Plugin-Versionen abgeschlossen, mit denen er begonnen hat. Dies gilt für alle Versionsübergänge, einschließlich Patch-Updates, Versions-Außerbetriebnahme und Plugin-Updates. Versionsänderungen gelten nur für neue Läufe, die nach dem Update initiiert wurden, niemals für bereits laufende Läufe.

Es wird empfohlen, die Nextflow-Version beim Start anzuheften

Wir empfehlen dringend, dass Sie zur Laufzeit eine exakte Nextflow-Version anheften und rechtzeitig vor dem Verfallsdatum auf neueren Versionen testen. Weitere Informationen finden Sie unter Geben Sie die Nextflow-Engine-Einstellungen an.

Beschleunigte Außerbetriebnahme der Engine-Version

AWS behält sich das Recht vor, in seltenen Fällen, in denen eine Version nicht den Sicherheits- und Betriebsstandards entspricht, eine beschleunigte Außerbetriebnahme einer Nextflow-Engine-Version einzuleiten. AWS

In solchen Fällen:

  • Wenn Sie betroffene Versionen verwenden, werden Sie sofort benachrichtigt, sobald eine beschleunigte Außerdienststellung festgestellt wird.

  • Es gilt eine verkürzte Frist für die Außerbetriebnahme mit einer Kündigungsfrist von mindestens 90 Tagen, sofern dies betrieblich machbar ist.

  • HealthOmics bietet Anleitungen zur Migration und, wo möglich, automatische Upgrade-Tools, um Sie zu unterstützen.

Versionen der Patch-Engine

Patch-Versionen (z. B. v24.10.0 auf v24.10.8) werden im HealthOmics Rahmen der routinemäßigen Servicewartung transparent aktualisiert. Patch-Versionen enthalten Sicherheitsupdates, Bugfixes und Abhängigkeitsupdates. Sie führen keine grundlegenden Änderungen ein.

Für Patch-Upgrades gilt weder eine Benachrichtigung des Kunden noch ein Kündigungsverfahren. Sie führen immer den neuesten Sicherheitspatch in der von Ihnen ausgewählten Version aus.

Versionen der DSL-Spezifikation

Da Nextflow die Spezifikationssprache und die Engine in einer Anwendung bündelt, ist die Unterstützung der DSL-Version direkt an die Unterstützung der Engine-Versionen gebunden:

  • DSL 1 — Wird ausschließlich in Version 22.04 unterstützt. Wenn Version 22.04 eingestellt wird, endet die DSL 1-Unterstützung. Sie müssen auf DSL 2 migrieren.

  • DSL 2 — Legacy Parser (Syntax V1) — Wird auf Version 22.04 bis Version 26.04 unterstützt. In Version 26.04 erfordert der Legacy-Parser eine explizite Anmeldung. engineSettings.syntaxVersion = v1

  • DSL 2 — Strict Parser (Syntax V2) — Standard bei v26.04 und allen zukünftigen Versionen.

Vor dem Upgrade testen

Bevor Sie auf eine neuere Nextflow-Version aktualisieren, empfehlen wir Ihnen:

  • Du kannst HealthOmics MCP-Server verwenden, um deine Workflows zu aktualisieren und gegen eine neuere Version zu validieren, einschließlich der Überprüfung auf wichtige Änderungen und Versionskompatibilität. Sie können die MCP-Server über Kiro CLI, Claude Code oder einen anderen MCP-compatible agentischen Endpunkt verwenden.

  • Verwenden Sie den engineSettings.engineVersion Parameter inStartRun, um Workflows mit einer neueren Version zu testen, ohne Ihre Workflow-Definition zu ändern. Weitere Informationen finden Sie unter Geben Sie die Nextflow-Engine-Einstellungen an.

  • In den https://www.nextflow.io/docs/latest/migrations/index.html Nextflow-Migrationsleitfäden finden Sie wichtige Änderungen zwischen den Versionen.

  • Testen Sie bei Workflows, die von v25.10 oder früher auf v26.04 umgestellt werden, die Kompatibilität mit dem Strict Parser (V2) oder setzen Sie explizit auf. syntaxVersion v1

  • Folgen Sie für Workflows auf DSL 1 (v22.04) vor dem Upgrade der Anleitung zur Migration von DSL 1.

Versionen des Nextflow-Plugins

HealthOmics installiert einen kuratierten Satz von Nextflow-Plugins für jede unterstützte Engine-Version vor. Das Plugin-Set ist für jede Engine-Version spezifisch und kann nicht geändert werden.

Engine-Version Pre-installed Plugins
v22.04 Keine Plugin-Unterstützung
v23.10 nf-schema @2 .3.0, nf-Validierung @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
Anmerkung

Für Nextflow v24.10 und höher ersetzt nf-schema das veraltete nf-validierungs-Plugin. Du kannst nf-validation nur auf Version 23.10 verwenden.

Wie werden Nextflow-Plugin-Versionen verwaltet

HealthOmics verwaltet eine Plugin-Version pro Engine-Version:

  • Einzelne Version pro Plugin pro Engine — Nur die in der vorherigen Tabelle aufgeführte vorinstallierte Version ist verfügbar.

  • Es werden nur vorinstallierte Plugins unterstützt — HealthOmics unterstützt nur die in der vorherigen Tabelle für jede Engine-Version aufgeführten Plugins. Plugin-Deklarationen in Ihremnextflow.config, die auf Plugins verweisen, die für Ihre Engine-Version nicht vorinstalliert sind, werden nicht unterstützt.

  • Automatische Updates — Wenn HealthOmics die vorinstallierte Plugin-Version für eine Engine aktualisiert wird, verwenden alle Workflows auf dieser Engine die aktualisierte Version bei ihrer nächsten Ausführung.

  • Kein An- oder Abmelden — Plugin-Updates werden einheitlich angewendet. Es gibt keinen Mechanismus, um eine frühere Plugin-Version beizubehalten, und es gibt keine Option zur erweiterten Versionsverfügbarkeit für Plugins.

  • Versionssperre für aktive Läufe — Eine Workflow-Ausführung, die mit einer bestimmten Plugin-Version beginnt, wird mit dieser Version abgeschlossen, auch wenn das Plugin während der Ausführung aktualisiert wird. Updates gelten nur für neue Läufe, die nach dem Update initiiert werden.

Was passiert, wenn eine Plugin-Version aktualisiert wird

Wichtige Versionsänderungen (z. B. nf-schema 2.x auf 3.x):

  • Vor der Installation der Hauptversion erfolgt eine Vorankündigung von mindestens 30 Tagen.

  • Während der 30-tägigen Nachfrist bleibt die vorherige Hauptversion in Gebrauch. Ihre Workflows verwenden weiterhin die Vorgängerversion, bis die Kulanzfrist abläuft.

  • Nach Ablauf der Übergangsfrist ersetzt die neue Hauptversion die vorherige Version für alle Workflows.

  • Die Vorankündigung erfolgt per E-Mail, AWS Health Dashboard und Bannern in der Konsole.

Kleinere Updates und Patch-Updates (z. B. nf-schema 2.3.0 bis 2.7.2): Wird automatisch ohne vorherige Ankündigung angewendet. Diese Updates führen keine grundlegenden Änderungen ein.

Plugin-Änderungen testen

Wenn eine größere Änderung der Plugin-Version angekündigt wird (30-tägige Nachfrist), empfehlen wir Folgendes:

  • In den Versionshinweisen zum Plugin findest du wichtige Änderungen und Hinweise zur Migration.

  • Testen Sie Ihre Workflows mit der neuen Plugin-Version, bevor die Kulanzfrist abläuft.

  • Stellen Sie bei größeren Änderungen am NF-Schema sicher, dass die Parametervalidierungsdefinitionen Ihrer Pipeline mit dem Schemaformat der neuen Version kompatibel sind.