Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Buat versi alur kerja
Saat Anda membuat versi baru alur kerja, Anda perlu menentukan nilai konfigurasi untuk versi baru. Itu tidak mewarisi nilai konfigurasi apa pun dari alur kerja.
Saat Anda membuat versi, berikan nama versi yang unik untuk alur kerja ini. Anda tidak dapat mengubah nama setelah HealthOmics membuat versi.
Nama versi harus dimulai dengan huruf atau angka dan dapat mencakup huruf besar dan kecil, angka, tanda hubung, titik dan garis bawah. Panjang maksimum adalah 64 karakter. Misalnya, Anda dapat menggunakan skema penamaan sederhana, seperti version1, version2, version3. Anda juga dapat mencocokkan versi alur kerja Anda dengan konvensi versi internal Anda sendiri, seperti 2.7.0, 2.7.1, 2.7.2.
Secara opsional, gunakan bidang deskripsi versi untuk menambahkan catatan tentang versi ini. Sebagai contoh: Fix for syntax error in workflow definition.
Jangan sertakan informasi identitas pribadi (PII) dalam nama versi. Nama versi muncul di versi alur kerja ARN.
HealthOmics menetapkan ARN unik ke versi alur kerja. ARN unik berdasarkan kombinasi ID alur kerja dan nama versi.
Setelah Anda menghapus versi alur kerja, HealthOmics memungkinkan Anda menggunakan kembali nama versi untuk versi alur kerja yang berbeda. Praktik terbaik adalah tidak menggunakan kembali nama versi. Jika Anda menggunakan kembali nama, alur kerja dan setiap versi memiliki UUID unik yang dapat Anda gunakan untuk asal.
Topik
Buat versi alur kerja menggunakan konsol
Langkah-langkah untuk membuat versi alur kerja
-
Buka konsol HealthOmics
. -
Jika diperlukan, buka panel navigasi kiri (≡). Pilih Alur kerja pribadi.
-
Pada Alur kerja pribadi halaman, pilih alur kerja untuk versi baru.
-
Pada Detail alur kerja halaman, pilih Buat versi baru.
-
Pada Buat versi halaman, berikan informasi berikut:
-
Nama versi: Masukkan nama untuk versi alur kerja yang unik di seluruh alur kerja.
-
Deskripsi versi (opsional): Anda dapat menggunakan bidang deskripsi untuk menambahkan catatan tentang versi ini.
-
-
Di Definisi alur kerja panel, berikan informasi berikut:
-
Bahasa alur kerja (opsional): Pilih bahasa spesifikasi untuk versi alur kerja. Jika tidak, HealthOmics menentukan bahasa dari definisi alur kerja.
-
Untuk Sumber definisi alur kerja, pilih untuk mengimpor folder definisi dari a Git-based repositori, lokasi Amazon S3, atau dari drive lokal.
-
Untuk Impor dari layanan repositori:
catatanHealthOmics mendukung repositori publik dan pribadi untuk GitHub, GitLab, Bitbucket, GitHub self-managed, GitLab self-managed.
-
Pilih a Koneksi untuk menghubungkan Anda AWS sumber daya ke repositori eksternal. Untuk membuat koneksi, lihat Terhubung dengan repositori kode eksternal.
catatanPelanggan di TLV wilayah perlu membuat koneksi di IAD wilayah (us-east-1) untuk membuat alur kerja.
-
Dalam ID repositori lengkap, masukkan ID repositori Anda sebagai pengguna-name/repo-nama. Pastikan Anda memiliki akses ke file di repositori ini.
-
Dalam Referensi sumber (opsional), masukkan referensi sumber repositori (cabang, tag, atau komit ID). HealthOmics menggunakan cabang default jika tidak ada referensi sumber yang ditentukan.
-
Dalam Kecualikan pola file, masukkan pola file untuk mengecualikan folder, file, atau ekstensi tertentu. Ini membantu mengelola ukuran data saat mengimpor file repositori. Ada maksimal 50 pola, dan pola harus mengikuti sintaks pola glob
. Contoh: -
tests/ -
*.jpeg -
large_data.zip
-
-
-
Untuk Pilih folder definisi dari S3:
-
Masukkan lokasi Amazon S3 yang berisi folder definisi alur kerja zip. Bucket Amazon S3 harus berada di wilayah yang sama dengan alur kerja.
-
Jika akun Anda tidak memiliki bucket Amazon S3, masukkan bucket pemilik bucket AWS ID akun di ID akun pemilik bucket S3. Informasi ini diperlukan agar HealthOmics dapat memverifikasi kepemilikan bucket.
-
-
Untuk Pilih folder definisi dari sumber lokal:
-
Masukkan lokasi drive lokal dari folder definisi alur kerja zip.
-
-
-
Jalur file definisi alur kerja utama (opsional): Masukkan jalur file dari folder definisi alur kerja zip atau repositori ke
mainberkas. Parameter ini tidak diperlukan jika hanya ada satu file di folder definisi alur kerja, atau jika file utama diberi nama “main”.
-
-
Dalam Berkas README (opsional) panel, pilih Sumber file README dan berikan informasi berikut:
-
Untuk Impor dari layanan repositori, dalam Jalur file README, masukkan path ke file README dalam repositori.
-
Untuk Pilih file dari S3, dalam Berkas README dalam S3, masukkan URI Amazon S3 untuk file README.
-
Untuk Pilih file dari sumber lokal: dalam README - opsional, memilih Pilih file untuk memilih file markdown (.md) untuk diunggah.
-
-
Dalam Konfigurasi penyimpanan berjalan secara default panel, berikan tipe dan kapasitas penyimpanan run default untuk proses yang menggunakan alur kerja ini:
-
Jalankan jenis penyimpanan: Pilih apakah akan menggunakan penyimpanan statis atau dinamis sebagai default untuk penyimpanan sementara yang dijalankan. Defaultnya adalah penyimpanan statis.
-
Jalankan kapasitas penyimpanan (opsional): Untuk jenis penyimpanan run statis, Anda dapat memasukkan jumlah default penyimpanan run yang diperlukan untuk alur kerja ini. Nilai default untuk parameter ini adalah 1200 GiB. Anda dapat mengganti nilai-nilai default ini saat memulai menjalankan.
-
-
Tag (opsional): Anda dapat mengaitkan hingga 50 tag dengan versi alur kerja ini.
-
Pilih Berikutnya.
-
Pada Tambahkan parameter alur kerja (opsional) halaman, pilih Sumber parameter:
-
Untuk Parse dari file definisi alur kerja, HealthOmics akan secara otomatis mengurai parameter alur kerja dari file definisi alur kerja.
-
Untuk Berikan template parameter dari repositori Git, gunakan path ke file template parameter dari repositori Anda.
-
Untuk Pilih file JSON dari sumber lokal, unggah a JSON file dari sumber lokal yang menentukan parameter.
-
Untuk Masukkan parameter alur kerja secara manual, masukkan nama parameter dan deskripsi secara manual.
-
-
Dalam Pratinjau parameter panel, Anda dapat meninjau atau mengubah parameter untuk versi alur kerja ini. Jika Anda mengembalikan JSON file, Anda kehilangan perubahan lokal yang Anda buat.
-
Pada Pemetaan ulang URI kontainer halaman, di Aturan pemetaan panel, Anda dapat menentukan aturan pemetaan URI untuk alur kerja Anda.
Untuk Sumber file pemetaan, pilih salah satu opsi berikut:
-
Tidak ada — Tidak diperlukan aturan pemetaan.
-
Pilih file JSON dari S3 — Tentukan lokasi S3 untuk file pemetaan.
-
Pilih file JSON dari sumber lokal — Tentukan lokasi file pemetaan di perangkat lokal Anda.
-
Masukkan pemetaan secara manual — masukkan pemetaan registri dan pemetaan gambar di Pemetaan panel.
-
Konsol menampilkan Pemetaan panel. Jika Anda memilih file sumber pemetaan, konsol menampilkan nilai-nilai dari file.
-
Dalam Pemetaan registri, Anda dapat mengedit pemetaan atau menambahkan pemetaan (maksimal 20 pemetaan registri).
Setiap pemetaan registri berisi bidang berikut:
-
URL registri hulu — URI dari registri hulu.
-
Awalan repositori ECR — Awalan repositori untuk digunakan di repositori pribadi Amazon ECR.
-
(Opsional) Awalan repositori hulu — Awalan repositori di registri hulu.
-
(Opsional) ID akun ECR — ID akun akun yang memiliki gambar kontainer hulu.
-
(Opsional) Kredensi ARN — ARN rahasia Manajer Rahasia yang berisi kredenSIAL Anda untuk registri. Diperlukan untuk registri yang tidak didukung oleh Amazon ECR melalui cache, seperti Seqera, NVIDIA NGC, Google Artifact Registry, dan Google Container Registry. Untuk informasi selengkapnya, lihat Menggunakan registri pihak ketiga yang tidak didukung oleh pull through cache.
-
-
Dalam Pemetaan gambar, Anda dapat mengedit pemetaan gambar atau menambahkan pemetaan (maksimal 100 pemetaan gambar).
Setiap pemetaan gambar berisi bidang berikut:
-
Gambar sumber - Menentukan URI gambar sumber di registri hulu.
-
Gambar tujuan — Menentukan URI gambar yang sesuai di registri Amazon ECR pribadi.
-
-
-
Pilih Berikutnya.
-
Tinjau konfigurasi versi, lalu pilih Buat versi.
Saat versi dibuat, konsol kembali ke halaman detail alur kerja dan menampilkan versi baru di Alur kerja dan versi meja.
Membuat versi alur kerja menggunakan CLI
Anda dapat membuat versi alur kerja menggunakan CreateWorkflowVersion Operasi API. Untuk parameter opsional, HealthOmics menggunakan default berikut:
| Parameter | Default |
|---|---|
| Engine | Ditentukan dari definisi alur kerja |
| Tipe penyimpanan | Statis |
| Kapasitas penyimpanan (untuk penyimpanan statis) | 1200 GiB |
| Utama | Ditentukan berdasarkan isi folder definisi alur kerja. Lihat perinciannya di HealthOmics persyaratan definisi alur kerja. |
| Akselerator | none |
| Tanda | none |
Contoh CLI berikut membuat versi alur kerja dengan penyimpanan statis sebagai penyimpanan berjalan default:
aws omics create-workflow-version \ --workflow-id 1234567 \ --version-name "my_version" \ --engine WDL \ --definition-zip fileb://workflow-crambam.zip \ --description "my version description" \ --main file://workflow-params.json \ --parameter-template file://workflow-params.json \ --storage-type='STATIC' \ --storage-capacity 1200 \ --tags example123=string \ --accelerators GPU
Jika file definisi alur kerja Anda terletak di folder Amazon S3, masukkan lokasi menggunakan definition-uri parameter alih-alih definition-zip. Untuk informasi lebih lanjut, lihat CreateWorkflowVersion di AWS HealthOmics Referensi API.
Anda menerima tanggapan berikut untuk create-workflow-version permintaan.
{ "workflowId": "1234567", "versionName": "my_version", "arn": "arn:aws:omics:us-west-2:123456789012:workflow/1234567/version/3", "status": "ACTIVE", "tags": { "environment": "production", "owner": "team-alpha" }, "uuid": "0ac9a563-355c-fc7a-1b47-a115167af8a2" }
Membuat versi alur kerja menggunakan SDK
Anda dapat membuat alur kerja menggunakan salah satu SDK.
Contoh berikut menunjukkan cara membuat versi alur kerja menggunakan Python SDK
import boto3 omics = boto3.client('omics') with open('definition.zip', 'rb') as f: definition = f.read() response = omics.create_workflow_version( workflowId='1234567', versionName='my_version', requestId='my_request_1' definitionZip=definition, parameterTemplate={ ... } )
Memverifikasi status versi alur kerja
Setelah membuat versi alur kerja, Anda dapat memverifikasi status dan melihat detail alur kerja lainnya menggunakan dapatkan versi alur kerja, seperti yang ditunjukkan.
aws omics get-workflow-version --workflow-id 9876543 --version-name "my_version"
Respons memberi Anda detail alur kerja Anda, termasuk status, seperti yang ditunjukkan.
{ "workflowId": "1234567", "versionName": "3.0.0", "arn": "arn:aws:omics:us-west-2:123456789012:workflow/1234567/version/3.0.0", "status": "ACTIVE", "description": ... "uuid": "0ac9a563-355c-fc7a-1b47-a115167af8a2" }
Sebelum Anda dapat memulai menjalankan dengan versi alur kerja ini, status harus beralih ke ACTIVE.