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

Gunakan IPv6 dengan Kinesis Video Streams

Anda dapat mengonfigurasi Kinesis Video Streams untuk menggunakan IPv6 untuk operasi bidang kontrol dan bidang data. Ini memungkinkan aplikasi Anda untuk berkomunikasi dengan layanan Kinesis Video Streams menggunakan alamat IPv6 melalui titik akhir dual-stack.

Kinesis Video Streams mendukung IPv6 melalui titik akhir dual-stack untuk aplikasi produsen dan konsumen. Anda dapat mengonfigurasi aplikasi Anda untuk menggunakan IPv6 untuk panggilan API bidang kontrol dan operasi streaming pesawat data.

Konfigurasikan AWS SDK untuk IPv6

Jika Anda menggunakan AWS SDK untuk memanggil API bidang kontrol Kinesis Video Streams dalam penyiapan produksi, Anda dapat mengaktifkan IPv6 dengan mengonfigurasi titik akhir dual-stack. AWS SDK menyediakan beberapa metode standar untuk mengaktifkan titik akhir dual-stack.

Menggunakan variabel lingkungan

Tetapkan variabel lingkungan berikut untuk mengaktifkan titik akhir dual-stack IPv6:

export AWS_USE_DUALSTACK_ENDPOINT=true

Gunakan AWS berkas konfigurasi

Tambahkan pengaturan berikut ke file AWS konfigurasi Anda (~/.aws/config):

[default]
use_dualstack_endpoint = true

Gunakan properti sistem JVM (hanya SDK Java dan Kotlin)

Untuk aplikasi Java dan Kotlin, atur properti sistem JVM berikut:

-Daws.useDualstackEndpoint=true

Atau secara terprogram dalam kode Java Anda:

System.setProperty("aws.useDualstackEndpoint", "true");

Dukungan SDK

AWS SDK berikut mendukung konfigurasi titik akhir dual-stack:

Setelah mengonfigurasi titik akhir dual-stack, AWS SDK secara otomatis menggunakan titik akhir IPv6 saat memanggil API bidang kontrol Kinesis Video Streams.

Konfigurasikan SDK Produser Kinesis Video Streams untuk IPv6

Kinesis Video Streams Producer SDK menyediakan opsi konfigurasi IPv6 untuk operasi bidang kontrol dan bidang data. Pengaturan ini berfungsi dengan konfigurasi titik akhir tumpukan ganda AWS SDK.

Konfigurasikan C/C ++ Producer SDK

Titik akhir default dan rantai resolusi DNS diimplementasikan oleh KVS Producer-C SDK versi 1.6.0. Ini secara berurutan memeriksa setiap tempat di mana Anda dapat mengatur konfigurasi untuk parameter ini, dan kemudian memilih yang pertama Anda atur. Urutan yang telah ditentukan adalah sebagai berikut:

Untuk informasi selengkapnya tentang Producer SDK, lihat topik terkait Producer SDK for C, Producer SDK for C++, dan Producer SDK.

Konfigurasi Endpoint

Dengan 2, 3, dan 4, titik akhir akan dibangun berdasarkan wilayah yang disediakan. createAbstractDefaultCallbacksProvider

Penyaringan DNS

KVS Producer SDK akan mengatur CURLOPT_IPRESOLVE parameter yang sesuai tergantung pada konfigurasi:

C++ Producer SDK versi 3.5.0 menggunakan Producer-C SDK 1.6.0 untuk panggilan KVS API.

Konfigurasikan plugin GStreamer

Plugin GStreamer menggunakan C Producer SDK yang mendasarinya, sehingga konfigurasi IPv6 ditangani secara otomatis saat Anda mengonfigurasi C SDK untuk IPv6 seperti yang dijelaskan sebelumnya.

Memodifikasi kode tidak diperlukan, cukup buat SDK dengan parameter CMake atau atur variabel lingkungan yang sesuai seperti yang dijelaskan di bagian sebelumnya.

Resolusi titik akhir bidang data

Untuk operasi bidang data, gunakan GetDataEndpoint API untuk mengambil titik akhir bidang data tumpukan ganda yang sesuai. Layanan mengembalikan titik akhir yang sesuai tergantung pada URL permintaan.

Contoh:

Konfigurasikan AWS CLI untuk IPv6

Jika Anda menggunakan operasi AWS CLI untuk Kinesis Video Streams (biasanya untuk pekerjaan bukti konsep), Anda dapat mengaktifkan IPv6 dengan mengonfigurasi titik akhir dual-stack.

Gunakan variabel lingkungan

export AWS_USE_DUALSTACK_ENDPOINT=true

Gunakan AWS berkas konfigurasi

Tambahkan yang berikut ini ke file AWS CLI konfigurasi Anda (~/.aws/config):

[default]
use_dualstack_endpoint = true

Contoh konfigurasi

Contoh C SDK

Untuk membangun Producer-C SDK KVS dalam IPV6-only mode dan mengabaikan konfigurasi variabel lingkungan, gunakan perintah berikut untuk membangun SDK:

cmake .. -DAWS_KVS_USE_DUAL_STACK_ENDPOINT_ONLY=TRUE -DAWS_KVS_IPV6_ONLY=TRUE
make -j

Pertimbangan-pertimbangan

Persyaratan jaringan

Kompatibilitas SDK

Pengujian dan validasi

Sebelum Anda menerapkan aplikasi IPv6-enabled Kinesis Video Streams ke produksi:

Pelanggan yang terkena dampak peningkatan untuk menyertakan IPv6

Saat Anda mengaktifkan IPv6 untuk Kinesis Video Streams, ada beberapa area di mana Anda mungkin perlu memperbarui konfigurasi dan kebijakan yang ada untuk memastikan fungsionalitas lanjutan.

Kebijakan IAM dan pemfilteran alamat IP

Jika Anda menggunakan pemfilteran alamat IP sumber dalam kebijakan pengguna IAM, kebijakan peran, atau kebijakan berbasis sumber daya, Anda perlu memperbarui kebijakan ini untuk menyertakan rentang alamat IPv6.

Contoh pembaruan kebijakan IAM untuk IPv6:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": "*",
      "Action": "kinesisvideo:*",
      "Resource": "*",
      "Condition": {
        "IpAddress": {
          "aws:SourceIp": [
            "192.0.2.0/24",
            "203.0.113.0/24",
            "2001:db8::/32"
          ]
        }
      }
    }
  ]
}

Pencatatan log dan pemantauan

Alamat IPv6 memiliki format yang berbeda dari alamat IPv4, yang dapat memengaruhi sistem pencatatan, pemantauan, dan analitik Anda.

log

log akan berisi alamat IPv6 di sourceIPAddress bidang saat permintaan dibuat melalui IPv6. Perbarui alat dan skrip penguraian log Anda untuk menangani format alamat IPv6.

Contoh alamat IPv6 di log:

{
  "sourceIPAddress": "2001:db8::1",
  "eventName": "CreateStream",
  "eventSource": "kinesisvideo.amazonaws.com"
}

Pemecahan masalah

Masalah umum

Langkah-langkah verifikasi

Validasi konfigurasi

Anda dapat memverifikasi konfigurasi titik akhir dual-stack Anda dengan memeriksa: