View a markdown version of this page

Kebijakan retensi versi Nextflow - AWS HealthOmics
Versi mesin Nextflow yang didukungBerapa lama versi mesin Nextflow tetap tersediaSiklus hidup penghentianPensiun versi mesin yang dipercepatVersi mesin patchVersi spesifikasi DSLPengujian sebelum memutakhirkanVersi plugin Nextflow

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Kebijakan retensi versi Nextflow

Versi mesin Nextflow yang didukung

HealthOmics mendukung beberapa rilis stabil dari mesin Nextflow. Setiap rilis mendukung satu atau lebih versi bahasa khusus domain (DSL). Tabel berikut menunjukkan versi yang didukung saat ini.

Versi Dukungan DSL HealthOmics tanggal rilis Status
v22.04 DSL 1 & DSL 2 November 2022 Dijadwalkan untuk penghentian pada 30 November 2026
v23.10 DSL 2 Oktober 2024 Dijadwalkan untuk penghentian pada 30 November 2027
v24.10 DSL 2 Agustus 2025 Didukung setidaknya hingga November 2027
v25.10 DSL 2 April 2026 Didukung setidaknya hingga Oktober 2028
v26.04 DSL 2 Juni 2026 Terbaru, didukung setidaknya April 2029

HealthOmics tidak mendukung rilis “edge” bulanan. HealthOmics mendukung fitur yang dirilis di setiap versi, tetapi tidak fitur pratinjau.

Versi dapat tetap tersedia untuk menjalankan alur kerja setelah berhenti didukung. Versi yang didukung (tahun kalender saat ini ditambah dua tahun sebelumnya) menerima fitur baru dan peningkatan kompatibilitas. Deprecated-but-available versi hanya menerima patch keamanan.

Berapa lama versi mesin Nextflow tetap tersedia

HealthOmics mendukung versi Nextflow yang dirilis dalam tahun kalender saat ini, ditambah versi yang dirilis dalam dua tahun sebelumnya. Hanya versi yang didukung ini yang menerima rilis fitur dan peningkatan kompatibilitas mundur. Dalam prakteknya:

  • Pada tahun 2026: Keluarga tahun yang didukung adalah 26.x, 25.x, dan 24.x.

  • Pada tahun 2027: Ketika 27.04 dirilis, keluarga tahun yang didukung beralih ke 27.x, 26.x, dan 25.x.

Ketika rilis stabil pertama dari tahun kalender baru tersedia secara umum pada HealthOmics, keluarga tahun tertua memenuhi syarat untuk tidak digunakan lagi.

Setelah versi menerima pemberitahuan penghentian (memasuki periode pemberitahuan T—12 hingga T—0), pemeliharaan terbatas pada patch keamanan saja. Fitur baru tidak ditambahkan ke versi usang.

Siklus hidup penghentian

Ketika versi Nextflow dijadwalkan untuk penghentian HealthOmics, Anda menerima periode pemberitahuan minimal 12 bulan. Ini diikuti oleh hingga 24 bulan Ketersediaan Versi Diperpanjang, di tiga fase berbeda.

Fase Jadwal Ketersediaan versi Maintenance Harga Pembuatan alur kerja Memulai lari Tindakan Anda
Tahap 1: Periode Pemberitahuan T—12 hingga T—0 Sepenuhnya fungsional untuk alur kerja yang ada dengan harga standar Hanya patch keamanan Tarif standar (tidak ada perubahan) Tidak tersedia pada versi yang tidak digunakan lagi Sepenuhnya fungsional untuk alur kerja yang ada Bermigrasi untuk menghindari harga Ketersediaan Versi Diperpanjang
Fase 2: Ketersediaan Versi Diperpanjang T—0 hingga T+24 bulan Sepenuhnya berfungsi untuk alur kerja yang ada dengan harga Extended Version Availability Hanya patch keamanan 2x (bulan 0—12), 4x (bulan 12—24) Tidak tersedia pada versi yang tidak digunakan lagi Sepenuhnya berfungsi untuk alur kerja yang ada, tergantung pada harga Ketersediaan Versi Diperpanjang Mulai proses baru pada versi yang didukung atau tingkatkan versi default alur kerja untuk keluar dari harga Ketersediaan Versi Diperpanjang
Fase 3: Akhir Kehidupan Setelah T+24 bulan Dihapus dari layanan Tidak ada N/A — berjalan gagal Tidak tersedia pada versi yang tidak digunakan lagi Berjalan gagal pada versi yang tidak didukung (atau dihentikan) Anda harus meningkatkan untuk melanjutkan proses atau memulai proses baru pada versi yang didukung

