Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden Sie IPv6 mit Kinesis Video Streams

Sie können Kinesis Video Streams so konfigurieren, dass IPv6 sowohl für Operationen auf der Steuerungsebene als auch auf der Datenebene verwendet wird. Dadurch können Ihre Anwendungen mithilfe von IPv6-Adressen über Dual-Stack-Endpunkte mit Kinesis Video Streams Streams-Diensten kommunizieren.

Kinesis Video Streams unterstützt IPv6 über Dual-Stack-Endpunkte sowohl für Hersteller- als auch für Verbraucheranwendungen. Sie können Ihre Anwendungen so konfigurieren, dass sie IPv6 für API-Aufrufe auf Steuerungsebene und Streaming-Operationen auf Datenebene verwenden.

Konfigurieren Sie die AWS SDK für IPv6

Wenn Sie das AWS SDK verwenden, um Kinesis Video Streams Streams-APIs auf der Steuerungsebene in Ihrem Produktions-Setup aufzurufen, können Sie IPv6 aktivieren, indem Sie Dual-Stack-Endpunkte konfigurieren. Das AWS SDK bietet mehrere standardisierte Methoden zur Aktivierung von Dual-Stack-Endpunkten.

Verwenden Sie Umgebungsvariablen

Legen Sie die folgende Umgebungsvariable fest, um IPv6-Dual-Stack-Endpunkte zu aktivieren:

export AWS_USE_DUALSTACK_ENDPOINT=true

Verwenden Sie die AWS Konfigurationsdatei

Fügen Sie Ihrer AWS Konfigurationsdatei (~/.aws/config) die folgende Einstellung hinzu:

[default]
use_dualstack_endpoint = true

Verwenden Sie JVM-Systemeigenschaften (nur Java- und Kotlin-SDKs)

Legen Sie für Java- und Kotlin-Anwendungen die folgende JVM-Systemeigenschaft fest:

-Daws.useDualstackEndpoint=true

Oder programmgesteuert in Ihrem Java-Code:

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

SDK-Unterstützung

Die folgenden AWS SDKs unterstützen die Dual-Stack-Endpunktkonfiguration:

Nachdem Sie Dual-Stack-Endpunkte konfiguriert haben, verwendet das AWS SDK automatisch IPv6-Endpunkte, wenn es die APIs der Kinesis Video Streams Streams-Kontrollebene aufruft.

Das Kinesis Video Streams Producer SDK für IPv6 konfigurieren

Das Kinesis Video Streams Producer SDK bietet IPv6-Konfigurationsoptionen sowohl für den Betrieb auf der Steuerungsebene als auch auf der Datenebene. Diese Einstellungen funktionieren mit der AWS SDK-Dual-Stack-Endpunktkonfiguration.

Konfigurieren Sie das C/C ++ Producer SDK

Die Standard-Endpunkte und die DNS-Auflösungskette werden in der KVS Producer-C SDK-Version 1.6.0 implementiert. Es überprüft nacheinander jeden Ort, an dem Sie die Konfiguration für diese Parameter festlegen können, und wählt dann den ersten aus, den Sie festlegen. Die vordefinierte Reihenfolge lautet wie folgt:

Weitere Informationen zu den Producer-SDKs finden Sie unter Producer-SDK für C, Producer-SDK SDK for C++ und verwandten Themen zum Producer-SDK.

Endpunktkonfiguration

Bei den Werten 2, 3 und 4 wird der Endpunkt auf der Grundlage der bereitgestellten Region erstelltcreateAbstractDefaultCallbacksProvider.

DNS-Filterung

Das KVS Producer SDK legt je nach Konfiguration den entsprechenden CURLOPT_IPRESOLVE Parameter fest:

Das C++ Producer SDK Version 3.5.0 verwendet das Producer-C SDK 1.6.0 für die KVS-API-Aufrufe.

Konfigurieren Sie das GStreamer-Plugin

Das GStreamer-Plugin verwendet das zugrunde liegende C Producer SDK, sodass die IPv6-Konfiguration automatisch durchgeführt wird, wenn Sie das C-SDK für IPv6 wie zuvor beschrieben konfigurieren.

Eine Änderung des Codes ist nicht erforderlich. Erstellen Sie einfach das SDK mit den CMake-Parametern oder legen Sie die entsprechenden Umgebungsvariablen fest, wie im vorherigen Abschnitt beschrieben.

Auflösung der Endpunkte auf der Datenebene

Verwenden Sie für Datenebenenoperationen die GetDataEndpoint API, um den entsprechenden Dual-Stack-Datenebenen-Endpunkt abzurufen. Der Dienst gibt je nach Anforderungs-URL den entsprechenden Endpunkt zurück.

Beispiel:

Konfigurieren Sie das AWS CLI für IPv6

Wenn Sie den Betrieb AWS CLI für Kinesis Video Streams verwenden (in der Regel für Machbarkeitsstudien), können Sie IPv6 aktivieren, indem Sie Dual-Stack-Endpunkte konfigurieren.

Verwenden Sie eine Umgebungsvariable

export AWS_USE_DUALSTACK_ENDPOINT=true

Verwenden Sie die AWS Konfigurationsdatei

Fügen Sie Ihrer AWS CLI Konfigurationsdatei (~/.aws/config) Folgendes hinzu:

[default]
use_dualstack_endpoint = true

Beispiele für Konfigurationen

Beispiel für ein C SDK

Um das KVS Producer-C SDK im IPV6-only Modus zu erstellen und die Konfiguration der Umgebungsvariablen zu ignorieren, verwenden Sie die folgenden Befehle, um das SDK zu erstellen:

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

Überlegungen

Netzwerkanforderungen

SDK-Kompatibilität

Testen und Validieren

Bevor Sie IPv6-enabled Kinesis Video Streams Streams-Anwendungen für die Produktion bereitstellen:

Kunden, die von der Aktualisierung auf IPv6 betroffen sind

Wenn Sie IPv6 für Kinesis Video Streams aktivieren, gibt es mehrere Bereiche, in denen Sie möglicherweise Ihre vorhandenen Konfigurationen und Richtlinien aktualisieren müssen, um die kontinuierliche Funktionalität sicherzustellen.

IAM-Richtlinien und IP-Adressfilterung

Wenn Sie die Quell-IP-Adressfilterung in Ihren IAM-Benutzerrichtlinien, Rollenrichtlinien oder ressourcenbasierten Richtlinien verwenden, müssen Sie diese Richtlinien aktualisieren, um IPv6-Adressbereiche einzubeziehen.

Beispiel für ein IAM-Richtlinienupdate für 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"
          ]
        }
      }
    }
  ]
}

Protokollierung und Überwachung

IPv6-Adressen haben ein anderes Format als IPv4-Adressen, was sich auf Ihre Protokollierungs-, Überwachungs- und Analysesysteme auswirken kann.

Protokolle

Protokolle enthalten IPv6-Adressen im sourceIPAddress Feld, wenn Anfragen über IPv6 gestellt werden. Aktualisieren Sie Ihre Tools und Skripts zum Analysieren von Protokollen, sodass sie mit IPv6-Adressformaten umgehen können.

Beispiel für eine IPv6-Adresse in Protokollen:

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

Fehlerbehebung

Häufige Probleme

Schritte zur Überprüfung

Überprüfung der Konfiguration

Sie können Ihre Dual-Stack-Endpunktkonfiguration überprüfen, indem Sie Folgendes überprüfen: