View a markdown version of this page

Dukungan versi untuk bahasa definisi HealthOmics alur kerja - AWS HealthOmics
Dukungan versi WDLDukungan versi CWLDukungan versi Nextflow

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

Dukungan versi untuk bahasa definisi HealthOmics alur kerja

HealthOmics mendukung file definisi alur kerja yang ditulis dalam Nextflow, WDL, atau CWL. Bagian berikut memberikan informasi tentang dukungan HealthOmics versi untuk bahasa-bahasa ini.

Dukungan versi WDL

HealthOmics mendukung versi 1.0, 1.1, dan versi pengembangan spesifikasi WDL.

Setiap dokumen WDL harus menyertakan pernyataan versi untuk menentukan versi (mayor dan minor) dari spesifikasi yang dipatuhi. Untuk informasi selengkapnya tentang versi, lihat Pembuatan versi WDL

Versi 1.0 dan 1.1 dari spesifikasi WDL tidak mendukung Directory tipe. Untuk menggunakan Directory tipe untuk input atau output, atur versi ke development di baris pertama file:

version development  # first line of .wdl file
     ... remainder of the file ...

Dukungan versi CWL

HealthOmics mendukung versi 1.0, 1.1, dan 1.2 dari bahasa CWL.

Anda dapat menentukan versi bahasa dalam file definisi alur kerja CWL. Untuk informasi selengkapnya tentang CWL, lihat panduan pengguna CWL

Dukungan versi Nextflow

HealthOmics mendukung lima versi stabil Nextflow. Nextflow biasanya merilis versi stabil setiap enam bulan. HealthOmics tidak mendukung rilis “edge” bulanan.

HealthOmics mendukung fitur yang dirilis di setiap versi, tetapi tidak fitur pratinjau.

Versi yang didukung

HealthOmics mendukung versi Nextflow berikut:

  • Nextflow v22.04.01 DSL 1 dan DSL 2

  • Nextflow v23.10.0 DSL 2 (default)

  • Alur Berikutnya v24.10.8 DSL 2

  • Alur Berikutnya v25.10.0 DSL 2

  • Alur Berikutnya v26.04.0 DSL 2

catatan

Nextflow v26.04.0 menggunakan parser sintaks ketat (v2) secara default. Untuk menggunakan parser lama, atur engineSettings.syntaxVersion ke v1 saat memulai proses. Untuk Nextflow v25.10.0 dan sebelumnya, HealthOmics tidak mendukung mode sintaks ketat dan satu-satunya nilai yang diizinkan adalah. v1

Secara terpisah, HealthOmics jalankan linter ketat Nextflow bawaan selama pembuatan alur kerja. Linter berlaku untuk semua versi DSL2 (v22.04, v23.10, v24.10, v25.10, dan v26.04). Alur kerja DSL1 tidak berserat. Temuan serat muncul di statusMessage bidang GetWorkflow respons. Untuk informasi selengkapnya, lihat Pengaruh alur kerja di HealthOmics.

Untuk memigrasikan alur kerja Anda ke versi terbaru yang didukung (v26.04.0), ikuti panduan peningkatan Nextflow.

Ada beberapa perubahan besar saat bermigrasi ke Nextflow v24, v25, atau v26. Ikuti panduan migrasi Nextflow.

Mendeteksi dan memproses versi Nextflow

HealthOmics mendeteksi versi DSL dan versi Nextflow yang Anda tentukan. Ini secara otomatis menentukan versi Nextflow terbaik untuk dijalankan berdasarkan input ini.

Versi DSL

HealthOmics mendeteksi versi DSL yang diminta dalam file definisi alur kerja Anda. Misalnya, Anda dapat menentukan:nextflow.enable.dsl=2.