Fase 1: Periode Pemberitahuan (T—12 hingga T—0)

Selama periode pemberitahuan:

  • Jika Anda menggunakan versi yang tidak digunakan lagi, Anda menerima komunikasi tentang timeline dan alur kerja yang terkena dampak melalui email, Dasbor AWS Kesehatan, dan spanduk dalam konsol.

  • Versi ini tetap berfungsi untuk alur kerja yang ada dengan harga standar.

  • Anda tidak dapat membuat alur kerja baru pada versi yang tidak digunakan lagi, tetapi Anda dapat memulai proses baru pada alur kerja yang ada dengan harga standar.

  • Hanya patch keamanan yang diterapkan. Tidak ada fitur baru atau perbaikan bug yang disediakan untuk versi usang.

  • Kami menyarankan Anda menguji dan bermigrasi ke versi yang didukung yang lebih baru.

  • Anda menerima pengingat untuk memigrasikan alur kerja yang menggunakan versi yang tidak digunakan lagi.

Fase 2: Ketersediaan Versi Diperpanjang (T—0 hingga T+24 bulan)

Setelah tanggal penghentian (T):

  • Setiap proses baru yang dimulai dengan versi yang tidak digunakan lagi dikenakan harga Ketersediaan Versi Diperpanjang. Anda dapat menghindari harga ini dengan memulai proses baru pada versi yang didukung atau memutakhirkan alur kerja Anda untuk menggunakan versi yang didukung.

  • Anda tidak dapat membuat alur kerja baru pada versi yang tidak digunakan lagi.

  • Hanya patch keamanan yang diterapkan. Tidak ada fitur baru atau perbaikan bug yang disediakan untuk versi usang.

  • Anda menerima pemberitahuan tentang harga Ketersediaan Versi Diperpanjang jika alur kerja Anda terus menggunakan versi yang tidak digunakan lagi. Harga Ketersediaan Versi Diperpanjang hanya diterapkan jika proses baru dimulai dengan versi yang tidak digunakan lagi selama fase ini.

  • Untuk memulai menjalankan versi yang didukung, lihat menyematkan versi mesin Nextflow. Tentukan pengaturan mesin Nextflow

Tabel berikut merangkum harga Ketersediaan Versi Diperpanjang.

Periode Harga
T—0 hingga T+12 bulan Tarif dasar 2x untuk proses baru pada versi yang tidak didukung
T+12 hingga T+24 bulan Tarif dasar 4x untuk proses baru pada versi yang tidak didukung

Fase 3: Akhir Kehidupan (setelah T+24 bulan)

Setelah periode Ketersediaan Versi Diperpanjang berakhir:

  • Anda menerima pemberitahuan akhir tentang penghentian versi jika ada alur kerja yang masih menggunakan versi pensiun.

  • Versi ini sepenuhnya dihapus dari layanan. Anda tidak dapat membuat alur kerja baru atau memulai proses baru pada versi yang dihentikan.

  • Definisi alur kerja yang ada tetap dapat diakses tetapi gagal dijalankan pada versi yang dihentikan.

  • Anda harus memutakhirkan alur kerja Anda untuk menggunakan versi engine yang didukung atau menyematkan versi yang didukungStartRun. Untuk informasi selengkapnya tentang penyematan versi pada waktu mulai berjalan, lihatTentukan pengaturan mesin Nextflow.

