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.

Verwendung IPv6 mit Kinesis Video Streams

Sie können Kinesis Video Streams so konfigurieren, dass es sowohl IPv6 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 verwendet werden.

Konfigurieren Sie das AWS SDK für IPv6

Wenn Sie das AWS SDK verwenden, um die Kinesis Video Streams Streams-Steuerebene APIs in Ihrem Produktions-Setup aufzurufen, können Sie dies aktivieren, IPv6 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 Konfigurationsdatei AWS

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

Folgendes AWS SDKs unterstützt die Dual-Stack-Endpunktkonfiguration:

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

Konfigurieren Sie das Kinesis Video Streams Producer SDK für IPv6

Das Kinesis Video Streams Producer SDK bietet IPv6 Konfigurationsoptionen für den Betrieb auf der Steuerungsebene und 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 durch das 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 zum Producer finden Sie unter SDKs 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.

GStreamer Konfigurieren Sie das Plugin

Das GStreamer Plugin verwendet das zugrunde liegende C Producer SDK, sodass die IPv6 Konfiguration automatisch erfolgt, 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 für AWS CLI IPv6

Wenn Sie den Betrieb AWS CLI für Kinesis Video Streams verwenden (normalerweise proof-of-concept beruflich), können Sie ihn aktivieren, IPv6 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 nur im Modus IPV6 -only 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 Kinesis Video Streams IPv6 Streams-fähige Anwendungen für die Produktion bereitstellen:

Zu den Kunden, die vom Upgrade betroffen sind, gehören IPv6

Wenn Sie Kinesis Video Streams aktivieren IPv6 , 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 Adressbereiche einzubeziehen. IPv6

Beispiel für ein Update der IAM-Richtlinie 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 gestellt werden IPv6. Aktualisieren Sie Ihre Tools und Skripts zum Analysieren von Protokollen, sodass sie mit IPv6 Adressformaten umgehen können.

IPv6 Beispieladresse 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: