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

# Nextflow 버전 보존 정책
<a name="nextflow-version-retention-policy"></a>

## 지원되는 Nextflow 엔진 버전
<a name="nf-retention-supported-versions"></a>

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 엔진 버전을 사용할 수 있는 기간
<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>

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

알림 기간 동안:
+ 더 이상 사용되지 않는 버전을 사용하는 경우 이메일, 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는 사양 언어와 엔진을 하나의 애플리케이션으로 번들링하므로 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 및 모든 향후 버전에서 기본값입니다.

## 업그레이드 전 테스트
<a name="nf-retention-testing"></a>

최신 Nextflow 버전으로 업그레이드하기 전에 다음을 수행하는 것이 좋습니다.
+ HealthOmics MCP 서버를 사용하여 주요 변경 사항 및 버전 호환성 확인을 포함하여 최신 버전에 대해 워크플로를 업그레이드하고 검증할 수 있습니다. [Kiro CLI](https://docs.aws.amazon.com/kiro/latest/userguide/what-is.html), Claude Code 또는 기타 MCP 호환 에이전트 엔드포인트를 통해 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로 이동하는 워크플로의 경우 엄격한 파서(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 플러그인을 대체합니다. v23.10에서만 nf-validation을 사용할 수 있습니다.

### Nextflow 플러그인 버전을 관리하는 방법
<a name="nf-retention-plugin-management"></a>

HealthOmics는 엔진 버전당 하나의 플러그인 버전을 유지합니다.
+ **엔진당 플러그인당 단일 버전** - 이전 표에 나열된 사전 설치된 버전만 사용할 수 있습니다.
+ **사전 설치된 플러그인만 지원 -** HealthOmics는 각 엔진 버전에 대해 이전 표에 나열된 플러그인만 지원합니다. 엔진 버전에 대해 사전 설치되지 않은 플러그인을 참조`nextflow.config`하는의 플러그인 선언은 지원되지 않습니다.
+ **자동 업데이트** - HealthOmics가 엔진에 대해 사전 설치된 플러그인 버전을 업데이트하면 해당 엔진의 모든 워크플로는 다음 실행 시 업데이트된 버전을 사용합니다.
+ **옵트인 또는 옵트아웃 없음 -** 플러그인 업데이트가 균일하게 적용됩니다. 이전 플러그인 버전에 남아 있는 메커니즘과 플러그인에 대한 확장 버전 가용성 옵션이 없습니다.
+ **활성 실행에 대한 버전 잠금** - 실행 중에 플러그인이 업데이트되더라도 지정된 플러그인 버전에서 시작하는 워크플로 실행이 해당 버전에서 완료됩니다. 업데이트는 업데이트 후 시작된 새 실행에만 적용됩니다.

### 플러그인 버전이 업데이트되면 어떻게 되나요?
<a name="nf-retention-plugin-updates"></a>

**메이저 버전 변경**(예: nf-schema 2.x에서 3.x로):
+ 메이저 버전이 적용되기 전에 최소 30일 전에 사전 공지가 제공됩니다.
+ 30일의 유예 기간 동안 이전 메이저 버전은 계속 사용 중입니다. 유예 기간이 끝날 때까지 워크플로는 이전 버전을 계속 사용합니다.
+ 유예 기간이 지나면 새 메이저 버전이 모든 워크플로의 이전 버전을 대체합니다.
+ 사전 알림은 이메일, AWS 상태 대시보드 및 콘솔 내 배너를 통해 전달됩니다.

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

#### 플러그인 변경 테스트
<a name="nf-retention-testing-plugins"></a>

주요 플러그인 버전 변경이 발표되면(30일 유예 기간) 다음을 권장합니다.
+ 주요 변경 사항 및 마이그레이션 지침은 플러그인 릴리스 정보를 검토하세요.
+ 유예 기간이 끝나기 전에 새 플러그인 버전과 비교하여 워크플로를 테스트합니다.
+ nf 스키마 주요 변경 사항의 경우 파이프라인의 파라미터 검증 정의가 새 버전의 스키마 형식과 호환되는지 확인합니다.