Penguncian versi untuk proses aktif

Proses alur kerja selalu selesai pada versi mesin dan versi plugin yang dimulai dengannya. Ini berlaku untuk semua transisi versi, termasuk pembaruan tambalan, penghentian versi, dan pembaruan plugin. Perubahan versi hanya berlaku untuk proses baru yang dimulai setelah pembaruan, tidak pernah berjalan yang sudah berjalan.

Disarankan menyematkan versi Nextflow saat mulai dijalankan

Kami sangat menyarankan Anda menyematkan versi Nextflow yang tepat saat runtime dan menguji versi yang lebih baru jauh sebelum tanggal penghentian. Untuk informasi selengkapnya, lihat Tentukan pengaturan mesin Nextflow.

Pensiun versi mesin yang dipercepat

AWS berhak untuk memulai penarikan yang dipercepat dari versi mesin Nextflow dalam kasus yang jarang terjadi di mana versi tidak dapat dipertahankan sesuai dengan standar AWS keamanan dan operasional.

Dalam kasus seperti itu:

  • Jika Anda menggunakan versi yang terpengaruh, Anda akan segera diberitahu setelah penentuan pensiun yang dipercepat.

  • Garis waktu pensiun terkompresi berlaku, dengan periode pemberitahuan minimum 90 hari di mana pun memungkinkan secara operasional.

  • HealthOmics menyediakan panduan migrasi dan, jika memungkinkan, perkakas peningkatan otomatis untuk membantu Anda.

Versi mesin patch

Versi patch (misalnya, v24.10.0 ke v24.10.8) ditingkatkan secara transparan HealthOmics sebagai bagian dari pemeliharaan layanan rutin. Rilis patch berisi perbaikan keamanan, perbaikan bug, dan pembaruan ketergantungan. Mereka tidak memperkenalkan perubahan yang merusak.

Tidak ada pemberitahuan pelanggan atau proses pensiun yang berlaku untuk peningkatan patch. Anda selalu menjalankan patch aman terbaru dalam versi yang Anda pilih.

Versi spesifikasi DSL

Karena Nextflow menggabungkan bahasa spesifikasi dan mesin ke dalam satu aplikasi, dukungan versi DSL terikat langsung ke dukungan versi mesin:

  • DSL 1 - Didukung secara eksklusif pada v22.04. Ketika v22.04 dihentikan, dukungan DSL 1 berakhir. Anda harus bermigrasi ke DSL 2.

  • DSL 2 - Legacy Parser (Sintaks V1) - Didukung pada v22.04 hingga v26.04. Pada v26.04, parser lama memerlukan opt-in eksplisit. engineSettings.syntaxVersion = v1

  • DSL 2 — Strict Parser (Syntax V2) — Default pada v26.04 dan semua versi mendatang.

Pengujian sebelum memutakhirkan

Sebelum memutakhirkan ke versi Nextflow yang lebih baru, kami sarankan Anda:

  • Anda dapat menggunakan server HealthOmics MCP untuk meningkatkan dan memvalidasi alur kerja Anda terhadap versi yang lebih baru, termasuk memeriksa perubahan yang merusak dan kompatibilitas versi. Anda dapat menggunakan server MCP melalui Kiro CLI, Claude Code, atau titik akhir agen lainnya MCP-compatible .

  • Gunakan engineSettings.engineVersion parameter dalam StartRun untuk menguji alur kerja terhadap versi yang lebih baru tanpa mengubah definisi alur kerja Anda. Untuk informasi selengkapnya, lihat Tentukan pengaturan mesin Nextflow.

  • Tinjau panduan migrasi Nextflow untuk memecahkan perubahan antar versi.

  • Untuk alur kerja yang berpindah dari v25.10 atau versi sebelumnya ke v26.04, uji kompatibilitas dengan Strict Parser (V2) atau disetel secara eksplisit ke. syntaxVersion v1

  • Untuk alur kerja pada DSL 1 (v22.04), ikuti panduan Migrasi dari DSL 1 sebelum memutakhirkan.

Versi plugin Nextflow

HealthOmics pra-instal satu set plugin Nextflow yang dikuratori untuk setiap versi mesin yang didukung. Set plugin khusus untuk setiap versi mesin dan tidak dapat dimodifikasi.

Versi mesin Pre-installed plugin
v22.04 Tidak ada dukungan plugin
v23.10 nf-skema @2 .3.0, nf-validasi @1 .1.1
v24.10 nf-schema @2 .3.0
v25.10 nf-skema @2 .6.1, utilitas nf-core @0 .4.0, nf-sampel @1 .7.0, nf-fgbio @1 .0.1
v26.04 nf-skema @2 .7.2, utilitas nf-core @0 .4.0, nf-sampel @1 .7.0, nf-fgbio @1 .0.1
catatan

Untuk Nextflow v24.10 dan yang lebih tinggi, nf-schema menggantikan plugin nf-validasi yang tidak digunakan lagi. Anda dapat menggunakan nf-validasi hanya pada v23.10.

Bagaimana versi plugin Nextflow dikelola

HealthOmics mempertahankan satu versi plugin per versi mesin:

  • Versi tunggal per plugin per mesin - Hanya versi pra-instal yang tercantum dalam tabel sebelumnya yang tersedia.

  • Hanya plugin pra-instal yang didukung — hanya HealthOmics mendukung plugin yang tercantum dalam tabel sebelumnya untuk setiap versi mesin. Deklarasi plugin di plugin referensi nextflow.config yang tidak diinstal sebelumnya untuk versi mesin Anda tidak didukung.

  • Pembaruan otomatis - HealthOmics Saat memperbarui versi plugin pra-instal untuk mesin, semua alur kerja pada mesin itu menggunakan versi yang diperbarui pada proses berikutnya.

  • Tidak ada opt-in atau opt-out - Pembaruan plugin diterapkan secara seragam. Tidak ada mekanisme untuk tetap pada versi plugin sebelumnya dan tidak ada opsi Ketersediaan Versi Diperpanjang untuk plugin.

  • Penguncian versi untuk proses aktif - Sebuah alur kerja yang dimulai pada versi plugin tertentu selesai pada versi itu, bahkan jika plugin diperbarui selama dijalankan. Pembaruan hanya berlaku untuk proses baru yang dimulai setelah pembaruan.

Apa yang terjadi ketika versi plugin diperbarui

Perubahan versi utama (misalnya, nf-schema 2.x menjadi 3.x):

  • Pemberitahuan minimal 30 hari di muka diberikan sebelum versi utama diterapkan.

  • Selama masa tenggang 30 hari, versi utama sebelumnya tetap digunakan. Alur kerja Anda terus menggunakan versi sebelumnya hingga masa tenggang berakhir.

  • Setelah masa tenggang, versi utama baru menggantikan versi sebelumnya untuk semua alur kerja.

  • Pemberitahuan sebelumnya dikomunikasikan melalui email, AWS Dasbor Kesehatan, dan spanduk dalam konsol.

Pembaruan minor dan patch (misalnya, nf-schema 2.3.0 hingga 2.7.2): Diterapkan secara otomatis tanpa pemberitahuan sebelumnya. Pembaruan ini tidak memperkenalkan perubahan yang merusak.

Menguji perubahan plugin

Ketika perubahan versi plugin utama diumumkan (masa tenggang 30 hari), kami merekomendasikan hal berikut:

  • Tinjau catatan rilis plugin untuk mengubah perubahan dan panduan migrasi.

  • Uji alur kerja Anda terhadap versi plugin baru sebelum masa tenggang berakhir.

  • Untuk perubahan besar nf-schema, verifikasi bahwa definisi validasi parameter pipeline Anda kompatibel dengan format skema versi baru.