View a markdown version of this page

Politica di conservazione delle versioni di Nextflow - AWS HealthOmics

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Politica di conservazione delle versioni di Nextflow

Versioni supportate del motore Nextflow

HealthOmics supporta più versioni stabili del motore Nextflow. Ogni versione supporta una o più versioni DSL (Domain-Specific Language). La tabella seguente mostra le versioni attualmente supportate.

Versione Supporto DSL HealthOmics data di rilascio Stato
v22.04 DSL 1 e DSL 2 Novembre 2022 L'obsolescenza è prevista per il 30 novembre 2026
v23.10 DSL 2 ottobre 2024 L'obsolescenza è prevista per il 30 novembre 2027
v24.10 DSL 2 agosto 2025 Supportato almeno fino a novembre 2027
v25.10 DSL 2 Aprile 2026 Supportato almeno fino a ottobre 2028
v26.04 DSL 2 giugno 2026 Ultima versione, supportata almeno fino ad aprile 2029

HealthOmics non supporta le versioni mensili «edge». HealthOmics supporta le funzionalità rilasciate in ogni versione, ma non le funzionalità di anteprima.

Una versione può rimanere disponibile per l'esecuzione dei flussi di lavoro dopo aver smesso di essere supportata. Le versioni supportate (l'anno solare corrente più i due anni precedenti) ricevono nuove funzionalità e miglioramenti della compatibilità. Deprecated-but-available le versioni ricevono solo patch di sicurezza.

Per quanto tempo restano disponibili le versioni del motore Nextflow

HealthOmics supporta le versioni di Nextflow rilasciate nell'anno solare corrente, oltre alle versioni rilasciate nei due anni precedenti. Solo queste versioni supportate ricevono rilasci di funzionalità e miglioramenti della compatibilità con le versioni precedenti. In pratica:

  • Nel 2026: le famiglie degli anni di sostegno sono 26.x, 25.x e 24.x.

  • Nel 2027: quando verrà rilasciato il 27.04, le famiglie degli anni supportati passeranno a 27.x, 26.x e 25.x.

Quando la prima versione stabile di un nuovo anno solare diventa generalmente disponibile il HealthOmics, la famiglia dell'anno più vecchio è idonea alla deprecazione.

Dopo che una versione riceve un avviso di obsolescenza (entra nel periodo di preavviso da T-12 a T—0), la manutenzione è limitata alle sole patch di sicurezza. Le nuove funzionalità non vengono aggiunte alle versioni obsolete.

Ciclo di vita della deprecazione

Quando è prevista l'obsolescenza di una versione di Nextflow HealthOmics, ricevi un periodo di preavviso minimo di 12 mesi. Questo è seguito da un massimo di 24 mesi di disponibilità estesa della versione, in tre fasi distinte.

Fase Sequenza temporale Disponibilità della versione Maintenance (Manutenzione) Prezzi Creazione del workflow Avvio di una corsa La tua azione
Fase 1: Periodo di preavviso Da T-12 a T—0 Completamente funzionale per i flussi di lavoro esistenti a prezzi standard Solo patch di sicurezza Tariffa standard (nessuna modifica) Non disponibile nelle versioni obsolete Completamente funzionale per i flussi di lavoro esistenti Effettua la migrazione per evitare i prezzi relativi alla disponibilità delle versioni estese
Fase 2: disponibilità estesa della versione Da T—0 a T+24 mesi Completamente funzionale per i flussi di lavoro esistenti al prezzo di Extended Version Availability Solo patch di sicurezza 2x (mesi 0-12), 4x (mesi 12—24) Non disponibile nelle versioni obsolete Completamente funzionale per i flussi di lavoro esistenti, soggetto ai prezzi di disponibilità estesa delle versioni Inizia nuove esecuzioni sulle versioni supportate o aggiorna la versione predefinita del flusso di lavoro per uscire dai prezzi di disponibilità della versione estesa
Fase 3: fine del ciclo di vita Dopo T+24 mesi Rimosso dal servizio Nessuno N/A — le esecuzioni falliscono Non disponibile nelle versioni obsolete Le esecuzioni non riescono nelle versioni non supportate (o ritirate) È necessario eseguire l'aggiornamento per riprendere le esecuzioni o avviarne di nuove sulle versioni supportate

Fase 1: Periodo di preavviso (da T—12 a T—0)

Durante il periodo di preavviso:

  • Se stai utilizzando la versione obsoleta, riceverai comunicazioni sulla cronologia e sui flussi di lavoro interessati tramite e-mail, AWS Health Dashboard e banner nella console.

  • La versione rimane funzionale per i flussi di lavoro esistenti a prezzi standard.

  • Non è possibile creare nuovi flussi di lavoro su versioni obsolete, ma è possibile avviare nuove esecuzioni su flussi di lavoro esistenti a prezzi standard.

  • Vengono applicate solo le patch di sicurezza. Non sono previste nuove funzionalità o correzioni di bug per la versione obsoleta.

  • Ti consigliamo di testare e migrare a una versione supportata più recente.

  • Riceverai promemoria per migrare i flussi di lavoro che utilizzano la versione obsoleta.

Fase 2: disponibilità estesa della versione (da T—0 a T+24 mesi)

Dopo la data di obsolescenza (T):

  • Tutte le nuove esecuzioni avviate con versioni obsolete sono soggette ai prezzi di disponibilità estesa della versione. Puoi evitare questo prezzo avviando nuove esecuzioni nelle versioni supportate o aggiornando il tuo flusso di lavoro per utilizzare una versione supportata.

  • Non è possibile creare nuovi flussi di lavoro sulle versioni obsolete.

  • Vengono applicate solo le patch di sicurezza. Non sono previste nuove funzionalità o correzioni di bug per la versione obsoleta.

  • Se i flussi di lavoro continuano a utilizzare versioni obsolete, riceverai notifiche sui prezzi di Extended Version Availability. I prezzi per la disponibilità delle versioni estese vengono applicati solo se durante questa fase vengono avviate nuove esecuzioni con versioni obsolete.

  • Per avviare un'esecuzione sulle versioni supportate, consulta l'aggiunta della versione del motore Nextflow. Specifica le impostazioni del motore Nextflow

La tabella seguente riassume i prezzi di Extended Version Availability.

Periodo Prezzi
Da T—0 a T+12 mesi Tariffa base doppia per nuove esecuzioni su versioni non supportate
Da T+12 a T+24 mesi Tariffa base 4 volte superiore per le nuove esecuzioni su versioni non supportate

Fase 3: fine del ciclo di vita (dopo T+24 mesi)

Al termine del periodo di disponibilità della versione estesa:

  • Riceverai una notifica definitiva del ritiro della versione se un flusso di lavoro utilizza ancora la versione ritirata.

  • La versione viene completamente rimossa dal servizio. Non è possibile creare nuovi flussi di lavoro o avviare nuove esecuzioni sulla versione ritirata.

  • Le definizioni dei flussi di lavoro esistenti rimangono accessibili ma non vengono eseguite nella versione ritirata.

  • È necessario aggiornare il flusso di lavoro per utilizzare una versione del motore supportata o aggiungere una versione supportata. StartRun Per ulteriori informazioni sul blocco della versione all'avvio dell'esecuzione, consultaSpecifica le impostazioni del motore Nextflow.

Blocco della versione per le esecuzioni attive

L'esecuzione di un flusso di lavoro viene sempre completata sulla versione del motore e sulle versioni del plug-in con cui è iniziata. Questo vale per tutte le transizioni di versione, inclusi gli aggiornamenti delle patch, il ritiro delle versioni e gli aggiornamenti dei plug-in. Le modifiche alla versione si applicano solo alle nuove esecuzioni avviate dopo l'aggiornamento, mai alle esecuzioni già in corso.

Si consiglia di bloccare la versione di Nextflow all'avvio dell'esecuzione

Ti consigliamo vivamente di bloccare una versione esatta di Nextflow in fase di esecuzione e di testarla sulle versioni più recenti con largo anticipo rispetto alla data di deprecazione. Per ulteriori informazioni, consulta Specifica le impostazioni del motore Nextflow.

Ritiro accelerato della versione del motore

AWS si riserva il diritto di avviare un ritiro accelerato di una versione del motore Nextflow nei rari casi in cui una versione non può essere mantenuta coerente con gli standard operativi e di sicurezza. AWS

In questi casi:

  • Se si utilizzano versioni interessate, si riceve una notifica immediata non appena viene stabilito il ritiro anticipato.

  • Si applica una tempistica di pensionamento ridotta, con un periodo di preavviso minimo di 90 giorni laddove fattibile dal punto di vista operativo.

  • HealthOmics fornisce indicazioni sulla migrazione e, laddove possibile, strumenti di aggiornamento automatici per assistervi.

Versioni del motore di patch

Le versioni delle patch (ad esempio, dalla v24.10.0 alla v24.10.8) vengono aggiornate in modo trasparente nell'ambito della manutenzione ordinaria del servizio. HealthOmics Le versioni delle patch contengono correzioni di sicurezza, correzioni di bug e aggiornamenti delle dipendenze. Non introducono modifiche sostanziali.

Nessun processo di notifica o ritiro dei clienti si applica agli aggiornamenti delle patch. Esegui sempre la patch sicura più recente nella versione selezionata.

Versioni con specifiche DSL

Poiché Nextflow raggruppa il linguaggio e il motore delle specifiche in un'unica applicazione, il supporto della versione DSL è legato direttamente al supporto della versione del motore:

  • DSL 1: supportato esclusivamente nella versione 22.04. Quando la versione 22.04 viene ritirata, il supporto DSL 1 termina. È necessario eseguire la migrazione a DSL 2.

  • DSL 2 — Legacy Parser (Syntax V1) — Supportato dalla versione 22.04 alla versione 26.04. Nella versione v26.04, il parser precedente richiede un consenso esplicito. engineSettings.syntaxVersion = v1

  • DSL 2 - Strict Parser (Syntax V2): impostazione predefinita sulla v26.04 e su tutte le versioni future.

