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

Menghubungkan HealthOmics alur kerja ke VPC

Dengan Amazon Virtual Private Cloud (Amazon VPC), Anda dapat meluncurkan AWS sumber daya di jaringan virtual pribadi yang telah Anda tentukan. Anda dapat memberikan HealthOmics alur kerja Anda akses ke sumber daya di VPC Anda dengan mengonfigurasi proses Anda untuk menggunakan mode jaringan VPC. Ketika jaringan VPC diaktifkan, proses Anda dapat mengakses sumber daya dalam VPC Anda dan terhubung ke sumber daya eksternal melalui internet publik jika VPC Anda memiliki akses internet yang dikonfigurasi.

Kapan menggunakan jaringan VPC

Gunakan jaringan VPC saat proses Anda perlu:

Mode jaringan

HealthOmics Alur kerja mendukung dua mode jaringan. Secara default, alur kerja berjalan beroperasi dalam mode TERBATAS. Anda dapat mengaktifkan jaringan VPC secara per-run saat memulai alur kerja.

Anda menentukan mode jaringan saat memulai alur kerja yang dijalankan menggunakan networkingMode parameter di StartRun API.

Memulai

Bagian ini memandu Anda melalui pengaturan jaringan VPC untuk HealthOmics Alur Kerja untuk pertama kalinya.

Prasyarat

Sebelum mengonfigurasi jaringan VPC HealthOmics untuk Alur Kerja, pastikan Anda memiliki yang berikut:

Langkah 1: Buat atau konfigurasikan VPC Anda

Buat VPC dengan subnet pribadi, grup keamanan, dan gateway NAT (jika akses internet diperlukan). Untuk step-by-step instruksi terperinci, lihatAkses internet untuk alur kerja yang terhubung dengan VPC.

Langkah 2: Konfigurasikan grup keamanan

Buat grup keamanan yang memungkinkan lalu lintas keluar ke tujuan yang perlu Anda akses. Konfigurasikan grup keamanan untuk mengizinkan hanya lalu lintas keluar minimum yang diperlukan mengikuti prinsip hak istimewa paling sedikit.

Misalnya konfigurasi dan panduan terperinci, lihat bagian grup keamanan diAkses internet untuk alur kerja yang terhubung dengan VPC.

Langkah 3: Verifikasi tabel rute

Pastikan subnet pribadi Anda memiliki rute ke NAT Gateway untuk akses internet. Misalnya konfigurasi tabel rute, lihat bagian tabel rute diAkses internet untuk alur kerja yang terhubung dengan VPC.

Langkah 4: Buat sumber daya konfigurasi

Buat sumber daya HealthOmics Konfigurasi yang menentukan pengaturan jaringan VPC Anda:

aws omics create-configuration \
  --name my-vpc-config \
  --description "VPC configuration for genomics workflows" \
  --run-configurations '{
    "vpcConfig": {
      "securityGroupIds": ["sg-0123456789abcdef0"],
      "subnetIds": [
        "subnet-0a1b2c3d4e5f6g7h8",
        "subnet-1a2b3c4d5e6f7g8h9"
      ]
    }
  }' \
  --region us-west-2

Konfigurasi akan bertransisi dari CREATING ke ACTIVE status setelah sumber daya jaringan disediakan. Ini membutuhkan waktu hingga 15 menit.

Langkah 5: Mulai menjalankan alur kerja dengan jaringan VPC

Setelah konfigurasi AndaACTIVE, mulai menjalankan alur kerja dengan jaringan VPC diaktifkan:

aws omics start-run \
  --workflow-id 1234567 \
  --role-arn arn:aws:iam::123456789012:role/OmicsWorkflowRole \
  --output-uri s3://my-bucket/outputs/ \
  --networking-mode VPC \
  --configuration-name my-vpc-config \
  --region us-west-2

Langkah 6: Verifikasi konektivitas

Pantau alur kerja Anda untuk memverifikasi bahwa alur kerja dapat mengakses sumber daya eksternal yang diperlukan. Periksa log alur kerja di CloudWatch Log untuk pesan keberhasilan atau kegagalan koneksi. Untuk panduan terperinci tentang pengujian konektivitas, lihatMenguji konektivitas VPC.

Persyaratan VPC

VPC Anda harus memenuhi persyaratan berikut:

Persyaratan subnet

Persyaratan grup keamanan

Grup keamanan mengontrol lalu lintas masuk dan keluar untuk perjalanan Anda.

Persyaratan antarmuka jaringan

HealthOmics menyediakan antarmuka jaringan elastis (ENIs) di VPC Anda untuk menghubungkan berjalan ke jaringan Anda. Pastikan AWS akun Anda memiliki kapasitas ENI yang memadai (batas default: 5.000 ENIs per Wilayah).

ENIs dibuat oleh HealthOmics ditandai dengan tag berikut:

"TagSet": [
  {
    "Key": "Service",
    "Value": "HealthOmics"
  },
  {
    "Key": "eniType",
    "Value": "CUSTOMER"
  }
]

