View a markdown version of this page

Política de retenção de versões do Nextflow - AWS HealthOmics
Versões suportadas do mecanismo NextflowPor quanto tempo as versões do mecanismo Nextflow permanecem disponíveisCiclo de vida de depreciaçãoDesativação acelerada da versão do motorVersões do Patch EngineVersões da especificação DSLTeste antes da atualizaçãoVersões do plugin Nextflow

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Política de retenção de versões do Nextflow

Versões suportadas do mecanismo Nextflow

HealthOmics suporta várias versões estáveis do mecanismo Nextflow. Cada versão oferece suporte a uma ou mais versões de linguagem específica de domínio (DSL). A tabela a seguir mostra as versões atualmente suportadas.

Versão Suporte DSL HealthOmics data de lançamento Status
v22.04 DSL 1 e DSL 2 Novembro de 2022 Programado para descontinuação em 30 de novembro de 2026
v23.10 DSL 2 Outubro de 2024 Programado para descontinuação em 30 de novembro de 2027
v24.10 DSL 2 Agosto de 2025 Suportado até pelo menos novembro de 2027
v25.10 DSL 2 Abril de 2026 Suportado até pelo menos outubro de 2028
v26.04 DSL 2 Junho de 2026 Mais recente, com suporte até pelo menos abril de 2029

HealthOmics não suporta os lançamentos mensais “periféricos”. HealthOmics oferece suporte aos recursos lançados em cada versão, mas não aos recursos de visualização.

Uma versão pode permanecer disponível para executar fluxos de trabalho após deixar de ser suportada. As versões suportadas (o ano civil atual mais os dois anos anteriores) recebem novos recursos e melhorias de compatibilidade. Deprecated-but-available as versões recebem somente patches de segurança.

Por quanto tempo as versões do mecanismo Nextflow permanecem disponíveis

HealthOmics suporta as versões do Nextflow lançadas no ano civil atual, além das versões lançadas nos dois anos anteriores. Somente essas versões suportadas recebem lançamentos de recursos e melhorias de compatibilidade com versões anteriores. Na prática:

  • Em 2026: as famílias de anos com suporte são 26,x, 25,x e 24,x.

  • Em 2027: quando 27.04 for lançado, as famílias de anos suportados mudarão para 27.x, 26.x e 25.x.

Quando a primeira versão estável de um novo ano civil se torna disponível ao público em geral HealthOmics, a família de anos mais antiga é elegível para suspensão de uso.

Depois que uma versão recebe um aviso de descontinuação (entra no período de aviso de T—12 a T—0), a manutenção é limitada somente aos patches de segurança. Novos recursos não são adicionados às versões obsoletas.

Ciclo de vida de depreciação

Quando uma versão do Nextflow está programada para ser descontinuada HealthOmics, você recebe um período mínimo de aviso prévio de 12 meses. Isso é seguido por até 24 meses de disponibilidade estendida da versão, em três fases distintas.

Fase Linha do tempo Disponibilidade da versão Manutenção Preços Criação de workflow Começando uma corrida Sua ação
Fase 1: Período de notificação T—12 a T—0 Totalmente funcional para fluxos de trabalho existentes a preços padrão Somente patches de segurança Taxa padrão (sem alteração) Não disponível em versões obsoletas Totalmente funcional para fluxos de trabalho existentes Migre para evitar preços de disponibilidade estendida de versões
Fase 2: Disponibilidade estendida da versão T—0 a T+24 meses Totalmente funcional para fluxos de trabalho existentes com preços de disponibilidade de versão estendida Somente patches de segurança 2x (meses 0—12), 4x (meses 12—24) Não disponível em versões obsoletas Totalmente funcional para fluxos de trabalho existentes, sujeito aos preços de disponibilidade de versão estendida Inicie novas execuções em versões compatíveis ou atualize a versão padrão do fluxo de trabalho para sair dos preços de disponibilidade estendida de versões
Fase 3: Fim da vida Depois de T+24 meses Removido do serviço Nenhum N/A — falha nas execuções Não disponível em versões obsoletas As execuções falham em versões não suportadas (ou desativadas) Você deve atualizar para retomar as execuções ou iniciar novas execuções nas versões suportadas

Fase 1: Período de notificação (T—12 a T—0)

Durante o período de aviso prévio:

  • Se você estiver usando a versão obsoleta, receberá comunicações sobre o cronograma e os fluxos de trabalho afetados por e-mail, AWS Health Dashboard e banners no console.

  • A versão permanece funcional para fluxos de trabalho existentes com preços padrão.

  • Você não pode criar novos fluxos de trabalho em versões obsoletas, mas pode iniciar novas execuções em fluxos de trabalho existentes com preços padrão.

  • Somente patches de segurança são aplicados. Nenhum novo recurso ou correção de erros é fornecido para a versão obsoleta.

  • Recomendamos que você teste e migre para uma versão compatível mais recente.

  • Você recebe lembretes para migrar fluxos de trabalho que usam a versão obsoleta.

Fase 2: Disponibilidade estendida da versão (T—0 a T+24 meses)

Após a data de depreciação (T):

  • Todas as novas execuções iniciadas com versões obsoletas incorrem em preços de disponibilidade de versão estendida. Você pode evitar esse preço iniciando novas execuções em versões compatíveis ou atualizando seu fluxo de trabalho para usar uma versão compatível.

  • Você não pode criar novos fluxos de trabalho nas versões obsoletas.

  • Somente patches de segurança são aplicados. Nenhum novo recurso ou correção de erros é fornecido para a versão obsoleta.

  • Você receberá notificações sobre preços de disponibilidade de versão estendida se seus fluxos de trabalho continuarem usando versões obsoletas. O preço de disponibilidade de versão estendida é aplicado somente se novas execuções forem iniciadas com versões obsoletas durante essa fase.

  • Para iniciar uma execução em versões compatíveis, consulte Fixação da versão do mecanismo Nextflow. Especifique as configurações do mecanismo Nextflow

A tabela a seguir resume os preços de disponibilidade de versão estendida.

Período Preços
T—0 a T+12 meses 2x a taxa básica para novas execuções em versões não suportadas
T+12 a T+24 meses 4x a taxa básica para novas execuções em versões não suportadas

Fase 3: Fim da vida útil (após T+24 meses)

Após o término do período de disponibilidade da versão estendida:

  • Você receberá a notificação final da retirada da versão se algum fluxo de trabalho ainda estiver usando a versão desativada.

  • A versão foi totalmente removida do serviço. Você não pode criar novos fluxos de trabalho nem iniciar novas execuções na versão descontinuada.

  • As definições de fluxo de trabalho existentes permanecem acessíveis, mas não são executadas na versão descontinuada.

  • Você deve atualizar seu fluxo de trabalho para usar uma versão de mecanismo compatível ou fixar uma versão compatívelStartRun. Para obter mais informações sobre fixação de versão no horário de início da execução, consulteEspecifique as configurações do mecanismo Nextflow.

Bloqueio de versão para execuções ativas

A execução de um fluxo de trabalho sempre é concluída na versão do mecanismo e nas versões do plug-in com as quais começou. Isso se aplica a todas as transições de versão, incluindo atualizações de patches, retirada de versão e atualizações de plug-ins. As alterações de versão se aplicam somente às novas execuções iniciadas após a atualização, nunca às execuções já em andamento.

Recomenda-se fixar a versão do Nextflow no início da execução

É altamente recomendável que você fixe uma versão exata do Nextflow em tempo de execução e teste em versões mais recentes bem antes de qualquer data de descontinuação. Para obter mais informações, consulte Especifique as configurações do mecanismo Nextflow.

Desativação acelerada da versão do motor

AWS se reserva o direito de iniciar uma retirada rápida de uma versão do mecanismo Nextflow em casos raros em que uma versão não possa ser mantida de acordo com AWS os padrões operacionais e de segurança.

Nesses casos:

  • Se você estiver usando as versões afetadas, você será notificado imediatamente após a determinação da aposentadoria acelerada.

  • Um cronograma de aposentadoria reduzido se aplica, com um período mínimo de aviso prévio de 90 dias, sempre que operacionalmente viável.

  • HealthOmics fornece orientação de migração e, sempre que possível, ferramentas de upgrade automatizadas para ajudá-lo.

Versões do Patch Engine

As versões de patch (por exemplo, v24.10.0 para v24.10.8) são atualizadas de forma transparente como parte da manutenção de rotina do serviço. HealthOmics As versões de patch contêm correções de segurança, correções de bugs e atualizações de dependências. Eles não introduzem mudanças significativas.

Nenhuma notificação ao cliente ou processo de retirada se aplica às atualizações de patches. Você sempre executa o patch seguro mais recente na versão selecionada.

Versões da especificação DSL

Como o Nextflow agrupa a linguagem de especificação e o mecanismo em um único aplicativo, o suporte à versão DSL está diretamente vinculado ao suporte à versão do mecanismo:

  • DSL 1 — Suportado exclusivamente na v22.04. Quando a v22.04 for descontinuada, o suporte ao DSL 1 será encerrado. Você deve migrar para o DSL 2.

  • DSL 2 — Legacy Parser (Syntax V1) — Suportado de v22.04 a v26.04. Na v26.04, o analisador legado exige aceitação explícita. engineSettings.syntaxVersion = v1

  • DSL 2 — Strict Parser (Syntax V2) — Padrão na v26.04 e em todas as versões futuras.

Teste antes da atualização

Antes de atualizar para uma versão mais recente do Nextflow, recomendamos que você:

  • Você pode usar servidores HealthOmics MCP para atualizar e validar seus fluxos de trabalho em relação a uma versão mais recente, incluindo a verificação de alterações importantes e compatibilidade de versões. Você pode usar os servidores MCP por meio do Kiro CLI, do Claude Code ou de qualquer outro endpoint agente. MCP-compatible

  • Use o engineSettings.engineVersion parâmetro in StartRun para testar fluxos de trabalho em uma versão mais recente sem alterar sua definição de fluxo de trabalho. Para obter mais informações, consulte Especifique as configurações do mecanismo Nextflow.

  • Consulte os guias de migração do Nextflow para ver as mudanças significativas entre as versões.

  • Para fluxos de trabalho migrando da v25.10 ou anterior para a v26.04, teste a compatibilidade com o Strict Parser (V2) ou defina explicitamente como. syntaxVersion v1

  • Para fluxos de trabalho no DSL 1 (v22.04), siga o guia Migrando do DSL 1 antes de fazer o upgrade.

Versões do plugin Nextflow

HealthOmics pré-instala um conjunto selecionado de plug-ins do Nextflow para cada versão de mecanismo compatível. O conjunto de plug-ins é específico para cada versão do mecanismo e não pode ser modificado.

Versão do mecanismo Pre-installed plug-ins
v22.04 Sem suporte a plug-ins
v23.10 esquema nf @2 .3.0, validação nf @1 .1.1
v24.10 esquema 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

Para o Nextflow v24.10 e superior, o nf-schema substitui o plug-in obsoleto de validação de nf. Você pode usar a validação nf somente na v23.10.

Como as versões do plugin Nextflow são gerenciadas

HealthOmics mantém uma versão do plugin por versão do mecanismo:

  • Versão única por plug-in por mecanismo — Somente a versão pré-instalada listada na tabela anterior está disponível.

  • Somente plug-ins pré-instalados são suportados — HealthOmics suporta somente os plug-ins listados na tabela anterior para cada versão do mecanismo. Declarações de plug-in em seu de nextflow.config que plug-ins de referência não pré-instalados para a versão do mecanismo não são suportadas.

  • Atualizações automáticas — Quando HealthOmics atualiza a versão pré-instalada do plug-in de um mecanismo, todos os fluxos de trabalho desse mecanismo usam a versão atualizada na próxima execução.

  • Sem opt-in ou opt-out — As atualizações de plug-ins são aplicadas uniformemente. Não há mecanismo para permanecer em uma versão anterior do plug-in e não há opção de disponibilidade de versão estendida para plug-ins.

  • Bloqueio de versão para execuções ativas — Uma execução de fluxo de trabalho que começa em uma determinada versão do plug-in é concluída nessa versão, mesmo que o plug-in seja atualizado durante a execução. As atualizações se aplicam somente às novas execuções iniciadas após a atualização.

O que acontece quando a versão de um plugin é atualizada

Principais mudanças de versão (por exemplo, nf-schema 2.x para 3.x):

  • Um aviso prévio mínimo de 30 dias é fornecido antes da aplicação da versão principal.

  • Durante o período de carência de 30 dias, a versão principal anterior permanece em uso. Seus fluxos de trabalho continuam usando a versão anterior até o término do período de carência.

  • Após o período de carência, a nova versão principal substitui a versão anterior em todos os fluxos de trabalho.

  • O aviso prévio é comunicado por e-mail, AWS Health Dashboard e banners no console.

Atualizações secundárias e de patch (por exemplo, nf-schema 2.3.0 a 2.7.2): aplicadas automaticamente sem aviso prévio. Essas atualizações não introduzem mudanças significativas.

Testando alterações no plugin

Quando uma grande alteração na versão do plug-in é anunciada (período de carência de 30 dias), recomendamos o seguinte:

  • Consulte as notas de lançamento do plug-in para ver as mudanças mais recentes e as diretrizes de migração.

  • Teste seus fluxos de trabalho com a nova versão do plug-in antes que o período de carência termine.

  • Para mudanças importantes no nf-schema, verifique se as definições de validação de parâmetros do seu pipeline são compatíveis com o formato do esquema da nova versão.