HealthOmics mendukung DSL 2 secara default. Ini memberikan kompatibilitas mundur dengan DSL 1, jika ditentukan dalam file definisi alur kerja Anda.

  • Jika Anda menentukan DSL 1, HealthOmics jalankan Nextflow v22.04 DSL1 (satu-satunya versi yang didukung yang menjalankan DSL 1).

  • Jika Anda tidak menentukan versi DSL, atau jika tidak HealthOmics dapat mengurai informasi DSL karena alasan apa pun (seperti kesalahan sintaks dalam file definisi alur kerja Anda), HealthOmics default ke DSL 2 dan menjalankan Nextflow v23.10.0.

  • Untuk meningkatkan alur kerja Anda dari DSL 1 ke DSL 2 untuk memanfaatkan versi Nextflow terbaru dan fitur perangkat lunak, lihat Migrasi dari DSL 1.

Versi Nextflow

HealthOmics mendeteksi versi Nextflow yang diminta dalam file konfigurasi Nextflow (nextflow.config), jika Anda menyediakan file ini. Kami menyarankan Anda menambahkan nextflowVersion klausa di akhir file untuk menghindari penggantian tak terduga dari konfigurasi yang disertakan. Untuk informasi selengkapnya, lihat konfigurasi Nextflow.

Anda dapat menentukan versi Nextflow atau rentang versi menggunakan sintaks berikut:

   // exact match
   manifest.nextflowVersion = '1.2.3'   
            
   // 1.2 or later (excluding 2 and later)
   manifest.nextflowVersion = '1.2+'         
            
   // 1.2 or later
   manifest.nextflowVersion = '>=1.2'
            
   // any version in the range 1.2 to 1.5
   manifest.nextflowVersion = '>=1.2, <=1.5' 
            
   // use the "!" prefix to stop execution if the current version 
   // doesn't match the required version.
   manifest.nextflowVersion = '!>=1.2'

HealthOmics memproses informasi versi Nextflow sebagai berikut:

  • Jika Anda menggunakan = untuk menentukan versi yang tepat yang HealthOmics mendukung, HealthOmics gunakan versi itu.

  • Jika Anda menggunakan ! untuk menentukan versi yang tepat atau rentang versi yang tidak didukung, HealthOmics menimbulkan pengecualian dan gagal dijalankan. Pertimbangkan untuk menggunakan opsi ini jika Anda ingin ketat dengan permintaan versi dan gagal dengan cepat jika permintaan menyertakan versi yang tidak didukung.

  • Jika Anda menentukan rentang versi, gunakan HealthOmics versi preferensi tertinggi dalam rentang tersebut. Urutan preferensi dari tertinggi ke terendah adalah v23.10.0, v22.04.0, v24.10.8, v25.10.0, dan v26.04.0. Contoh:

    • Jika rentang mencakup v25.10.0 dan v26.04.0, pilih v25.10.0. HealthOmics

    • Jika rentang mencakup v24.10.8 dan v25.10.0, pilih v24.10.8. HealthOmics

  • Jika tidak ada versi yang diminta, atau jika versi yang diminta tidak valid atau tidak dapat diurai karena alasan apa pun:

    • Jika Anda menentukan DSL 1, HealthOmics jalankan Nextflow v22.04.

    • Jika tidak, HealthOmics jalankan Nextflow v23.10.0.

Anda dapat mengganti versi Nextflow yang dipilih secara otomatis dengan menyetel permintaan. engineSettings.engineVersion StartRun Ini menyematkan run ke versi Nextflow tertentu terlepas dari versi yang ditentukan dalam file alur kerja. nextflow.config Untuk informasi selengkapnya, lihat Tentukan pengaturan mesin Nextflow.

Anda dapat mengambil informasi berikut tentang versi Nextflow yang HealthOmics digunakan untuk setiap proses:

  • Log run berisi informasi tentang versi Nextflow aktual yang HealthOmics digunakan untuk menjalankan.

  • HealthOmics menambahkan peringatan di log run jika tidak ada kecocokan langsung dengan versi yang Anda minta atau jika perlu menggunakan versi yang berbeda dari yang Anda tentukan.

  • Respons terhadap operasi GetRun API menyertakan bidang (engineVersion) dengan versi Nextflow aktual yang HealthOmics digunakan untuk menjalankan. Contoh:

    "engineVersion":"22.04.0"