View a markdown version of this page

Nextflow 버전 보존 정책 - AWS HealthOmics
지원되는 Nextflow 엔진 버전Nextflow 엔진 버전을 사용할 수 있는 기간사용 중단 수명 주기신속 엔진 버전 사용 중지패치 엔진 버전DSL 사양 버전업그레이드 전 테스트Nextflow 플러그인 버전

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Nextflow 버전 보존 정책

지원되는 Nextflow 엔진 버전

HealthOmics는 Nextflow 엔진의 여러 안정적인 릴리스를 지원합니다. 각 릴리스는 하나 이상의 도메인별 언어(DSL) 버전을 지원합니다. 다음 표에는 현재 지원되는 버전이 나와 있습니다.

버전 DSL 지원 HealthOmics 릴리스 날짜 Status
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 알림 기간 입력) 유지 관리는 보안 패치로만 제한됩니다. 더 이상 사용되지 않는 버전에는 새 기능이 추가되지 않습니다.

사용 중단 수명 주기

HealthOmics에서 Nextflow 버전의 사용 중단이 예정된 경우 최소 12개월의 알림 기간이 제공됩니다. 이후 세 가지 단계에서 최대 24개월의 확장 버전 가용성이 제공됩니다.

단계 타임라인 버전 가용성 정비 요금 워크플로 생성 실행 시작 작업
1단계: 알림 기간 T–12에서 T–0으로 표준 요금으로 기존 워크플로에 완벽하게 작동 보안 패치만 표준 속도(변경 없음) 더 이상 사용되지 않는 버전에서는 사용할 수 없음 기존 워크플로에서 완벽하게 작동 마이그레이션하여 확장 버전 가용성 요금 방지
2단계: 확장 버전 가용성 T–0~T+24개월 확장 버전 가용성 요금으로 기존 워크플로에 완벽하게 작동 보안 패치만 2x(0~12개월), 4x(12~24개월) 더 이상 사용되지 않는 버전에서는 사용할 수 없음 확장 버전 가용성 요금에 따라 기존 워크플로에서 완벽하게 작동 지원되는 버전에서 새 실행을 시작하거나 워크플로 기본 버전을 업그레이드하여 확장 버전 가용성 요금 종료
3단계: 수명 종료 T+24개월 후 서비스에서 제거됨 없음 해당 사항 없음 - 실행 실패 더 이상 사용되지 않는 버전에서는 사용할 수 없음 지원되지 않는(또는 사용 중지된) 버전에서 실행 실패 지원되는 버전에서 실행을 재개하거나 새 실행을 시작하려면 업그레이드해야 합니다.

1단계: 알림 기간(T–12~T–0)

알림 기간 동안:

  • 더 이상 사용되지 않는 버전을 사용하는 경우 이메일, 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는 사양 언어와 엔진을 하나의 애플리케이션으로 번들링하므로 DSL 버전 지원은 엔진 버전 지원과 직접 연결됩니다.

  • DSL 1 - v22.04에서만 지원됩니다. v22.04가 사용 중지되면 DSL 1 지원이 종료됩니다. DSL 2로 마이그레이션해야 합니다.

  • DSL 2 - 레거시 파서(Syntax V1) - v22.04~v26.04에서 지원됩니다. v26.04에서 레거시 구문 분석기에는를 통한 명시적 옵트인이 필요합니다engineSettings.syntaxVersion = v1.

  • DSL 2 - 엄격한 파서(Syntax V2) - v26.04 및 모든 향후 버전에서 기본값입니다.

업그레이드 전 테스트

최신 Nextflow 버전으로 업그레이드하기 전에 다음을 수행하는 것이 좋습니다.

  • HealthOmics MCP 서버를 사용하여 주요 변경 사항 및 버전 호환성 확인을 포함하여 최신 버전에 대해 워크플로를 업그레이드하고 검증할 수 있습니다. Kiro CLI, Claude Code 또는 기타 MCP 호환 에이전트 엔드포인트를 통해 MCP 서버를 사용할 수 있습니다.

  • 의 engineSettings.engineVersion 파라미터를 사용하여 워크플로 StartRun 정의를 변경하지 않고 최신 버전에 대해 워크플로를 테스트합니다. 자세한 내용은 Nextflow 엔진 설정 지정 섹션을 참조하세요.

  • 버전 간 주요 변경 사항은 Nextflow 마이그레이션 가이드를 검토하세요.

  • v25.10 이하에서 v26.04로 이동하는 워크플로의 경우 엄격한 파서(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 플러그인을 대체합니다. v23.10에서만 nf-validation을 사용할 수 있습니다.

Nextflow 플러그인 버전을 관리하는 방법

HealthOmics는 엔진 버전당 하나의 플러그인 버전을 유지합니다.

  • 엔진당 플러그인당 단일 버전 - 이전 표에 나열된 사전 설치된 버전만 사용할 수 있습니다.

  • 사전 설치된 플러그인만 지원 - HealthOmics는 각 엔진 버전에 대해 이전 표에 나열된 플러그인만 지원합니다. 엔진 버전에 대해 사전 설치되지 않은 플러그인을 참조nextflow.config하는의 플러그인 선언은 지원되지 않습니다.

  • 자동 업데이트 - HealthOmics가 엔진에 대해 사전 설치된 플러그인 버전을 업데이트하면 해당 엔진의 모든 워크플로는 다음 실행 시 업데이트된 버전을 사용합니다.

  • 옵트인 또는 옵트아웃 없음 - 플러그인 업데이트가 균일하게 적용됩니다. 이전 플러그인 버전에 남아 있는 메커니즘과 플러그인에 대한 확장 버전 가용성 옵션이 없습니다.

  • 활성 실행에 대한 버전 잠금 - 실행 중에 플러그인이 업데이트되더라도 지정된 플러그인 버전에서 시작하는 워크플로 실행이 해당 버전에서 완료됩니다. 업데이트는 업데이트 후 시작된 새 실행에만 적용됩니다.

플러그인 버전이 업데이트되면 어떻게 되나요?

메이저 버전 변경(예: nf-schema 2.x에서 3.x로):

  • 메이저 버전이 적용되기 전에 최소 30일 전에 사전 공지가 제공됩니다.

  • 30일의 유예 기간 동안 이전 메이저 버전은 계속 사용 중입니다. 유예 기간이 끝날 때까지 워크플로는 이전 버전을 계속 사용합니다.

  • 유예 기간이 지나면 새 메이저 버전이 모든 워크플로의 이전 버전을 대체합니다.

  • 사전 알림은 이메일, AWS 상태 대시보드 및 콘솔 내 배너를 통해 전달됩니다.

마이너 및 패치 업데이트(예: nf-schema 2.3.0에서 2.7.2로): 사전 통지 없이 자동으로 적용됩니다. 이러한 업데이트에는 주요 변경 사항이 적용되지 않습니다.

플러그인 변경 테스트

주요 플러그인 버전 변경이 발표되면(30일 유예 기간) 다음을 권장합니다.

  • 주요 변경 사항 및 마이그레이션 지침은 플러그인 릴리스 정보를 검토하세요.

  • 유예 기간이 끝나기 전에 새 플러그인 버전과 비교하여 워크플로를 테스트합니다.

  • nf 스키마 주요 변경 사항의 경우 파이프라인의 파라미터 검증 정의가 새 버전의 스키마 형식과 호환되는지 확인합니다.