Konfigurasi APIs

HealthOmics menyediakan APIs untuk membuat, mengelola, dan menghapus konfigurasi VPC. Anda dapat menggunakan kembali konfigurasi di beberapa alur kerja.

CreateConfiguration

Membuat sumber daya konfigurasi baru dengan pengaturan jaringan VPC. Sebagai step-by-step contoh, lihatLangkah 4: Buat sumber daya konfigurasi.

Permintaan sintaks:

aws omics create-configuration \
  --name configuration-name \
  --description description \
  --run-configurations '{"vpcConfig":{"securityGroupIds":["security-group-id"],"subnetIds":["subnet-id"]}}' \
  --tags Key=key,Value=value \
  --region region

Parameter:

Tanggapan:

{
  "arn": "arn:aws:omics:region:account-id:configuration/configuration-name",
  "uuid": "configuration-uuid",
  "name": "configuration-name",
  "runConfigurations": {
    "vpcConfig": {
      "securityGroupIds": ["security-group-id"],
      "subnetIds": ["subnet-id"],
      "vpcId": "vpc-id"
    }
  },
  "status": "CREATING",
  "creationTime": "timestamp",
  "tags": {}
}

Nilai status konfigurasi:

GetConfiguration

Mengambil detail konfigurasi tertentu.

Permintaan sintaks:

aws omics get-configuration \
  --name configuration-name \
  --region region

Tanggapan:

{
  "arn": "arn:aws:omics:region:account-id:configuration/configuration-name",
  "uuid": "configuration-uuid",
  "name": "configuration-name",
  "runConfigurations": {
    "vpcConfig": {
      "securityGroupIds": ["security-group-id"],
      "subnetIds": ["subnet-id"],
      "vpcId": "vpc-id"
    }
  },
  "status": "ACTIVE",
  "creationTime": "timestamp",
  "tags": {}
}

ListConfigurations

Daftar semua konfigurasi di akun Anda.

Permintaan sintaks:

aws omics list-configurations \
  --region region

Tanggapan:

{
  "items": [
    {
      "arn": "arn:aws:omics:region:account-id:configuration/configuration-name",
      "name": "configuration-name",
      "description": "description",
      "status": "ACTIVE",
      "creationTime": "timestamp"
    }
  ]
}

DeleteConfiguration

Menghapus konfigurasi. Anda tidak dapat menghapus konfigurasi yang saat ini digunakan oleh alur kerja aktif berjalan.

Permintaan sintaks:

aws omics delete-configuration \
  --name configuration-name \
  --region region

Menjalankan alur kerja dengan jaringan VPC

Memulai lari dengan jaringan VPC

Untuk menggunakan jaringan VPC dalam menjalankan alur kerja, tentukan networking-mode parameter dan: configuration-name

aws omics start-run \
  --workflow-id 1234567 \
  --role-arn arn:aws:iam::123456789012:role/OmicsWorkflowRole \
  --output-uri s3://my-bucket/outputs/ \
  --networking-mode VPC \
  --configuration-name my-vpc-config \
  --region us-west-2

Parameter:

Melihat konfigurasi jaringan run

Gunakan GetRun untuk melihat konfigurasi jaringan untuk menjalankan:

aws omics get-run \
  --id run-id \
  --region region

Responsnya mencakup mode jaringan, detail konfigurasi, dan konfigurasi VPC. Contoh berikut menunjukkan bidang terkait VPC dari respons:

{
  "arn": "arn:aws:omics:region:account-id:run/run-id",
  "id": "run-id",
  "status": "status",
  "workflowId": "workflow-id",
  "networkingMode": "VPC",
  "configuration": {
    "name": "configuration-name",
    "arn": "arn:aws:omics:region:account-id:configuration/configuration-name",
    "uuid": "configuration-uuid"
  },
  "vpcConfig": {
    "subnets": ["subnet-id-1", "subnet-id-2"],
    "securityGroupIds": ["security-group-id"],
    "vpcId": "vpc-id"
  }
}

Konfigurasi kekekalan

Alur kerja menggunakan snapshot konfigurasi seperti yang ada saat proses dimulai. Anda dapat dengan aman memodifikasi atau menghapus konfigurasi selama eksekusi run tanpa mempengaruhi proses aktif.

Panggil pertimbangan caching

Saat menggunakan jaringan VPC dengan caching panggilan, pastikan mesin alur kerja Anda dikonfigurasi dengan tepat. Untuk panduan terperinci tentang caching panggilan per mesin, lihatFitur caching khusus mesin.

Praktik terbaik

Keamanan

Performa

Optimalisasi biaya

Operasional

Kuota jaringan VPC

Tabel berikut mencantumkan kuota untuk konfigurasi jaringan VPC:

Untuk meminta peningkatan kuota, buka konsol Service Quotas, pilih layanan, AWS HealthOmicscari, AWS pilih kuota yang ingin Anda tambah, dan pilih Permintaan kenaikan kuota. Permintaan kenaikan kuota biasanya diproses dalam 1-2 hari kerja.