Test prima dell'aggiornamento

Prima di passare a una versione più recente di Nextflow, ti consigliamo di:

  • Puoi utilizzare i server HealthOmics MCP per aggiornare e convalidare i tuoi flussi di lavoro rispetto a una versione più recente, incluso il controllo delle modifiche sostanziali e della compatibilità delle versioni. Puoi utilizzare i server MCP tramite Kiro CLI, Claude Code o qualsiasi altro endpoint agentico. MCP-compatible

  • Usa il engineSettings.engineVersion parametro in StartRun per testare i flussi di lavoro rispetto a una versione più recente senza modificare la definizione del flusso di lavoro. Per ulteriori informazioni, consulta Specifica le impostazioni del motore Nextflow.

  • Consulta le guide alla migrazione di Nextflow per informazioni sulle modifiche sostanziali tra le versioni.

  • Per i flussi di lavoro che passano dalla versione 25.10 o precedente alla versione 26.04, verifica la compatibilità con Strict Parser (V2) o impostala esplicitamente su. syntaxVersion v1

  • Per i flussi di lavoro su DSL 1 (v22.04), segui la guida alla migrazione da DSL 1 prima dell'aggiornamento. https://nextflow.io/docs/latest/dsl1.html

Versioni del plugin Nextflow

HealthOmics preinstalla un set selezionato di plugin Nextflow per ogni versione del motore supportata. Il set di plug-in è specifico per ogni versione del motore e non può essere modificato.

Versione del motore Pre-installed plugin
v22.04 Nessun supporto per i plugin
v23.10 nf-schema @2 .3.0, convalida nf @1 .1.1
v24.10 schema nf @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
Nota

Per Nextflow v24.10 e versioni successive, nf-schema sostituisce il plugin nf-validation obsoleto. È possibile utilizzare nf-validation solo sulla versione 23.10.

Come vengono gestite le versioni del plugin Nextflow

HealthOmics mantiene una versione del plugin per versione del motore:

  • Versione singola per plug-in per motore: è disponibile solo la versione preinstallata elencata nella tabella precedente.

  • Sono supportati solo i plug-in preinstallati: HealthOmics supporta solo i plug-in elencati nella tabella precedente per ciascuna versione del motore. Le dichiarazioni dei plugin presenti nella versione di riferimento non sono nextflow.config supportate. I plugin non preinstallati per la versione del motore in uso non sono supportati.

  • Aggiornamenti automatici: quando si HealthOmics aggiorna la versione del plug-in preinstallata per un motore, tutti i flussi di lavoro su quel motore utilizzano la versione aggiornata alla successiva esecuzione.

  • Nessun opt-in o opt-out: gli aggiornamenti dei plugin vengono applicati in modo uniforme. Non esiste alcun meccanismo per mantenere una versione precedente del plug-in e nessuna opzione di disponibilità estesa della versione per i plug-in.

  • Blocco della versione per le esecuzioni attive: un'esecuzione del flusso di lavoro che inizia su una determinata versione del plug-in viene completata su quella versione, anche se il plug-in viene aggiornato durante l'esecuzione. Gli aggiornamenti si applicano solo alle nuove esecuzioni avviate dopo l'aggiornamento.

Cosa succede quando si aggiorna la versione di un plugin

Principali modifiche alla versione (ad esempio, da nf-schema da 2.x a 3.x):

  • Viene fornito un preavviso minimo di 30 giorni prima dell'applicazione della versione principale.

  • Durante il periodo di tolleranza di 30 giorni, la versione principale precedente rimane in uso. I tuoi flussi di lavoro continuano a utilizzare la versione precedente fino al termine del periodo di prova.

  • Dopo il periodo di prova, la nuova versione principale sostituisce la versione precedente per tutti i flussi di lavoro.

  • L'avviso anticipato viene comunicato tramite e-mail, AWS Health Dashboard e banner nella console.

Aggiornamenti minori e patch (ad esempio, da nf-schema da 2.3.0 a 2.7.2): applicati automaticamente senza preavviso. Questi aggiornamenti non introducono modifiche sostanziali.

Test delle modifiche al plugin

Quando viene annunciata una modifica importante alla versione del plugin (periodo di tolleranza di 30 giorni), consigliamo quanto segue:

  • Consulta le note di rilascio del plugin per le modifiche più importanti e le indicazioni sulla migrazione.

  • Metti alla prova i tuoi flussi di lavoro rispetto alla nuova versione del plugin prima della fine del periodo di prova.

  • Per le modifiche principali di nf-schema, verificate che le definizioni di convalida dei parametri della pipeline siano compatibili con il formato dello schema della nuova versione.